Share via

TODATETIMEOFFSET (Transact-SQL)

  • Статья

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

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

TODATETIMEOFFSET ( expression , time_zone )

Аргументы

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

    ПримечаниеПримечание

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

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

    ПримечаниеПримечание

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

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

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

Примеры

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

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

DECLARE @todaysDateTime datetime2;
SET @todaysDateTime = GETDATE();
SELECT TODATETIMEOFFSET (@todaysDateTime, '-07:00');
-- RETURNS 2007-08-30 15:51:34.7030000 -07:00

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

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

DECLARE @todaysDate datetime2;
SET @todaysDate = GETDATE();
SELECT TODATETIMEOFFSET (@todaysDate, -120);
-- RETURNS 2007-08-30 15:52:37.8770000 -02:00

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

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

DECLARE @dateTime datetimeoffset(7)= '2007-08-28 18:00:30';
SELECT TODATETIMEOFFSET (@dateTime, '+13:00');
-- RETURNS 2007-08-28 18:00:30.0000000 +13:00

См. также

Справочник

Функции CAST и CONVERT (Transact-SQL)

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