EOMONTH (Transact-SQL)
Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Diese Funktion gibt den letzten Tag des Monats, der das angegebene Datum enthält, mit einer optionalen Abweichung zurück.
Tipp
In SQL Server 2022 (16.x) und höheren Versionen können Sie DATETRUNC verwenden, um den Anfang des Monats zu berechnen.
Transact-SQL-Syntaxkonventionen
Syntax
EOMONTH ( start_date [ , month_to_add ] )
Argumente
start_date
Ein Datumsausdruck, der das Datum angibt, für das der letzte Tag des Monats zurückgegeben werden soll.
month_to_add
Ein optionaler ganzzahliger Ausdruck, der die Anzahl der Monate angibt, die zu start_date hinzugefügt werden sollen.
Wenn das Argument month_to_add über einen Wert verfügt, fügt EOMONTH
die angegebene Anzahl von Monaten zu start_date hinzu und gibt dann den letzten Tag des Monats für das sich ergebende Datum zurück. Wenn diese Addition den gültigen Datumsbereich überläuft, EOMONTH
wird ein Fehler ausgelöst.
Rückgabetypen
date
Hinweise
Die EOMONTH
Funktion kann remote zu Instanzen mit SQL Server 2012 (11.x) und höheren Versionen führen. Es kann keine Remoteverbindung mit Instanzen mit einer Version vor SQL Server 2012 (11.x) herstellen.
Beispiele
A. EOMONTH mit explizitem datetime-Typ
DECLARE @date DATETIME = '12/1/2024';
SELECT EOMONTH(@date) AS Result;
GO
Hier sehen Sie das Ergebnis.
Result
------------
2024-12-31
B. EOMONTH mit Zeichenfolgenparameter und impliziter Konvertierung
DECLARE @date VARCHAR(255) = '12/1/2024';
SELECT EOMONTH(@date) AS Result;
GO
Hier sehen Sie das Ergebnis.
Result
------------
2024-12-31
C. EOMONTH mit und ohne den month_to_add-Parameter
Die in diesen Resultsets gezeigten Werte stellen ein Ausführungsdatum zwischen 12/01/2024
und 12/31/2024
einschließlich dar.
DECLARE @date DATETIME = '2024-12-31';
SELECT EOMONTH(@date) AS 'This Month';
SELECT EOMONTH(@date, 1) AS 'Next Month';
SELECT EOMONTH(@date, -1) AS 'Last Month';
GO
Hier sehen Sie das Ergebnis.
This Month
-----------------------
2024-12-31
Next Month
-----------------------
2025-01-31
Last Month
-----------------------
2024-11-30