Wie funktionieren Datums- und Zeitfelder in der API?

Die API gibt Datums- und Zeitangaben in zwei Formaten zurück, nebeneinander in derselben Antwort:

Das reguläre Format lautet YYYY-MM-DD HH:MM:SS, zum Beispiel 2026-05-18 14:30:00. Hier ist keine Zeitzone angegeben. Es handelt sich um das Datum und die Uhrzeit in der Zeitzone des Kontos. Diese Zeitzone steht im Feld timezone desselben Objekts.
Das ISO-Format enthält den Offset für die Zeitzone, zum Beispiel 2026-05-18T14:30:00+02:00. Sie erkennen diese Felder an dem Zusatz _iso.

{
  "timezone": "Europe/Amsterdam",
  "modified": "2026-05-18 14:30:00",
  "modified_iso": "2026-05-18T14:30:00+02:00"
}

Wenn Sie mit Benutzern oder Systemen in verschiedenen Zeitzonen arbeiten, verwenden Sie die _iso-Variante. So ist immer eindeutig, um welche Zeitzone es sich handelt.

Leere Datumsfelder auslesen

Ist der reguläre Wert leer, kann die _iso-Variante in der Antwort komplett fehlen. Bei einem Feld, das nie geändert wurde, erhalten Sie zum Beispiel zwar "modified": null, aber kein modified_iso. Gehen Sie also nicht davon aus, dass dieses Feld immer in der Antwort enthalten ist.

Andere Objekte geben in derselben Situation durchaus "modified_iso": null zurück. Prüfen Sie beim Auslesen daher immer zuerst, ob das Feld in der Antwort vorhanden ist.

Selbst ein Datum mitsenden

Akzeptiert ein Endpoint ein Datum, dürfen Sie beide Formate verwenden. Wenn Sie ein ISO-Datum in einem Query-String mitsenden, ersetzen Sie das Pluszeichen durch %2B:

event_date_from=2026-05-18T14:30:00%2B02:00

Leere Datumsfelder auslesen

Selbst ein Datum mitsenden

Verwandte Artikel