TODATETIMEOFFSET (Transact-SQL)

Статья
01/02/2025

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Возвращает значение datetimeoffset, преобразованное из выражения datetime2.

Соглашения о синтаксисе Transact-SQL

Синтаксис

TODATETIMEOFFSET ( datetime_expression , timezoneoffset_expression )

Аргументы

datetime_expression
Выражение, которое разрешается в значение datetime2.

Примечание.

Выражение не может иметь тип text, ntext или image, так как эти типы нельзя неявно преобразовать в тип varchar или nvarchar.

timezoneoffset_expression
Выражение, которое представляет смещение часового пояса в минутах (если это целое число), например –120, или в часах и минутах (если это строка), например "+13:00". Диапазон охватывает значения от +14 до -14 (в часах). Выражение приводится к местному времени для указанного часового пояса timezoneoffset_expression.

Примечание.

Если выражение является символьной строкой, оно должно иметь формат {+|-}TZH:THM.

Тип возвращаемых данных

datetimeoffset. Дробная точность такая же, как у аргумента datetime_expression.

Примеры

А. Изменение смещения часового пояса для текущего значения даты и времени

В следующем примере смещение пояса для текущего значения даты и времени изменяется на часовой пояс -07:00.

DECLARE @todaysDateTime DATETIME2;  
SET @todaysDateTime = GETDATE();  
SELECT TODATETIMEOFFSET (@todaysDateTime, '-07:00');  
-- RETURNS 2019-04-22 16:23:51.7666667 -07:00

B. Изменение смещения часового пояса в минутах

В следующем примере текущий часовой пояс изменяется на -120 минут.

SELECT TODATETIMEOFFSET(SYSDATETIME(), -120)
-- RETURNS: 2019-04-22 11:39:21.6986813 -02:00

В. Добавление 13-часового смещения часового пояса

В следующем примере 13-часовое смещение часового пояса добавляется к дате и времени.

SELECT TODATETIMEOFFSET(SYSDATETIME(), '+13:00')
-- RETURNS: 2019-04-22 11:39:29.0339301 +13:00

См. также

CAST и CONVERT (Transact-SQL)
Типы данных и функции даты и времени (Transact-SQL)
AT TIME ZONE (Transact-SQL)

Поделиться через