Date, DateTimeet Time fonctions

S’applique à : Les applications Canvas Copilot Studio Desktop circulent des applications basées sur des modèles power Platform CLI Dataverse functions Power Pages

Convertissent les composants de date et d’heure en valeur de date/heure.

Description

La Date fonction convertit les valeurs Year, Month et Day individuelles en Datevaleurs /Time value. La partie heure correspond à minuit.

• Si la valeur d’année est comprise entre 0 et 1899 (inclus), la fonction ajoute cette valeur à 1900 pour calculer l’année. 70 devient 1970.
• Si la valeur de mois est inférieure à 1 ou supérieure à 12, le résultat soustrait ce nombre de mois du début de l’année spécifiée ou l’y ajoute.
• Si la valeur de jour est supérieure au nombre de jours du mois spécifié, la fonction ajoute ce nombre de jours au premier jour du mois et renvoie la date correspondante d’un mois ultérieur. Si la valeur de jour est inférieure à 1, la fonction soustrait ce nombre de jours, plus 1, du premier jour du mois spécifié.

La Time fonction convertit les valeurs d’heure, de minute, de seconde et éventuellement de millisecondes en valeur Date/Time valeur. Le résultat n’est pas associé à une date.

La DateTime fonction combine les fonctions et Time les Date fonctions en une seule fonction, en prenant à la fois les arguments de date et d’heure et en retournant une Date/Timevaleur qui a à la fois des composants de date et d’heure.

Pour savoir comment convertir une chaîne en valeur, reportez-vous aux fonctions DateValue, TimeValue et DateTimeValue.

Pour plus d’informations, consultez également Utilisation des dates et heures.

Syntaxe

Date( Année, Mois, Jour )

• Année - Obligatoire. Les nombres supérieurs à 1899 sont interprétés comme des nombres absolus (1980 est interprété comme 1980) ; les nombres compris entre 0 et 1899 sont interprétés comme étant relatifs à 1900 (par exemple, 80 est interprété comme 1980).
• Mois - Obligatoire. Nombre compris entre 1 et 12.
• Jour - Obligatoire. Nombre compris entre 1 et 31.

Time( Heure, Minute, Seconde [, Millisecondes ] )

• Heure - Obligatoire. Nombre d’heures, généralement compris entre 0 (00h00) et 23 (23h00).
• Minute - Obligatoire. Nombre de minutes, généralement compris entre 0 et 59.
• Deuxième - Obligatoire. Nombre de secondes, généralement compris entre 0 et 59.
• Millisecondes - Facultatif. Nombre de millisecondes, généralement compris entre 0 et 999.

DateTime( Année, Mois, Jour, Heure, Minute, Seconde [, Millisecondes ] )

• Année - Obligatoire. Les nombres supérieurs à 1899 sont interprétés comme des nombres absolus (1980 est interprété comme 1980) ; les nombres compris entre 0 et 1899 sont interprétés comme étant relatifs à 1900 (par exemple, 80 est interprété comme 1980).
• Mois - Obligatoire. Nombre compris entre 1 et 12.
• Jour - Obligatoire. Nombre compris entre 1 et 31.
• Heure - Obligatoire. Nombre d’heures, généralement compris entre 0 (00h00) et 23 (23h00)
• Minute - Obligatoire. Nombre de minutes, généralement compris entre 0 et 59.
• Deuxième - Obligatoire. Nombre de secondes, généralement compris entre 0 et 59.
• Millisecondes - Facultatif. Nombre de millisecondes, généralement compris entre 0 et 999.

Examples

Date

Si un utilisateur a saisi

• 1979 dans un contrôle de saisie de texte nommé HireYear
• 3 dans un contrôle de saisie de texte nommé HireMonth
• 17 dans un contrôle de saisie de texte nommé HireDay

cette formule renverrait 3/17/1979 :

Date( Value(HireYear.Text), Value(HireMonth.Text), Value(HireDay.Text) )

Time

Si un utilisateur a saisi

• 14 dans un contrôle de saisie de texte nommé BirthHour
• 50 dans un contrôle de saisie de texte nommé BirthMinute
• 24 dans un contrôle de saisie de texte nommé BirthSecond

cette formule renverrait 02:50:24 P :

Text( 
    Time(Value(BirthHour.Text), Value(BirthMinute.Text), Value(BirthSecond.Text)), 
    "hh:mm:ss A/P" 
)

DateTime

Si un utilisateur a saisi

• 2023 dans un contrôle de saisie de texte nommé EclipseYear
• 10 dans un contrôle de saisie de texte nommé EclipseMonth
• 28 dans un contrôle de saisie de texte nommé EclipseDate
• 13 dans un contrôle de saisie de texte nommé EclipseHour
• 14 dans un contrôle de saisie de texte nommé EclipseMinute
• 5 dans un contrôle de saisie de texte nommé EclipseSecond
• 231 dans un contrôle de saisie de texte nommé EclipseMillisecond

cette formule renverrait 10/28/23 01:14:05.231 PM :

Text(
    DateTime(Value(EclipseYear.Text), Value(EclipseMonth.Text), Value(EclipseDate.Text), 
        Value(EclipseHour.Text), Value(EclipseMinute.Text), 
        Value(EclipseSecond.Text), Value(EclipseSecond.Millisecond)
    ), 
    "yy/mm/dd hh:mm:ss.000 AM/PM"
)