POST AI agent ready /v1/timezone

Zeitzonen-API – Kostenlose aktuelle Zeitsuche

Gibt die aktuelle Uhrzeit, den UTC-Offset, die Abkürzung und den DST-Status für eine bestimmte IANA-Zeitzone zurück. Der Standardwert ist UTC, wenn keine Zeitzone angegeben ist.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/timezone \
  -H "Content-Type: application/json" \
  -d '{"timezone":"America/New_York"}'

When to use this API

Lokalisierte Uhren in einem Dashboard anzeigen

Erstellen Sie ein Uhr-Widget mit mehreren Zeitzonen für ein Team-Dashboard. Rufen Sie diesen Endpunkt für die Zeitzone jedes Teammitglieds auf (z. B. Amerika/New_York, Europa/Berlin, Asien/Tokio) und geben Sie neben dem Namen die aktuelle Ortszeit an.

Planen Sie Benachrichtigungen zu den örtlichen Geschäftszeiten

Überprüfen Sie vor dem Senden einer Push-Benachrichtigung oder E-Mail die Zeitzone des Empfängers, um sicherzustellen, dass es sich um eine Zeit zwischen 9 und 18 Uhr Ortszeit handelt. Verzögern Sie die Lieferung bis zum nächsten Geschäftsfenster, um die Öffnungsraten zu verbessern und Unterbrechungen außerhalb der Geschäftszeiten zu vermeiden.

Frequently asked questions

Welches Zeitzonenformat akzeptiert dieser Endpunkt?

Es akzeptiert IANA-Zeitzonenkennungen wie Amerika/New_York, Europa/London oder Asien/Tokio. Die vollständige Liste finden Sie unter iana.org/time-zones.

Berücksichtigt die Antwort die Sommerzeit?

Ja. Das Feld is_dst gibt an, ob die Sommerzeit aktiv ist, und das Feld utc_offset spiegelt den aktuellen Offset einschließlich etwaiger Sommerzeitanpassungen wider.

Was passiert, wenn ich eine ungültige Zeitzone übergebe?

Der Endpunkt gibt einen 400-Fehler mit der Meldung zurück, dass die Zeitzonenkennung nicht erkannt wird.

Kann ich damit die aktuelle UTC-Zeit abrufen?

Ja. Lassen Sie entweder den Zeitzonenparameter weg (standardmäßig UTC) oder übergeben Sie explizit „UTC“, um die aktuelle koordinierte Weltzeit zu erhalten.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.