Menu

timestamp vs timestamptz en PostgreSQL (zona horaria)

timestamptz guarda un instante y lo muestra en la zona horaria de la sesión; timestamp guarda una hora de reloj sin zona. Ninguno guarda la zona que escribiste. Usa timestamptz para casi todo.

Esta página incluye editores ejecutables: edita, ejecuta y ve el resultado al instante.

PostgreSQL tiene dos tipos de timestamp. timestamptz (timestamp with time zone) guarda un instante exacto: se convierte a UTC al entrar y se muestra en la zona horaria de la sesión al salir. timestamp (timestamp without time zone) guarda una fecha y una hora de reloj sin zona. Ninguno guarda la zona que escribiste. Para todo lo que ocurrió en un momento concreto, usa timestamptz.

La misma entrada da 2026-03-01 12:00:00 y 2026-03-01 21:00:00+09. El valor timestamptz es el mismo instante que antes, ahora mostrado en hora de Tokio. El valor timestamp no tiene zona desde la que convertir, así que no se mueve.

Qué pasa con la zona horaria de la entrada

Cuando la entrada trae un desfase, timestamptz lo usa para calcular el instante. timestamp lo descarta sin avisar:

plain es 2026-03-01 12:00:00, sin el +02. with_zone es 2026-03-01 10:00:00+00, el mismo instante en UTC. Así es como las horas acaban desfasadas: una aplicación envía un texto ISO con desfase a una columna timestamp, y el desfase desaparece.

Cuándo usar cada uno

UsoTipo
Creado, actualizado, pagado, inició sesióntimestamptz
Una hora local programada que sigue el reloj local ("a las 9:00 cada día en la zona del usuario")timestamp más una columna con el nombre de la zona
Un día del calendario sin horadate
Una duracióninterval

Los dos tipos ocupan 8 bytes y guardan microsegundos. Fija la zona de la sesión con SET TIME ZONE 'Europe/Paris'. Usa nombres de zona completos, no abreviaturas como EST: una abreviatura es un desfase fijo que ignora el horario de verano.

Convertir entre zonas con AT TIME ZONE

AT TIME ZONE funciona en los dos sentidos. Sobre un timestamptz devuelve la hora de reloj en esa zona, como timestamp. Sobre un timestamp lee el valor como hora local de esa zona y devuelve el instante timestamptz.

El mediodía UTC son las 08:00 en Nueva York en julio, y las 9:00 en París son las 07:00 UTC. Usa la primera forma para mostrar una hora en la zona del usuario, y la segunda para convertir en instante una hora local que escribió el usuario.

Horario de verano y aritmética con intervalos

Sumar interval '1 day' a un timestamptz mantiene la misma hora de reloj local a través de un cambio de horario. Sumar '24 hours' suma horas exactas. En Estados Unidos los relojes se adelantan el 8 de marzo de 2026:

El primero da 2026-03-08 12:00:00-04 y el segundo 2026-03-08 13:00:00-04. El resultado depende de la zona horaria de la sesión, así que fíjala explícitamente en el código que hace cálculos con fechas.

La hora actual

now() y current_timestamp devuelven la hora de inicio de la transacción actual como timestamptz, el mismo valor para todas las filas que toca una sentencia. clock_timestamp() devuelve la hora real en cada llamada. current_date devuelve un date, y localtimestamp un timestamp. Una columna típica es created_at timestamptz NOT NULL DEFAULT now().

Convertir una columna timestamp en timestamptz

Si una columna timestamp existente guarda horas en UTC, conviértela con USING ... AT TIME ZONE 'UTC', para que los valores se lean como UTC y no en la zona de la sesión:

El valor ahora es 2026-01-15 09:30:00+01, mostrado en hora de Berlín. El cambio reescribe la tabla, así que en una tabla grande ejecútalo en un momento tranquilo (ALTER TABLE explica los cambios de tipo). Funciones como date_trunc, extract y age están en la página de funciones de fecha, y el capítulo de tipos de fecha y hora tiene todos los formatos de entrada.

Preguntas frecuentes

¿timestamptz guarda la zona horaria en PostgreSQL?

No. Convierte la entrada a UTC y solo guarda ese instante. La zona que escribiste se pierde; la salida se muestra según el parámetro TimeZone de la sesión. Guarda el nombre de la zona en una columna text aparte si lo necesitas después.

¿Qué diferencia hay entre now() y clock_timestamp()?

now() (igual que current_timestamp) devuelve la hora de inicio de la transacción actual, así que es la misma para todas las filas y sentencias dentro de ella. clock_timestamp() devuelve la hora real en el momento de la llamada y cambia incluso dentro de una misma sentencia.

¿Cómo obtengo la fecha actual en PostgreSQL?

current_date devuelve la fecha de hoy en la zona horaria de la sesión. now()::date da lo mismo, y localtimestamp devuelve la fecha y hora actuales como un timestamp sin zona.

¿Cuánto ocupa un timestamp en PostgreSQL?

8 bytes tanto timestamp como timestamptz, con resolución de microsegundos. date ocupa 4 bytes.

Ilustración de los lenguajes de programación de Coddy

Aprende a programar con Coddy

Comenzar