Dans cet article, nous allons aborder les expressions liées à l’horodatage et au temps d’insertion lors de l’introduction des relevés sur la plateforme pour l'API. Plus précisément, nous traiterons les sujets suivants :
- Introduction
- Nomenclature
- Comment fonctionnent les horodatages ?
- Comment les relevés peuvent-ils être insérés ?
Introduction
Lors de l’insertion de données sur la Plateforme de Gestion d’Énergie, il est essentiel de comprendre la relation entre l’instant de lecture et le temps d’insertion, ainsi que les différentes façons d’exprimer le temps. Une configuration incorrecte peut entraîner des décalages d’horodatage ou des lacunes de données.
Nomenclature
Définissons d’abord les concepts impliqués dans ce sujet :
- Horodatage (time stamp) : empreinte de l’instant précis dans un fuseau horaire et un format spécifiques.
- Fuseau horaire (time zone) : heure locale de la source de données.
- Temps d’insertion (insertion time) : moment où la lecture est reçue par la plateforme.
- Instant de lecture (reading time) : moment où la lecture a eu lieu.
-
Lecture historique (historical reading) : valeur relevée avant la dernière valeur insérée. Son temps d’insertion est postérieur à l’instant de lecture.
-
Lecture future (future reading) : valeur insérée avant son horodatage. Cette valeur est comprise comme une prévision.
Comment fonctionnent les horodatages ?
Il existe différentes manières d’exprimer l’heure locale d’un emplacement. Pour cela, il est important de savoir que l’heure locale peut être influencée par le fuseau horaire du territoire et l’heure d’été (DST).
L’heure Zulu ou UTC (Temps universel coordonné) est la référence horaire mondiale. Elle permet la synchronisation des horloges à travers le monde, et reste constante tout au long de l’année (non affectée par le DST), servant ainsi de référence neutre pour toutes les heures locales.
Pour exprimer l’heure selon ce format, on peut utiliser le suffixe Z ou ajouter +00:00 (ce qui indique qu’il n’y a pas de décalage par rapport à l’UTC). En abréviations générales, cela s’écrit :
YYYY-MM-DDThh:mm:ssZ
YYYY-MM-DDThh:mm:ss+00:00
YYYY-MM-DDThh:mm:ss+0000
L’heure locale d’un site est quant à elle affectée par le DST et le décalage par rapport à l’UTC. Par exemple, en Espagne, pendant l’été la correction est UTC+02:00, et pendant l’hiver UTC+01:00.
Comment les relevés peuvent-ils être insérés ?
Comme mentionné auparavant, les relevés peuvent être insérés en tant que lectures futures, historiques ou instantanées, cette dernière étant la plus courante : ce sont les lectures insérées juste après la mesure.
Il est fondamental d’utiliser correctement les horodatages lors de l’insertion des données : une erreur peut amener la plateforme à interpréter la lecture comme future et déclencher une alerte d'absence de données .
Les formats d’horodatage corrects acceptés par la plateforme sont :
YYYY-MM-DDThh:mm:ssZ : pour le format Zulu, si une correction DST existe, l’horodatage doit être ajusté.
YYYY-MM-DDThh:mm:ss+00:00 : pour le format UTC, comme précédemment, en cas de DST l’horodatage change. La plateforme accepte aussi le format YYYY-MM-DDThh:mm:ss+0000.
YYYY-MM-DDThh:mm:ss : dans ce cas, la plateforme insère la lecture selon le fuseau horaire paramétré pour la source de données, en tenant compte du DST.
Exemple : Heure d’été à Londres
Imaginons que vous souhaitez insérer une lecture pour une source de données à Londres, le 23 septembre à 12h00. Observons l’heure UTC vs l’heure locale de Londres avec la correction DST (été) :
Étant donné que la date correspond à une période de DST, il faut utiliser UTC+01:00. Si la source est configurée sur le fuseau horaire de Londres, les horodatages corrects seraient :
2025-09-23T12:00
2025-09-23T11:00Z
2025-09-23T11:00+01:00
2025-09-23T11:00+0100
Si, au contraire, la lecture se fait le 11 décembre, il faudrait utiliser UTC+00:00, et donc :
2025-12-11T12:00
2025-12-11T12:00Z
2025-12-11T12:00+00:00
2025-12-11T12:00+0000
Si l’on utilise le format Zulu sans tenir compte de la correction DST, la lecture serait interprétée comme une lecture future.