DATEFROMPARTS (Transact-SQL)

  • Article

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

Cette fonction retourne une valeur date qui est mappée aux valeurs de jour, de mois et d’année.

Conventions de la syntaxe Transact-SQL

Syntaxe

DATEFROMPARTS ( year, month, day )

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

year
Expression entière qui spécifie une année.

month
Expression entière qui spécifie un mois, entre 1 et 12.

day
Expression entière qui spécifie un jour.

Types de retour

date

Notes

DATEFROMPARTS retourne une valeur date, avec la partie date définie sur l’année, le mois et le jour spécifiés, et la partie heure définie avec la valeur par défaut. Pour les arguments non valides, DATEFROMPARTS génère une erreur. DATEFROMPARTS retourne une valeur Null si au moins un argument obligatoire a une valeur Null.

Cette fonction peut gérer la communication à distance vers des serveurs SQL Server 2012 (11.x) et versions ultérieures. Il ne peut pas gérer la communication à distance vers des serveurs avec une version antérieure à SQL Server 2012 (11.x).

Exemples

L’exemple suivant montre la fonction DATEFROMPARTS en action.

SELECT DATEFROMPARTS ( 2010, 12, 31 ) AS Result;

Voici le jeu de résultats obtenu.

Result  
----------------------------------  
2010-12-31  
  
(1 row(s) affected)

Voir aussi

date (Transact-SQL)