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

SYSUTCDATETIME (Transact-SQL)

Область применения:SQL ServerБаза данных SQL AzureУправляемый экземпляр SQL AzureАналитика Azure SynapseПлатформа аналитики (PDW)Конечная точка аналитики SQL в Microsoft FabricХранилище в Microsoft FabricБаза данных SQL в Microsoft Fabric

Возвращает значение datetime2, содержащее дату и время компьютера, на котором выполняется экземпляр SQL Server. Возвращаемые дата и время отображаются в формате UTC. Точность дробной части значения секунд может быть задана в диапазоне от 1 до 7 цифр. Точность по умолчанию составляет 7 цифр.

Примечание.

SYSDATETIME и SYSUTCDATETIME имеет более дробную точность секунд, чем GETDATE и GETUTCDATE.

SYSDATETIMEOFFSET включает смещение часового пояса системы.

SYSDATETIME, SYSUTCDATETIMEи SYSDATETIMEOFFSET может быть назначен переменной любого из типов даты и времени.

Общие сведения обо всех типах и функциях данных даты и времени Transact-SQL см. в разделе "Типы и функции данных даты и времени" (Transact-SQL).

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

Синтаксис

SYSUTCDATETIME ( )

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

datetime2

Замечания

Transact-SQL операторы могут ссылаться на SYSUTCDATETIME любое место, где они могут ссылаться на выражение datetime2 .

SYSUTCDATETIME является недетерминированной функцией. Невозможно проиндексировать представления и выражения, ссылающиеся на эту функцию в столбце.

Примечание.

SQL Server получает значения даты и времени с помощью GetSystemTimeAsFileTime() API Windows. Точность зависит от оборудования компьютера и версии Windows, в которой выполняется экземпляр SQL Server. Точность возвращаемых значений этого API-интерфейса задана равной 100 нс. Точность можно определить с помощью GetSystemTimeAdjustment() API Windows.

Примеры

В следующих примерах используются шесть системных функций SQL Server, возвращающих текущую дату и время для возврата даты, времени или обоих. Значения возвращаются последовательно и поэтому могут различаться на доли секунды.

А. Отображение форматов, возвращаемых функциями даты и времени

В следующем примере показаны различные идентификаторы, возвращаемые функциями даты и времени.

SELECT SYSDATETIME() AS [SYSDATETIME()]  
    ,SYSDATETIMEOFFSET() AS [SYSDATETIMEOFFSET()]  
    ,SYSUTCDATETIME() AS [SYSUTCDATETIME()]  
    ,CURRENT_TIMESTAMP AS [CURRENT_TIMESTAMP]  
    ,GETDATE() AS [GETDATE()]  
    ,GETUTCDATE() AS [GETUTCDATE()];

Вот результирующий набор.

SYSDATETIME()      2007-04-30 13:10:02.0474381
SYSDATETIMEOFFSET()2007-04-30 13:10:02.0474381 -07:00
SYSUTCDATETIME()   2007-04-30 20:10:02.0474381
CURRENT_TIMESTAMP  2007-04-30 13:10:02.047
GETDATE()          2007-04-30 13:10:02.047
GETUTCDATE()       2007-04-30 20:10:02.047

В. Преобразование даты и времени в дату

В следующем примере показано, как преобразовать значения даты и времени в тип данных даты .

SELECT CONVERT (date, SYSDATETIME())  
    ,CONVERT (date, SYSDATETIMEOFFSET())  
    ,CONVERT (date, SYSUTCDATETIME())  
    ,CONVERT (date, CURRENT_TIMESTAMP)  
    ,CONVERT (date, GETDATE())  
    ,CONVERT (date, GETUTCDATE());

Вот результирующий набор.

2007-04-30
2007-04-30
2007-04-30
2007-04-30
2007-04-30
2007-04-30

В. Преобразование значений даты и времени в время

В следующем примере показано, как преобразовать значения даты и времени в тип данных time*.

DECLARE @DATETIME DATETIME = GetDate();
DECLARE @TIME TIME
SELECT @TIME = CONVERT(time, @DATETIME)
SELECT @TIME AS 'Time', @DATETIME AS 'Date Time'

Вот результирующий набор.

Time             Date Time  
13:49:33.6330000 2009-04-22 13:49:33.633

Связанный контент