EOMONTH (Transact-SQL)

  • Article

Retourne le dernier jour du mois qui contient la date spécifiée, avec un décalage facultatif.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

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 cet argument est spécifié, EOMONTH ajoute le nombre spécifié de mois à start_date, puis retourne le dernier jour du mois de la date résultante. Si cet addition dépasse la plage de dates valide, une erreur est générée.

Type de retour

date

Notes

Cette fonction peut être exécutée à distance sur des serveurs SQL Server 2012 et les versions ultérieures. Elle ne peut pas être exécutée à distance sur des serveurs d'une version antérieure à SQL Server 2012.

Exemples

A.EOMONTH avec type datetime explicite

DECLARE @date DATETIME
SET @date = '12/1/2011'
SELECT EOMONTH ( @date ) AS Result
GO

Voici l'ensemble des résultats.

Result
------------
2011-12-31

(1 row(s) affected)

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

DECLARE @date VARCHAR(255)
SET @date = '12/1/2011'
SELECT EOMONTH ( @date ) AS Result
GO

Voici l'ensemble des résultats.

Result
------------
2011-12-31

(1 row(s) affected)

C.EOMONTH avec et sans le paramètre month_to_add

DECLARE @date DATETIME
SET @date = GETDATE()
SELECT EOMONTH ( @date ) AS 'This Month'
SELECT EOMONTH ( @date, 1 ) AS 'Next Month'
SELECT EOMONTH ( @date, -1 ) AS 'Last Month'
GO

Voici l'ensemble des résultats.

This Month
-----------------------
2011-12-31

(1 row(s) affected)

Next Month
-----------------------
2012-01-31

(1 row(s) affected)

Last Month
-----------------------
2011-11-30

(1 row(s) affected)