# Filtros de tiempo

Los siguientes puntos de entrada de la API permiten buscar registros según la fecha en que fueron creados:

* GET /posts
* GET /posts/stats

En cada uno de estos endpoints, dos parámetros trabajan juntos para especificar un rango de tiempo para los registros que se incluirán en los resultados:

* **published\_at\_from** – inicio del rango de tiempo.
* **published\_at\_to** – fin del rango de tiempo.

## Expresión de un valor de tiempo

Los valores de tiempo utilizados con estos parámetros deben expresarse en una marca temporal Unix (Unix Epoch Timestamp).

### Unix Epoch Timestamp

La [marca temporal Unix](https://es.wikipedia.org/wiki/Tiempo_Unix) debe expresarse como un número entero que representa la cantidad de [segundos](https://es.wikipedia.org/wiki/Segundo) transcurridos desde las 00:00:00 [UTC](https://es.wikipedia.org/wiki/Tiempo_universal_coordinado) del 1 de enero de 1970. Herramientas como [epochconverter.com](http://epochconverter.com) pueden ser útiles para convertir entre diferentes formatos de fecha y hora.

Por ejemplo, el mediodía UTC del 1 de enero de 2022 se representaría como **1641038400**.

## Opciones de rango de tiempo

Un rango de tiempo puede especificarse de las siguientes maneras:

* Especificar un inicio y un fin explícitos utilizando ambos parámetros.
* Especificar un inicio explícito y dejar el tiempo actual como el fin implícito del rango.
* Omitir ambos parámetros para aceptar un rango de tiempo predeterminado del sistema que cubre publicaciones recientes. A partir de noviembre de 2022, el rango de tiempo predeterminado del sistema abarca los últimos siete días de publicaciones recientes.

Es importante tener en cuenta que el uso del parámetro **published\_at\_to** sin el parámetro **published\_at\_from** no está soportado y puede generar resultados inesperados.

### Rango explícito

La siguiente solicitud recuperará publicaciones desde el 1 de enero de 2022 a mediodía UTC hasta el mediodía UTC del día siguiente:

GET /posts?published\_at\_from=1641038400\&published\_at\_to=1641124800

### Inicio explícito del rango con fin implícito

Si se omite el parámetro **published\_at\_to**, el tiempo actual se considerará como el fin implícito del rango de tiempo. La siguiente solicitud recuperará publicaciones desde el 1 de enero de 2022 a mediodía UTC hasta el momento actual:

GET /posts?published\_at\_from=1641038400

### Fin explícito del rango con inicio implícito

Si se omiten ambos parámetros **published\_at\_to** y **published\_at\_from**, se aplicará el rango de tiempo predeterminado de publicaciones recientes:

GET /posts
