Passer au contenu principal

​
Format de date et gestion des fuseaux horaires

Toutes les dates dans l’API Hyperline sont gérées en UTC (Temps universel coordonné). Lorsque vous envoyez des dates à l’API, vous devez convertir vos dates locales en UTC. De même, toutes les dates renvoyées par l’API sont au format UTC.

​
Travailler avec les fuseaux horaires des clients

Lorsque vous créez des abonnements pour des clients situés dans des fuseaux horaires spécifiques, vous devez convertir l’heure locale souhaitée en UTC avant de l’envoyer à l’API.

​
Exemples

Supposons que vous souhaitiez créer un abonnement qui démarre à minuit (00:00) à l’heure de Paris (Europe/Paris) : 
// Exemple 1 : 1er janvier 2024 à 00:00 heure de Paris
// Paris est en UTC+1 en hiver, donc on convertit en UTC (23:00 la veille)
"2023-12-31T23:00:00Z"

// Exemple 2 : 1er juillet 2024 à 00:00 heure de Paris
// Paris est en UTC+2 en été (heure d'été), donc on convertit en UTC (22:00 la veille)
"2024-06-30T22:00:00Z"
Notez que le suffixe Z dans la chaîne de date indique que l’horodatage est en UTC.

​
Bonnes pratiques

  • Utilisez toujours le format ISO 8601 pour les dates
  • Incluez l’indicateur UTC (Z) dans vos horodatages
  • Tenez compte de l’heure d’été lors de la conversion depuis des fuseaux horaires locaux
  • Utilisez une bibliothèque de dates fiable (comme date-fns ou luxon) pour gérer les conversions de fuseaux horaires