Función TIMEZONE

TIMEZONE devuelve una marca temporal para el valor de marca temporal y zona horaria especificados.

Para obtener información y ejemplos acerca de cómo establecer la zona horaria, consulte timezone.

Para obtener información y ejemplos acerca de cómo convertir la zona horaria, consulte CONVERT_TIMEZONE.

Sintaxis

TIMEZONE('timezone', { timestamp | timestamptz })

Argumentos

timezone

La zona horaria para el valor de retorno. La zona horaria puede especificarse como un nombre (por ejemplo, 'Africa/Kampala' o 'Singapore') o como una abreviatura (por ejemplo, 'UTC' o 'PDT'). Para ver una lista de los nombres de zonas horarias compatibles, ejecute el siguiente comando.

select pg_timezone_names();

Para ver una lista de las abreviaturas de zonas horarias compatibles, ejecute el siguiente comando.

select pg_timezone_abbrevs();

Para obtener más información y ejemplos, consulte Notas de uso de la zona horaria.

timestamp | timestamptz

Una expresión que da como resultado un valor de tipo TIMESTAMP o TIMESTAMPTZ o un valor que pueda convertirse implícitamente a una marca temporal o a una marca temporal con zona horaria.

Tipo de retorno

TIMESTAMPTZ, cuando se usa con una expresión TIMESTAMP.

TIMESTAMP, cuando se usa con una expresión TIMESTAMPTZ.

Ejemplos

Lo siguiente devuelve una marca temporal para la zona horaria UTC mediante la marca temporal 2008-06-17 09:44:54 de la zona horaria PST.

SELECT TIMEZONE('PST', '2008-06-17 09:44:54');

timezone
-----------------------
2008-06-17 17:44:54+00

Lo siguiente devuelve una marca temporal para la zona horaria PST mediante la marca temporal con zona horaria UTC 2008-06-17 09:44:54+00.

SELECT TIMEZONE('PST', timestamptz('2008-06-17 09:44:54+00'));

timezone
-----------------------
2008-06-17 01:44:54