TODATETIMEOFFSET (Transact-SQL)
Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)
Retorna um valor de datetimeoffset que é convertido de uma expressão datetime2.
Convenções de sintaxe de Transact-SQL
Sintaxe
TODATETIMEOFFSET ( datetime_expression , timezoneoffset_expression )
Argumentos
datetime_expression
É uma expression resolvida em um valor datetime2.
Observação
A expressão não pode ser do tipo text, ntext ou image porque esses tipos não podem ser convertidos implicitamente em varchar ou nvarchar.
timezoneoffset_expression
É uma expressão que representa o deslocamento de fuso horário em minutos (se for um inteiro), por exemplo -120, ou horas e minutos (se for uma cadeia de caracteres), por exemplo '+13:00'. O intervalo é de +14 a -14 (em horas). A expressão é interpretada em hora local para o timezoneoffset_expression especificado.
Observação
Se a expressão for uma cadeia de caracteres, deve estar no formato {+|-}TZH:THM.
Tipo de retorno
datetimeoffset. A precisão fracionária é igual à do argumento datetime_expression.
Exemplos
a. Alterando o deslocamento de fuso horário da data e da hora atuais
O exemplo seguinte altera o deslocamento de fuso horário da data e da hora atuais para o fuso horário -07:00
.
DECLARE @todaysDateTime DATETIME2;
SET @todaysDateTime = GETDATE();
SELECT TODATETIMEOFFSET (@todaysDateTime, '-07:00');
-- RETURNS 2019-04-22 16:23:51.7666667 -07:00
B. Alterando o deslocamento de fuso horário em minutos
O exemplo seguinte altera o fuso horário atual para -120
minutos.
SELECT TODATETIMEOFFSET(SYSDATETIME(), -120)
-- RETURNS: 2019-04-22 11:39:21.6986813 -02:00
C. Adicionando um deslocamento de fuso horário de 13 horas
O exemplo seguinte adiciona um deslocamento de fuso horário de 13 horas a uma data e hora.
SELECT TODATETIMEOFFSET(SYSDATETIME(), '+13:00')
-- RETURNS: 2019-04-22 11:39:29.0339301 +13:00
Consulte Também
CAST e CONVERT (Transact-SQL)
tipos de dados e funções de data e hora (Transact-SQL)
AT TIME ZONE (Transact-SQL)