TODATETIMEOFFSET (Transact-SQL)

Artigo
10/16/2024

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)

Partilhar via