Função TIMEZONE

TIMEZONE retorna um timestamp para o valor de fuso horário e de timestamp especificados.

Para obter informações e exemplos sobre como definir o fuso horário, consulte timezone.

Para obter informações e exemplos sobre como converter o fuso horário, consulte CONVERT_TIMEZONE.

Sintaxe

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

Argumentos

timezone

O fuso horário para o valor de retorno. O fuso horário pode ser especificado como um nome de fuso horário (como 'Africa/Kampala' ou 'Singapore') ou como uma abreviação de fuso horário (como 'UTC' ou 'PDT'). Para visualizar uma lista de nomes de fusos horários compatíveis, execute o comando a seguir.

select pg_timezone_names();

Para visualizar uma lista de abreviações de fusos horários compatíveis, execute o comando a seguir.

select pg_timezone_abbrevs();

Para ter mais informações e exemplos, consulte Observações quanto ao uso de fuso horário.

timestamp | timestamptz

Uma expressão que resulta em um tipo TIMESTAMP ou TIMESTAMPTZ ou um valor que pode implicitamente ser convertido em um carimbo de data/hora com fuso horário.

Tipo de retorno

TIMESTAMPTZ quando usado com uma expressão TIMESTAMP.

TIMESTAMP quando usado com uma expressão TIMESTAMPTZ.

Exemplos

O seguinte retorna um carimbo de data/hora para o fuso horário UTC usando o carimbo de data/hora 2008-06-17 09:44:54 do fuso horário PST:

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

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

O seguinte retorna um carimbo de data/hora para o fuso horário PST usando o carimbo de data/hora com fuso horário 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