Delen via


SYSUTCDATETIME (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Analytics-eindpunt in Microsoft FabricMagazijn in Microsoft FabricSQL-database in Microsoft Fabric Preview

Retourneert een datum/tijd2-waarde die de datum en tijd bevat van de computer waarop het exemplaar van SQL Server wordt uitgevoerd. De datum en tijd worden geretourneerd als UTC-tijd (Coordinated Universal Time). De specificatie van de breuk tweede precisie heeft een bereik van 1 tot 7 cijfers. De standaardprecisie is 7 cijfers.

Overweeg het volgende:

  • SYSDATETIME en SYSUTCDATETIME meer fractionele seconden precisie hebben dan GETDATE en GETUTCDATE.

  • SYSDATETIMEOFFSET bevat de verschuiving van de systeemtijdzone.

  • SYSDATETIME, SYSUTCDATETIMEen SYSDATETIMEOFFSET kan worden toegewezen aan een variabele van een van de datum- en tijdtypen.

Zie Datum- en tijdgegevenstypen en -functies voor een overzicht van alle Transact-SQL datum- en tijdgegevenstypen en -functies.

Transact-SQL syntaxis-conventies

Syntax

SYSUTCDATETIME ( )

Retourtypen

datetime2

Remarks

Transact-SQL instructies kunnen overal verwijzen SYSUTCDATETIME naar een datum/tijd2-expressie .

SYSUTCDATETIME is een niet-deterministische functie. Weergaven en expressies die naar deze functie in een kolom verwijzen, kunnen niet worden geïndexeerd.

Note

SQL Server haalt de datum- en tijdwaarden op met behulp van de GetSystemTimeAsFileTime() Windows-API. De nauwkeurigheid is afhankelijk van de computerhardware en -versie van Windows waarop het exemplaar van SQL Server wordt uitgevoerd. De precisie van deze API is opgelost op 100 nanoseconden. De nauwkeurigheid kan worden bepaald met behulp van de GetSystemTimeAdjustment() Windows-API.

Examples

In de volgende voorbeelden worden de zes SQL Server-systeemfuncties gebruikt die de huidige datum en tijd retourneren om de datum, tijd of beide te retourneren. De waarden worden geretourneerd in reeksen; daarom kunnen de fractionele seconden anders zijn.

A. De notaties weergeven die worden geretourneerd door de datum- en tijdfuncties

In het volgende voorbeeld ziet u de verschillende indelingen die worden geretourneerd door de datum- en tijdfuncties.

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

Hier is het resultatenoverzicht.

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

B. Datum en tijd converteren naar datum

In het volgende voorbeeld ziet u hoe u datum- en tijdwaarden converteert naar het gegevenstype Datum .

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

Hier is het resultatenoverzicht.

2025-10-20
2025-10-20
2025-10-20
2025-10-20
2025-10-20
2025-10-20

C. Datum- en tijdwaarden converteren naar tijd

In het volgende voorbeeld ziet u hoe u datum- en tijdwaarden converteert naar het gegevenstype Tijd .

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

Hier is het resultatenoverzicht.

Time             Date Time
13:49:33.6330000 2025-10-20 13:49:33.633