Ir para o conteúdo

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 para 2018-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 para 2018-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