Função de Banco de Dados Mvsql - ToTimeZone()¶
Resumo¶
Ajusta uma data e hora em UTC para o deslocamento de fuso horário fornecido.
Sintaxe¶
TOTIMEZONE(<datetime>, <timezoneoffset>)
Parâmetros¶
Data e Hora¶
Uma expressão que resolve para um valor datetime. O valor datetime é assumido como um timestamp UTC.
Deslocamento de Fuso Horário¶
Uma string no formato de deslocamento ISO ±[hh]:[mm]
.
Devoluções¶
Retorna um datetime ajustado para o fuso horário fornecido.
O tipo de dado datetime armazena um timestamp sem um deslocamento de fuso horário.
Observações¶
O TOTIMEZONE()
A função é suportada somente em provedores de dados RDBMS. Os seguintes provedores de dados foram testados:
- DB2/LUW
- DB2/i
- MySQL
- Oracle
- PostgreSQL
- SQL Server
- SQLite
Exemplos¶
Deslocamento Literal do Fuso Horário¶
Dado:
NOW(UTC)
avalia para2018-08-01 21:00:00.000
A expressão:
TOTIMEZONE(NOW(UTC), '-04:00')
Retorna 2018-08-01 17:00:00.000
Deslocamento de Fuso Horário do Cliente¶
Dado:
NOW(UTC)
avalia para2018-08-01 21:00:00.000
CLIENT(TIMEZONEOFFSET)
avalia para-04:00
A expressão:
TOTIMEZONE(NOW(UTC), CLIENT(TIMEZONEOFFSET))
Retorna 2018-08-01 17:00:00.000