*Visión general › Para saber más*

# Fechas y horas

> Las respuestas dan las fechas en UTC. Cuando escribes, envía un instante ISO 8601 con desplazamiento. Una fecha sin hora como `2026-10-17` se lee en la zona horaria del negocio de la cuenta cuando está en un filtro; una escritura solo la admite en un campo que sea una fecha simple.

El trabajo de alquiler se organiza en días, y un día depende de dónde esté el negocio. Por eso la API separa tres cosas: el instante (exacto, UTC), el desplazamiento que envías con él y la zona horaria del negocio de la cuenta, que decide qué significa una fecha sin hora.

## En las respuestas

Las fechas son cadenas ISO 8601 en UTC (`date-time`), por ejemplo `2026-10-17T08:00:00Z`. Conviértelas a la hora local en tu propio código.

## Cuando escribes

Envía cada fecha y hora como un instante ISO 8601 con desplazamiento, por ejemplo `2026-10-17T10:00:00+02:00`. Un instante con desplazamiento designa el mismo momento sea cual sea la zona; las respuestas lo devuelven en UTC. El contrato REST y las herramientas MCP exigen el desplazamiento en cada fecha y hora que escribes.

> **Nota:** La única excepción es un campo que es una fecha simple, sin hora: `invoiceDate` y `dueDate` de [`PUT /api/v1/invoices/external/{originSystem}/{originExternalId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/create-or-update-the-mirror-of-an-externally-issued-invoice) aceptan una fecha sin hora como `2026-10-17`, sin hora ni desplazamiento. En cualquier otro sitio, si una escritura con una fecha sin hora devuelve [`validation_error`](https://docs.filmo.io/es/rest-api/errors/validation_error), añade una hora y un desplazamiento.

## La zona horaria del negocio

La cuenta tiene una zona horaria IANA, que es en la que se leen las fechas sin hora de los filtros. Léela una vez con [`GET /api/v1/account`](https://docs.filmo.io/es/rest-api/endpoint-reference/account/get-the-account), en el campo `timezone`, junto con la moneda y el idioma. No la deduzcas del país ni del servidor en el que ejecutas.

## Filtros de fecha en las listas

Las listas que los admiten aceptan dos familias de filtros, una para la hora de creación y otra para la última actualización: `createdOn`, `createdAfter`, `createdBefore`, `createdFrom`, `createdTo`, y los mismos nombres con `updated`. Cada uno acepta una fecha sin hora, interpretada en la zona horaria del negocio, o un instante ISO 8601 con desplazamiento.

| Filtro | Significado |
| --- | --- |
| `…On` | Cae en esta fecha. |
| `…After` | Es posterior a esta fecha. |
| `…Before` | Es anterior a esta fecha. |
| `…From` | Es igual o posterior a esta fecha. |
| `…To` | Es igual o anterior a esta fecha. |

Con una fecha sin hora, `…After` deja fuera ese día entero y `…Before` se detiene al inicio de ese día, mientras que `…From` empieza al principio del día y `…To` lo incluye entero.

Para una sincronización incremental, [`updatedFrom`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/list-orders#param-updatedFrom) y [`updatedBefore`](https://docs.filmo.io/es/rest-api/endpoint-reference/orders/list-orders#param-updatedBefore) forman una ventana semiabierta. La guía sobre [sincronizar datos](https://docs.filmo.io/es/rest-api/guides/syncing-data) muestra cómo usarlos sin perder registros.

## Fechas en las herramientas MCP

Las herramientas de listado de MCP reciben un único objeto `dateFilters` en lugar de parámetros separados: `dateFilters: { field: { gte, lte, gt, lt, on } }`. Una fecha sin hora en `gte` o `on` es el inicio de ese día del negocio, y en `lte` el final de ese día; `gt` significa después del final de ese día y `lt` antes de su inicio. Un instante con desplazamiento se aplica tal cual, salvo con `on`, que cubre todo el día del negocio que lo contiene.

> **Consejo:** Si una consulta por días devuelve registros que no esperabas, comprueba primero la zona horaria: la misma fecha sin hora abarca instantes distintos en zonas horarias distintas.

---

URL canónica: https://docs.filmo.io/es/further-reading/dates-and-times  
Última actualización: 2026-10-09