Formatos de fechas
La plataforma permite cierta flexibilidad en el uso de campos de fecha / hora en la API HTTP y MQTT. Los campos son siempre de tipo string, pero el contenido puede ser especificado utilizando los siguientes formatos descriptos aquí. En esta sección se describen además las características relacionadas con tratamiento UTC, conversión de zonas horarias, y otros detalles.
Separadores
Separador de fecha
Como separador de fecha, se admiten los caracteres “/”, y “-”, indistintamente.
Separador de hora
El separador de hora debe ser siempre “:”.
Separador entre fecha y hora
Opcionalmente, puede indicarse utilizarse un carácter “T” para separar la fecha y la hora. Las dos fechas siguientes, por ejemplo, son equivalentes:
2020-02-25 14:35:18
2020-02-25T14:35:18Formatos
Formatos para fecha (sin hora)
La plataforma soporta los siguientes formatos para indicar una fecha.
| Formato | Comentarios |
|---|---|
| yyyy/M/d | Especifica el año de 4 dígitos, seguido del mes y del día, sin utilizar ceros para completar mes y día. El separador de fecha puede ser cualquiera de los soportados. |
| yyyy/MM/dd | Especifica el año de 4 dígitos, seguido del mes y del día, utilizando ceros para completar mes y día. El separador de fecha puede ser cualquiera de los soportados. |
Formatos para hora
La plataforma soporta los siguientes formatos para la hora.
| Formato | Comentarios |
|---|---|
| H:m | La hora se especifica en formato de 24 horas, informando hora y minutos, sin completar con ceros, y utilizando el separador de horas. |
| H:m:s | La hora se especifica en formato de 24 horas, informando hora, minutos, y segundos, sin completar con ceros, y utilizando el separador de horas. |
| HH:mm | La hora se especifica en formato de 24 horas, informando hora y minutos, completando con ceros, y utilizando el separador de horas. |
| HH:mm:ss | La hora se especifica en formato de 24 horas, informando hora, minutos, y segundos, completando con ceros, y utilizando el separador de horas. |
Formato epoch
Es posible indicar una fecha y hora en formato epoch, es decir como cantidad de segundos desde las cero horas del 1 de enero de 1970, UTC. El formato epoch está expresado siempre en UTC, y por lo tanto, no permite indicación de zona horaria.
| Formato | Comentarios |
|---|---|
| nnnnnnnnnn | Formato epoch. En este formato, la fecha y hora se informa como una cantidad de segundos a partir de las cero horas del 1 de enero de 1970, UTC. Por ejemplo, la fecha “2010/10/23 02:47:25” corresponde al valor 1287802045. |
Indicación de zona horaria (opcional)
Todas las APIs requieren el uso de fechas y horas UTC. Sin embargo, se permite que las horas informadas sean locales, siempre y cuando contengan la indicación del desplazamiento horario.
- Para todas las fechas y horas que no contengan un desplazamiento horario (o que contengan el sufijo “Z”), se asumirá que están expresadas en UTC.
- En caso de que se informe un desplazamiento horario, deberá estar compuesto por un signo “+” o “-”, seguido de hora y minutos utilizando entre ellos el separador de hora.
- Los desplazamientos horarios no son compatibles con el formato epoch. El formato epoch debe informarse siempre en UTC.
A continuación se presentan algunos ejemplos.
| Ejemplo | Valor UTC utilizado | Comentarios |
|---|---|---|
| 2020-02-21 03:37:14 | 2020-02-21 03:37:14 (el mismo) | Sin indicación de hora, por lo cual se asume UTC. Corresponde a las 03:37:14 del 21 de febrero de 2020, hora UTC. |
| 2020-02-21 03:37:14Z | 2020-02-21 03:37:14 (el mismo) | El sufijo Z indica que la hora está expresada en UTC, de modo que este ejemplo es equivalente al anterior. |
| 2020-02-21 20:30:25 -05:00 | 2020/02/22 01:30:25 | Indica un desplazamiento de 5 horas hacia el oeste. Nótese que en horario UTC, la fecha se adelanta 5 horas y pasa al día siguiente. |
| 2020-02-21 20:30:25 +05:00 | 2020-02-21 15:30:25 | Indica un desplazamiento de 5 horas hacia el este. |
Formatos de datos
Al utilizar las API por HTTP y MQTT, es necesario respetar algunos formatos de datos, como se describe a continuación. Formatos de fechas
Operadores
Los operadores permiten crear expresiones modificando o calculando valores de otros, conocidos como "operandos". Según el tipo de operación a realizar, y/o el...