¿Cómo funcionan los campos de fecha y hora en la API?

La API devuelve las fechas y horas en dos formatos, juntos en la misma respuesta:

El formato habitual es YYYY-MM-DD HH:MM:SS, por ejemplo, 2026-05-18 14:30:00. No incluye ninguna zona horaria. Es la fecha y la hora en la zona horaria de la cuenta. Esa zona horaria se indica en el campo timezone del mismo objeto.
El formato ISO incluye el desplazamiento de la zona horaria, por ejemplo, 2026-05-18T14:30:00+02:00. Reconocerás estos campos por el sufijo _iso.

{
  "timezone": "Europe/Amsterdam",
  "modified": "2026-05-18 14:30:00",
  "modified_iso": "2026-05-18T14:30:00+02:00"
}

Si trabajas con usuarios o sistemas en diferentes zonas horarias, utiliza la variante _iso. Así siempre estará claro de qué zona horaria se trata.

Leer campos de fecha vacíos

Si el valor habitual está vacío, la variante _iso puede no aparecer en absoluto en la respuesta. Por ejemplo, en un campo que nunca se ha modificado, recibirás "modified": null, pero no modified_iso. Por lo tanto, no des por sentado que este campo estará siempre presente en la respuesta.

Otros objetos sí devuelven "modified_iso": null en la misma situación. Por eso, al leer los datos, comprueba siempre primero si el campo está presente en la respuesta.

Enviar una fecha por tu cuenta

Si un endpoint acepta una fecha, puedes utilizar ambos formatos. Si envías una fecha ISO en una cadena de consulta (query string), sustituye el signo más por %2B:

event_date_from=2026-05-18T14:30:00%2B02:00

Leer campos de fecha vacíos

Enviar una fecha por tu cuenta

Artículos relacionados