Saltar al contenido principal
CloudStudio

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:18

Formatos

Formatos para fecha (sin hora)

La plataforma soporta los siguientes formatos para indicar una fecha.

FormatoComentarios
yyyy/M/dEspecifica 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/ddEspecifica 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.

FormatoComentarios
H:mLa hora se especifica en formato de 24 horas, informando hora y minutos, sin completar con ceros, y utilizando el separador de horas.
H:m:sLa hora se especifica en formato de 24 horas, informando hora, minutos, y segundos, sin completar con ceros, y utilizando el separador de horas.
HH:mmLa hora se especifica en formato de 24 horas, informando hora y minutos, completando con ceros, y utilizando el separador de horas.
HH:mm:ssLa 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.

FormatoComentarios
nnnnnnnnnnFormato 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.

EjemploValor UTC utilizadoComentarios
2020-02-21 03:37:142020-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:14Z2020-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:002020/02/22 01:30:25Indica 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:002020-02-21 15:30:25Indica un desplazamiento de 5 horas hacia el este.

Última actualización

En esta página