DATETIME2FROMPARTS (Transact-SQL)

  • Article

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

Cette fonction retourne une valeur datetime2 pour les arguments de date et d’heure spécifiés. La valeur retournée a une précision spécifiée par l’argument de précision.

Conventions de la syntaxe Transact-SQL

Syntaxe

DATETIME2FROMPARTS ( year, month, day, hour, minute, seconds, fractions, precision )

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.

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

hour
Expression entière qui spécifie les heures.

minute
Expression entière qui spécifie les minutes.

secondes
Expression entière qui spécifie les secondes.

fractions
Expression entière qui spécifie une valeur de fraction de secondes.

precision
Expression entière qui spécifie la précision de la valeur datetime2 que DATETIME2FROMPARTS retourne.

Types de retour

datetime2(precision)

Remarques

DATETIME2FROMPARTS retourne une valeur datetime2 entièrement initialisée. DATETIME2FROMPARTS génère une erreur si au moins un argument obligatoire a une valeur non valide. DATETIME2FROMPARTS retourne une valeur Null si au moins un argument obligatoire a une valeur Null. Toutefois, si l’argument precision a une valeur Null, DATETIME2FROMPARTS génère une erreur.

L’argument fractions dépend de l’argument precision. Par exemple, pour la valeur precision 7, chaque fraction représente 100 nanosecondes ; pour la valeur precision 3, chaque fraction représente une milliseconde. Pour la valeur precision zéro, la valeur de fractions doit également être zéro ; sinon, DATETIME2FROMPARTS génère une erreur.

Cette fonction peut être exécutée à distance sur des serveurs SQL Server 2012 (11.x) et versions ultérieures. Elle ne peut pas être exécutée à distance sur des serveurs dont la version est antérieure à SQL Server 2012 (11.x).

Exemples

R. Exemple sans fractions de seconde

SELECT DATETIME2FROMPARTS ( 2010, 12, 31, 23, 59, 59, 0, 0 ) AS Result;

Voici le jeu de résultats obtenu.

Result  
---------------------------  
2010-12-31 23:59:59.0000000  
  
(1 row(s) affected)

B. Exemple avec fractions de seconde

L’exemple suivant illustre l’utilisation des paramètres fractions et precision :

  1. Quand fractions a la valeur 5 et precision la valeur 1, la valeur de fractions représente 5/10 de seconde.

  2. Quand fractions a la valeur 50 et precision la valeur 2, la valeur de fractions représente 50/100 de seconde.

  3. Quand fractions a la valeur 500 et precision la valeur 3, la valeur de fractions représente 500/1000 de seconde.

SELECT DATETIME2FROMPARTS ( 2011, 8, 15, 14, 23, 44, 5, 1 );  
SELECT DATETIME2FROMPARTS ( 2011, 8, 15, 14, 23, 44, 50, 2 );  
SELECT DATETIME2FROMPARTS ( 2011, 8, 15, 14, 23, 44, 500, 3 );  
GO

Voici le jeu de résultats obtenu.

----------------------  
2011-08-15 14:23:44.5  
  
(1 row(s) affected)  
  
----------------------  
2011-08-15 14:23:44.50  
  
(1 row(s) affected)  
  
----------------------  
2011-08-15 14:23:44.500  
  
(1 row(s) affected)

Voir aussi

datetime2 (Transact-SQL)