Aller au contenu
POST AI agent ready /v1/timezone

API de fuseau horaire - Recherche gratuite de l'heure actuelle

Renvoie l'heure actuelle, le décalage UTC, l'abréviation et l'état DST pour un fuseau horaire IANA donné. La valeur par défaut est UTC si aucun fuseau horaire n'est spécifié.

Parameters

stringrequired

IANA timezone name (e.g. America/New_York, Europe/London).

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

Afficher des horloges localisées dans un tableau de bord

Créez un widget d'horloge multifuseau horaire pour un tableau de bord d'équipe. Appelez ce point de terminaison pour le fuseau horaire de chaque membre de l'équipe (par exemple Amérique/New_York, Europe/Berlin, Asie/Tokyo) et affichez l'heure locale actuelle à côté de leur nom.

Planifiez des notifications aux heures de bureau locales

Avant d'envoyer une notification push ou un e-mail, vérifiez le fuseau horaire du destinataire pour confirmer qu'il se situe entre 9h et 18h, heure locale. Retardez la livraison jusqu'à la prochaine fenêtre commerciale pour améliorer les taux d'ouverture et éviter les interruptions en dehors des heures d'ouverture.

Frequently asked questions

Quel format de fuseau horaire ce point de terminaison accepte-t-il ?
Il accepte les identifiants de fuseau horaire IANA comme America/New_York, Europe/Londres ou Asia/Tokyo. La liste complète est conservée sur iana.org/time-zones.
La réponse tient-elle compte de l’heure d’été ?
Oui. Le champ is_dst indique si l'heure d'été est active et utc_offset reflète le décalage actuel, y compris tout ajustement de l'heure d'été.
Que se passe-t-il si je dépasse un fuseau horaire invalide ?
Le point de terminaison renvoie une erreur 400 avec un message expliquant que l'identifiant de fuseau horaire n'est pas reconnu.
Puis-je l'utiliser pour obtenir l'heure UTC actuelle ?
Oui. Soit omettez le paramètre de fuseau horaire (par défaut : UTC), soit transmettez explicitement « UTC » pour obtenir le temps universel coordonné actuel.

Get your API key

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