CURRENT_DATE (Transact-SQL)

Gilt für: Azure SQL-Datenbank Azure SQL Managed Instance

In Azure SQL-Datenbank und Azure SQL verwaltete Instanz gibt diese Funktion das aktuelle Datenbanksystemdatum als Datumswert zurück, ohne dass die Datenbankzeit und der Zeitzonenoffset versetzt werden. CURRENT_DATEleitet diesen Wert vom zugrunde liegenden Betriebssystem auf dem Datenbank-Engine ab.

Hinweis

SYSDATETIME und SYSUTCDATE haben, weil sie in Sekundenbruchteilen gemessen werden, eine höhere Genauigkeit als GETDATE und GETUTCDATE. Die SYSDATETIMEOFFSET-Funktion berücksichtigt den Zeitzonenoffset des Systems. Sie können SYSDATETIME, SYSUTCDATETIME und SYSDATETIMEOFFSET einer Variablen zuweisen, die einen der Datums- und Uhrzeittypen hat.

Diese Funktion ist die ANSI SQL-Entsprechung zu CAST(GETDATE() AS DATE). Weitere Informationen finden Sie unter GETDATE.

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

Transact-SQL-Syntaxkonventionen

Syntax

nur Azure SQL-Datenbank und Azure SQL verwaltete Instanz:

CURRENT_DATE

Argumente

Diese Funktion akzeptiert keine Argumente.

Rückgabetypen

date

Hinweise

Transact-SQL-Anweisungen können an beliebiger Stelle auf CURRENT_DATE einen Datumsausdruck verweisen.

CURRENT_DATE ist eine nichtdeterministische Funktion. Ansichten und Ausdrücke, die auf diese Spalte verweisen, können nicht indiziert werden.

Beispiele

In diesen Beispielen werden die Systemfunktionen verwendet, die aktuelle Datums- und Uhrzeitwerte zurückgeben, um das Datum, die Uhrzeit oder beides zurückzugeben. In den Beispielen werden die Werte der Reihe nach zurückgegeben, sodass sich deren Sekundenbruchteile unterscheiden können. Die zurückgegebenen tatsächlichen Werte entsprechen dem tatsächlichen Tag/der Ausführungszeit.

A. Abrufen des aktuellen Systemdatums und der aktuellen Systemzeit

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

Hinweis

CURRENT_DATE (Transact-SQL) ist nur in Azure SQL-Datenbank und Azure SQL verwaltete Instanz verfügbar.

Hier sehen Sie das Ergebnis.

Datentyp Wert
SYSDATETIME() 2024-06-26 14:04:21.6172014
SYSDATETIMEOFFSET() 2024-06-26 14:04:21.6172014 -05:00
SYSUTCDATETIME() 2024-06-26 19:04:21.6172014
CURRENT_TIMESTAMP 2024-06-26 14:04:21.617
GETDATE() 2024-06-26 14:04:21.617
GETUTCDATE() 2024-06-26 19:04:21.617
CURRENT_DATE 2024-06-26

B. Abrufen des aktuellen Systemdatums

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

Hinweis

CURRENT_DATE (Transact-SQL) ist nur in Azure SQL-Datenbank und Azure SQL verwaltete Instanz verfügbar.

Hier sehen Sie das Ergebnis.

Datentyp Wert
SYSDATETIME() 2024-06-26
SYSDATETIMEOFFSET() 2024-06-26
SYSUTCDATETIME() 2024-06-26
CURRENT_TIMESTAMP 2024-06-26
GETDATE() 2024-06-26
GETUTCDATE() 2024-06-26
CURRENT_DATE 2024-06-26