SYSUTCDATETIME (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSQL Analytics-eindpunt in Microsoft FabricMagazijn in Microsoft FabricSQL-database in Microsoft Fabric

De SYSUTCDATETIME Transact-SQL (T-SQL)-functie geeft een datetime2-waarde terug die de datum en tijd bevat van de computer waarop de instantie van SQL Server draait. 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(),
       SYSDATETIMEOFFSET(),
       SYSUTCDATETIME(),
       CURRENT_TIMESTAMP,
       GETDATE(),
       GETUTCDATE(),
       CURRENT_DATE;

Hier is het resultatenoverzicht.

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. 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()),
       CURRENT_DATE;

Hier is het resultatenoverzicht.

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. Datum- en tijdwaarden converteren naar tijd

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

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

Hier is het resultatenoverzicht.

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

Verwante inhoud

  • Last updated on