SYSDATETIMEOFFSET (Transact-SQL)

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

傳回 datetimeoffset(7) 值，此值包含在其上執行 SQL Server 執行個體之電腦的日期和時間。 時區位移包括在內。

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

Transact-SQL 語法慣例

語法

SYSDATETIMEOFFSET ( )  

傳回類型

datetimeoffset(7)

備註

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

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

注意

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。

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

結果集如下所示。

SYSDATETIME()      13:18:45.3490361
SYSDATETIMEOFFSET()13:18:45.3490361
SYSUTCDATETIME()   20:18:45.3490361
CURRENT_TIMESTAMP  13:18:45.3470000
GETDATE()          13:18:45.3470000
GETUTCDATE()       20:18:45.3470000

另請參閱

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