En este artículo hablaremos sobre la expresión del tiempo utilizada al insertar lecturas en la plataforma a través de la API. Específicamente, trataremos los siguientes temas:
- Introducción
- Nomenclatura
- ¿Cómo funcionan las estampaciones de tiempo?
- ¿Cómo pueden insertarse las lecturas?
Introducción
Al insertar datos en la Plataforma de Gestión Energética, es importante entender la relación entre el tiempo de la lectura y el tiempo de inserción, así como las diferentes maneras en que podemos expresar ese momento. Una mala configuración puede provocar desalineaciones en las lecturas o huecos en los datos.
Nomenclatura
Primero, definamos los diferentes conceptos implicados en este tema:
- Estampación de tiempo (Time stamps): impresión del momento exacto en una zona horaria y formato específico.
- Zona horaria (Time zone): hora local de la fuente de datos.
- Instante de inserción (Insertion time): instante en el que la lectura es recibida por la plataforma.
- Instante de lectura (Reading time): momento en el que se realizó la lectura.
-
Lectura histórica (Historical Reading): valor leído antes del último valor insertado. El tiempo de inserción es posterior al tiempo de lectura.
-
Lectura de futuro (Future Reading): valor insertado antes del momento de la lectura. Este valor se entiende como predicción.
¿Cómo funcionan las estampaciones de tiempo?
Hay diferentes formas de expresar la hora local de un sitio específico. Para ello, es importante saber que la hora local se ve afectada por la zona horaria del territorio y por el horario de verano (DST).
El tiempo Zulu o UTC (Tiempo Universal Coordinado) es la referencia estándar mundial. Se utiliza para sincronizar relojes en todo el mundo y es constante a lo largo del año (no le afecta el horario de verano), sirviendo como referencia neutral para todas las horas locales.
Para expresar el tiempo en este formato, se puede usar el sufijo Z o añadir +00:00 (que indica que no hay desfase respecto a UTC). Usando las abreviaturas generales, se expresaría como:
YYYY-MM-DDThh:mm:ssZ
YYYY-MM-DDThh:mm:ss+00:00
YYYY-MM-DDThh:mm:ss+0000
La hora local de una ubicación está afectada por el horario de verano y el desfase respecto al UTC; por ejemplo, en España durante el verano la diferencia es UTC+02:00 y en invierno es UTC+01:00.
¿Cómo pueden insertarse las lecturas?
Como hemos mencionado anteriormente, las lecturas pueden ser introducidas como lecturas futuras, históricas o instantáneas; estas últimas son las más habituales y corresponden a aquellas que se insertan en la plataforma justo después su medición.
Es importante usar correctamente las marcas de tiempo al insertar datos en la plataforma, ya que si no son correctas, el tiempo de lectura entendido por la plataforma podría generar una lectura futura y disparar una alerta de Ausencia de datos.
Los formatos válidos reconocidos por la plataforma son:
YYYY-MM-DDThh:mm:ssZ: cuando se usa tiempo Zulu. Si hay corrección por horario de verano, la estampación de tiempo debe ser modificada.
YYYY-MM-DDThh:mm:ss+00:00: usando formato UTC, como en la opción anterior, si hay horario de verano, la estampación de tiempo debe ajustarse. La plataforma también reconoce el formato YYYY-MM-DDThh:mm:ss+0000.
YYYY-MM-DDThh:mm:ss: usando este formato, la plataforma insertará la lectura en la zona horaria configurada en la fuente de datos y corrige automáticamente el DST.
Ejemplo: Horario de verano en Londres
Imaginemos que quieres insertar una lectura en una fuente de datos de Londres el 23 de septiembre a las 12:00. Primero veamos como se expresaría la hora UTC frente a la hora de Londres y con la corrección de horario de verano (hora de verano) en ese instante:
Como la fecha de inserción es con la corrección de DST, necesitamos utilizar UTC+01:00. Considerando que la fuente de datos tiene la zona horaria de Londres, las estampaciones de tiempo correctas serían:
2025-09-23T12:00
2025-09-23T11:00Z
2025-09-23T11:00+01:00
2025-09-23T11:00+0100
Si, en cambio, insertaras la lectura el 11 de diciembre, se usaría UTC+00:00, así las estampaciones de tiempo serían:
2025-12-11T12:00
2025-12-11T12:00Z
2025-12-11T12:00+00:00
2025-12-11T12:00+0000
Si usas formato Zulu sin tener en cuenta la corrección de DST, esto podría traducirse en una lectura a futuro.