# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.junkipedia.org/es/material-de-referencia/api/parametros-de-la-cadena-de-consulta/filtros-de-tiempo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
