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+00O 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