Skip to main content
Alvys maneja varios tipos de datos temporales para representar fechas y horas y utiliza el formato RFC 3339 para representar marcas de tiempo como cadenas. Estos tipos incluyen:
  • Solo fecha: Representa un día específico en el calendario (sin hora), definido por año, mes y día. Ejemplo: 2024-07-04 (July 4, 2024).
  • Fecha y hora (con reconocimiento de zona horaria): representa un valor de fecha y hora que incluye una diferencia de zona horaria específica con respecto a la hora universal coordinada (UTC), según la zona horaria ingresada por el usuario. Ejemplo: 2024-07-04T17:24:53-07:00
    (July 4, 2024, at 5:24:53 PM, 7 horas detrás de UTC).
  • Fecha y hora (UTC): se refiere a un valor de fecha y hora que está estandarizado a la hora universal coordinada (UTC), sin ninguna información ni compensación de zona horaria local. Esto garantiza que la fecha y hora se represente de forma coherente independientemente de la zona horaria local. Ejemplo: 2024-07-04T17:24:53Z (July 4, 2024, at 5:24:53 PM en UTC)

​
Formatos de serialización

  • Solo fecha: serializado como yyyy-MM-dd. Ejemplo: 2024-07-04.
  • Fecha y hora (zona horaria): serializado como yyyy-MM-ddTHH:mm:ss±HH:mm, incluido el desplazamiento desde UTC. Ejemplo: 2024-07-04T17:24:53-07:00.
  • Fecha y hora (UTC): Serializado como yyyy-MM-ddTHH:mm:ssZ en UTC. Ejemplo: 2024-07-04T17:24:53Z.

​
RFC 3339

La versión actual de las API Alvys utiliza el formato RFC 3339 para las marcas de tiempo. RFC 3339 es un estándar ampliamente adoptado para representar la fecha y la hora como cadenas. Aquí hay un ejemplo básico:
La marca de tiempo anterior se refiere a July 4, 2024 5:24:53 PM en Tiempo Universal Coordinado (UTC).

​
Marcas de tiempo de Unix

Las marcas de tiempo de Unix representan el número de segundos que han transcurrido desde la época de Unix, que son las 00:00:00 UTC del 1 de enero de 1970. Las marcas de tiempo de Unix son útiles para garantizar una representación horaria consistente en diferentes sistemas y plataformas, ya que no se ven afectadas por las zonas horarias ni por el horario de verano. Ejemplos:
  • Solo fecha para la marca de tiempo de Unix: Fecha: 2024-07-04, marca de tiempo de Unix: 1720147200
  • Fecha y hora (con reconocimiento de zona horaria) a marca de tiempo Unix: Fecha y hora: 2024-07-04T17:24:53-07:00, marca de tiempo Unix: 1720172693
  • Fecha y hora (UTC) a marca de tiempo Unix: Fecha y hora: 2024-07-04T17:24:53Z, marca de tiempo Unix: 1720172693