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, auch wenn Offset-Sekunden nicht in ISO 8601 enthalten 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 Beispiel oben). Wenn Datum und Uhrzeit für einen physischen Standort in New York angegeben werden sollen, ist dies die Entsprechung in Eastern Daylight Time (EDT). Der Offset variiert je nach Jahreszeit in Regionen, in denen Sommerzeit gilt.

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

Durch die Angabe eines Offsets wird dies zu einem absoluten Zeitpunkt auf der ganzen Welt. Datum und Uhrzeit werden an die Zeitzone des Nutzers angepasst. Beispiel: Die Uhrzeit 2018-06-19T18:30:00-04:00 ist 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-/Uhrzeitangabe, die für mehrere Zeitpunkte auf der ganzen Welt steht. 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 ebenfalls 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 verschiedenen Zeitzonen gelten sollen.