Fonctions Date, DateTime et Time

S’applique à : Applications canevas Flux de bureau Applications pilotées par modèle CLI Power Platform

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

Description

La fonction Date convertit les valeurs d’année, de mois et de jour individuelles en valeur de date/heure. 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 fonction Time convertit les valeurs Heure, Minute, Seconde et éventuellement Milliseconde individuelles en valeur Date/Heure. Le résultat n’est pas associé à une date.

La fonction DateTime combine les fonctions Date et Time en une seule fonction, en prenant à la fois les arguments de date et d’heure et en renvoyant une valeur Date/Heure comportant à 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( Year, Month, Day )

• Year : 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).
• Month : obligatoire. Nombre compris entre 1 et 12.
• Day : obligatoire. Nombre compris entre 1 et 31.

Time( Hour, Minute, Second [, Milliseconds ] )

• Hour : 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.
• Second : obligatoire. Nombre de secondes, généralement compris entre 0 et 59.
• Milliseconds : facultatif. Nombre de millisecondes, généralement compris entre 0 et 999.

DateTime( Year, Month, Day, Hour, Minute, Second [, Milliseconds ] )

• Year : 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).
• Month : obligatoire. Nombre compris entre 1 et 12.
• Day : obligatoire. Nombre compris entre 1 et 31.
• Hour : 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.
• Second : obligatoire. Nombre de secondes, généralement compris entre 0 et 59.
• Milliseconds : 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) )

Heure

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" 
)

DateHeure

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"
)