DateTime

JSON 表現
{
  "date": string
}
フィールド
date

string

ISO 8601 拡張形式の日付/時刻。オフセットは必須の場合とそうでない場合があります(親フィールドのドキュメントをご覧ください)。時刻はナノ秒の精度まで指定できます。オフセットは秒の精度で指定できます(オフセット秒は ISO 8601 には含まれていません)。

次に例を示します。

1985-04-12T23:20:50.52Z は、UTC の 1985 年 4 月 12 日の 23 時 20 分 50.52 秒です。

1985-04-12T19:20:50.52-04:00 は、1985 年 4 月 12 日の 19 時 20 分 50.52 秒(UTC の 4 時間前)です(上記の例と同じ時刻です)。ニューヨークの物理的な場所の日付/時刻である場合、これは東部夏時間(EDT)に相当します。夏時間が適用されるリージョンでは、時期によってオフセットが変わることに留意してください。

1985-04-12T19:20:50.52 は、1985 年 4 月 12 日の 19 時 20 分 50.52 秒で、オフセット情報はありません。

オフセットを指定することで、これが世界中で絶対的な時刻になります。日付/時刻はユーザーのタイムゾーンに基づいて調整されます。たとえば、2018-06-19T18:30:00-04:00 という時刻は、ニューヨークのユーザーは 18:30:00、ロサンゼルスのユーザーは 15:30:00 になります。

オフセットを省略すると、これはローカルの日付/時刻になり、世界中の複数の時刻を表します。日付/時刻は常にユーザーの現在のタイムゾーンで示されます。たとえば、2018-06-19T18:30:00 という時刻は、ニューヨークのユーザーの場合は 18:30:00、ロサンゼルスのユーザーの場合は 18:30:00 になります。これは、複数のタイムゾーンの多くの物理的な場所に同じローカル日時を適用する場合に便利です。