SYSDATETIME (Transact-SQL)

Gilt für:SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-InstanzAzure Synapse AnalyticsSQL-Analyseendpunkt in Microsoft FabricLagerhaus in Microsoft FabricSQL-Datenbank in Microsoft Fabric

Die SYSDATETIME Transact-SQL (T-SQL)-Funktion liefert einen datetime2(7)-Wert, der das Datum und die Uhrzeit des Computers enthält, auf dem die Instanz von SQL Server läuft.

Hinweis

SYSDATETIME und SYSUTCDATETIME haben mehr Sekundenpräzision als GETDATE und GETUTCDATE. SYSDATETIMEOFFSET enthält den Offset der Systemzeitzone. SYSDATETIME, SYSUTCDATETIME, und SYSDATETIMEOFFSET kann einer Variablen beliebiger Datums- und Uhrzeittypen zugewiesen werden.

Azure Synapse Analytics follows UTC. Verwenden Sie AT TIME ZONE in Azure Synapse Analytics, wenn Sie Datums- und Uhrzeitinformationen in einer Nicht-UTC-Zeitzone interpretieren müssen.

Hinweis

Azure SQL-Datenbank und SQL Database in Microsoft Fabric unterstützen die Änderung der Standardzeitzone von universeller koordinierter Zeit (UTC). Wenn Sie die Zeitzone auf Datenbank- oder Sitzungsebene ändern, gibt diese Funktion lokale Zeit basierend auf dem konfigurierten Zeitzonenwert zurück. Weitere Informationen finden ALTER DATABASE SCOPED CONFIGURATION Sie unter TIMESET ZONE.

Unter Datums- und Uhrzeitdatentypen und -funktionen finden Sie eine Übersicht über alle Transact-SQL-Datums- und Uhrzeitdatentypen und -funktionen.

Transact-SQL-Syntaxkonventionen

Syntax

SYSDATETIME ( )

Rückgabetypen

datetime2(7)

Bemerkungen

Transact-SQL Aussagen können sich überall beziehen, SYSDATETIME sie können sich auf einen Datetime2(7)- Ausdruck beziehen.

SYSDATETIME ist eine nicht deterministische Funktion. Du kannst keine Ansichten und Ausdrücke, die auf diese Funktion verweisen, in einer Spalte indexieren.

Hinweis

SQL Server erhält die Datums- und Uhrzeitwerte mithilfe der Windows-API GetSystemTimeAsFileTime(). Die Genauigkeit hängt von der Computerhardware und der Windows-Version ab, unter der die Instanz von SQL Server ausgeführt wird. Die Genauigkeit dieser API liegt bei 100 Nanosekunden. Du kannst die GetSystemTimeAdjustment() Windows API verwenden, um die Genauigkeit zu bestimmen.

Beispiele

In den folgenden Beispielen werden die sechs SQL Server-Systemfunktionen verwendet, die das aktuelle Datum, die aktuelle Uhrzeit oder beides zurückgeben. Die Werte werden der Reihe nach zurückgegeben und können sich daher in Bruchteilen von Sekunden unterscheiden.

In diesen Beispielen nehmen wir an, dass das aktuelle Datum der 30. April 2026 ist.

A. Abrufen des aktuellen Systemdatums und der aktuellen Systemzeit

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

Hier sehen Sie das Ergebnis.

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. Abrufen des aktuellen Systemdatums

Das folgende Beispiel zeigt, wie Datums- und Uhrzeitwerte in den Datentyp "Datum " konvertiert werden.

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

Hier sehen Sie das Ergebnis.

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. Abrufen der aktuellen Systemzeit

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

Hier sehen Sie das Ergebnis.

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

Beispiele: Azure Synapse Analytics

D. Abrufen des aktuellen Systemdatums und der aktuellen Systemzeit

SELECT SYSDATETIME();

Hier sehen Sie das Ergebnis.

--------------------------
4/30/2026 1:10:02 PM

Verwandte Inhalte

  • Last updated on