DateTime

JSON-Darstellung
{
  "date": string
}
Felder
date

string

Datum/Uhrzeit im erweiterten ISO 8601-Format. Unter Umständen ist ein Offset erforderlich (siehe Dokumentation im übergeordneten Feld). Die Zeit kann bis auf die Nanosekunde genau angegeben werden. Offsets können sekundengenau angegeben werden (obwohl Offset-Sekunden nicht Teil von ISO 8601 sind).

Beispiel:

1985-04-12T23:20:50.52Z entspricht 20 Minuten und 50, 52 Sekunden nach der 23. Stunde am 12. April 1985 in UTC.

1985-04-12T19:20:50.52-04:00 entspricht 20 Minuten und 50, 52 Sekunden nach der 19. Stunde am 12. April 1985, 4 Stunden vor UTC (gleicher Zeitpunkt wie im obigen Beispiel). Falls Datum und Uhrzeit für einen physischen Standort in New York angegeben werden sollen, entspricht dies der Eastern Daylight Time (EDT). Der Offset variiert je nach Jahreszeit in Regionen, in denen die Sommerzeit gilt.

1985-04-12T19:20:50.52 entspricht 20 Minuten und 50, 52 Sekunden nach der 19. Stunde am 12. April 1985 ohne Versatzinformationen.

Durch die Angabe eines Offsets wird dies zu einer absoluten, überall auf der Welt gültigen Zeitangabe. Datum und Uhrzeit werden an die Zeitzone des Nutzers angepasst. So entspräche die Uhrzeit 2018-06-19T18:30:00-04:00 beispielsweise 18:30:00 Uhr für einen Nutzer in New York und 15:30:00 Uhr für einen Nutzer in Los Angeles.

Ohne den Offset wird daraus eine lokale Datums- und Zeitangabe, die verschiedene Zeitpunkte weltweit darstellt. Datum und Uhrzeit werden immer in der aktuellen Zeitzone des Nutzers angegeben. Beispiel: Die Uhrzeit 2018-06-19T18:30:00 ist 18:30:00 Uhr für einen Nutzer in New York und ebenso 18:30:00 Uhr für einen Nutzer in Los Angeles. Dies ist nützlich, wenn dasselbe lokale Datum und dieselbe lokale Uhrzeit für viele physische Standorte in mehreren Zeitzonen gelten sollen.