MONTH (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Renvoie un entier représentant le mois de la date spécifiée.

Pour obtenir une vue d’ensemble de tous les types de données et fonctions de date et d’heure Transact-SQL, consultez Types de données et fonctions de date et d’heure (Transact-SQL).

Conventions de la syntaxe Transact-SQL

Syntaxe

MONTH ( date )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

date
Expression qui peut être résolue en valeur time, date, smalldatetime, datetime, datetime2 ou datetimeoffset. L’argument date peut être une expression, une expression de colonne, une variable définie par l’utilisateur ou un littéral de chaîne.

Type de retour

int

Valeur de retour

MONTH renvoie la même valeur que DATEPART (month, date).

Si date contient uniquement une partie heure, la valeur renvoyée est 1, le mois de base.

Exemples

L'instruction suivante retourne 4. Il s'agit du numéro du mois.

SELECT MONTH('2007-04-30T01:01:01.1234567 -07:00');

L'instruction suivante retourne 1900, 1, 1. L’argument pour date est le chiffre 0. SQL Server interprète 0 comme le 1er janvier 1900.

SELECT YEAR(0), MONTH(0), DAY(0);

Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)

L’exemple suivant renvoie 4. Il s'agit du numéro du mois.

-- Uses AdventureWorks  
  
SELECT TOP 1 MONTH('2007-04-30T01:01:01.1234')   
FROM dbo.DimCustomer;

L’exemple suivant renvoie 1900, 1, 1. L’argument pour date est le chiffre 0. SQL Server interprète 0 comme le 1er janvier 1900.

-- Uses AdventureWorks  
  
SELECT TOP 1 YEAR(0), MONTH(0), DAY(0) FROM dbo.DimCustomer;

Voir aussi

CAST et CONVERT (Transact-SQL)