Lire en anglais

Partager via

EOMONTH (Transact-SQL)

  • Article

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Cette fonction retourne le dernier jour du mois contenant une date spécifiée, avec un décalage facultatif.

Conseil

Dans SQL Server 2022 (16.x) et versions ultérieures, vous pouvez utiliser DATETRUNC pour calculer le début du mois.

Conventions de la syntaxe Transact-SQL

Syntaxe

syntaxsql 
EOMONTH ( start_date [ , month_to_add ] )

Arguments

start_date

Expression de date qui spécifie la date pour laquelle retourner le dernier jour du mois.

month_to_add

Expression entière facultative qui spécifie le nombre de mois à ajouter à start_date.

Si l’argument month_to_add a une valeur, EOMONTH ajoute le nombre spécifié de mois à start_date, puis retourne le dernier jour du mois de la date résultante. Si cet ajout dépasse la plage de dates valide, génère EOMONTH une erreur.

Types de retour

date

Notes

La EOMONTH fonction peut être distante des instances exécutant SQL Server 2012 (11.x) et versions ultérieures. Elle ne peut pas être distante des instances avec une version antérieure à SQL Server 2012 (11.x).

Exemples

R. EOMONTH avec type datetime explicite

SQL 
DECLARE @date DATETIME = '12/1/2024';

SELECT EOMONTH(@date) AS Result;
GO

Voici le jeu de résultats.

Output 
Result
------------
2024-12-31

B. EOMONTH avec paramètre de chaîne et conversion implicite

SQL 
DECLARE @date VARCHAR(255) = '12/1/2024';

SELECT EOMONTH(@date) AS Result;
GO

Voici le jeu de résultats.

Output 
Result
------------
2024-12-31

C. EOMONTH avec et sans le paramètre month_to_add

Les valeurs indiquées dans ces jeux de résultats reflètent une date d’exécution inclusivement entre le 12/01/2024 et le 12/31/2024.

SQL 
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

Voici le jeu de résultats.

Output 
This Month
-----------------------
2024-12-31

Next Month
-----------------------
2025-01-31

Last Month
-----------------------
2024-11-30

Contenu connexe