> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alvys.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fechas y marcas de tiempo

> Cómo la API Alvys representa fechas, fechas y horas con reconocimiento de zona horaria y fechas y horas UTC utilizando el formato de cadena RFC 3339, con ejemplos de serialización para cada tipo.

Alvys maneja varios tipos de datos temporales para representar fechas y horas y utiliza el formato [RFC 3339](https://tools.ietf.org/html/rfc3339) 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](https://tools.ietf.org/html/rfc3339) 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:

```
2024-07-04T17:24:53Z
```

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`