SYSUTCDATETIME (Transact-SQL)

適用於： SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)

傳回 datetime2 值，該值包含 SQL Server 執行個體執行所在電腦的日期與時間。 日期和時間是以國際標準時間 (Coordinated Universal Time，UTC) 傳回。 毫秒的有效位數規格範圍介於 1 至 7 位數之間。 預設有效位數是 7 位數。

注意

SYSDATETIME 和 SYSUTCDATETIME 比 GETDATE 和 GETUTCDATE 具有更多小數秒數有效位數。 SYSDATETIMEOFFSET 包含系統時區位移。 SYSDATETIME、SYSUTCDATETIME 和 SYSDATETIMEOFFSET 可指派給任一個日期和時間類型的變數。

如需所有 Transact-SQL 日期與時間資料類型及函數的概觀，請參閱日期與時間資料類型及函數 (Transact-SQL)。

Transact-SQL 語法慣例

語法

SYSUTCDATETIME ( )  

傳回類型

datetime2

備註

只要是 Transact-SQL 陳述式可以參考 datetime2 運算式的任何位置，該陳述式就可以參考 SYSUTCDATETIME。

SYSUTCDATETIME 是不具決定性的函數。 在資料行中參考這個函數的檢視表和運算式無法編製索引。

注意

SQL Server 會使用 GetSystemTimeAsFileTime() Windows API 來取得日期與時間值。 精確度取決於 SQL Server 執行個體執行所在的電腦硬體與 Windows 版本。 此 API 的精確度是固定於 100 奈秒。 正確性可藉由使用 GetSystemTimeAdjustment() Windows API 來判斷。

範例

下列範例會使用六個可傳回目前日期與時間的 SQL Server 系統函數，來傳回日期、時間或這兩者。 由於這些值會依序傳回，因此其小數秒數可能會不同。

A. 顯示日期和時間函數所傳回的格式

下列範例示範日期和時間函數所傳回的不同格式。

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

B. 將日期和時間轉換成日期

下列範例會顯示如何將日期和時間值轉換成 date。

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

C. 將日期和時間值轉換成時間

下列範例會顯示如何將日期和時間值轉換成 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

另請參閱

CAST 和 CONVERT (Transact-SQL)
日期和時間資料類型與函數 (Transact-SQL)
AT TIME ZONE (Transact-SQL)