SYSUTCDATETIME （Transact-SQL）

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsMicrosoft Fabric中的SQL分析端点Microsoft Fabric中的仓库Microsoft Fabric中的SQL数据库

SYSUTCDATETIME Transact-SQL（T-SQL）函数返回一个datetime2值，其中包含SQL Server实例运行的计算机的日期和时间。 日期和时间作为 UTC 时间（通用协调时间）返回。 秒部分精度规范的范围为 1 至 7 位。 默认精度为 7 位数。

如下所示：

  • SYSDATETIME 并且 SYSUTCDATETIME 具有比 GETDATE 和更多的 GETUTCDATE小数秒精度。

  • SYSDATETIMEOFFSET 包括系统时区偏移量。

  • SYSDATETIME， SYSUTCDATETIME并且可以 SYSDATETIMEOFFSET 分配给任一日期和时间类型的变量。

有关所有 Transact-SQL 日期和时间数据类型和函数的概述，请参阅 日期和时间数据类型和函数。

Transact-SQL 语法约定

Syntax

SYSUTCDATETIME ( )

返回类型

datetime2

Remarks

Transact-SQL 语句可以引用 SYSUTCDATETIME 它们可引用 datetime2 表达式的任何位置。

SYSUTCDATETIME 是一个不确定函数。 无法为列中引用此函数的视图和表达式编制索引。

Note

SQL Server 使用 GetSystemTimeAsFileTime() Windows API 获取日期和时间值。 精确程度取决于运行 SQL Server 实例的计算机硬件和 Windows 版本。 此 API 的精度固定为 100 纳秒。 可以使用 Windows API 来确定 GetSystemTimeAdjustment() 准确性。

Examples

以下示例使用六个返回当前日期和时间的 SQL Server 系统函数来返回日期和/或时间。 这些值是连续返回的；因此，它们的秒小数部分可能有所不同。

A. 显示日期和时间函数返回的格式

下面的示例显示由日期和时间函数返回的其他格式。

SELECT SYSDATETIME(),
       SYSDATETIMEOFFSET(),
       SYSUTCDATETIME(),
       CURRENT_TIMESTAMP,
       GETDATE(),
       GETUTCDATE(),
       CURRENT_DATE;

结果集如下。

SYSDATETIME()        2026-09-01 16:15:37.7418724
SYSDATETIMEOFFSET()  2026-09-01 16:15:37.7418724 -06:00
SYSUTCDATETIME()     2026-09-01 22:15:37.7418724
CURRENT_TIMESTAMP    2026-09-01 16:15:37.740
GETDATE()            2026-09-01 16:15:37.740
GETUTCDATE()         2026-09-01 22:15:37.740
CURRENT_DATE         2026-09-01

B. 将日期和时间转换为日期

以下示例演示如何将日期和时间值转换为 日期 数据类型。

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

结果集如下。

SYSDATETIME()        2026-09-01
SYSDATETIMEOFFSET()  2026-09-01
SYSUTCDATETIME()     2026-09-01
CURRENT_TIMESTAMP    2026-09-01
GETDATE()            2026-09-01
GETUTCDATE()         2026-09-01
CURRENT_DATE         2026-09-01

C. 将日期和时间值转换为时间

以下示例演示如何将日期和时间值转换为 时间 数据类型。

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

结果集如下。

SYSDATETIME()        16:15:37.7418724
SYSDATETIMEOFFSET()  16:15:37.7418724
SYSUTCDATETIME()     22:15:37.7418724
CURRENT_TIMESTAMP    16:15:37.740
GETDATE()            16:15:37.740
GETUTCDATE()         22:15:37.740

相关内容

  • Last updated on