Fonctions Day, Month, Year, Hour, Minute, Second et Weekday
S'applique à :
Applications Canvas Colonnes de formule Dataverse Flux de bureau Applications pilotées par modèle CLI Power Platform
Retourne les composants individuels d’une valeur de date/heure.
Description
La fonction Day retourne le composant de jour d’une valeur de date/heure compris entre 1 et 31.
La fonction Month retourne le composant de mois d’une valeur de date/heure compris entre 1 et 12.
La fonction Year retourne le composant d’année d’une valeur de date/heure à partir de 1900.
La fonction Hour retourne le composant d’heure d’une valeur de date/heure compris entre 0 (00:00) et 23 (23:00).
La fonction Minute retourne le composant de minute d’une valeur de date/heure compris entre 0 et 59.
La fonction Second retourne le composant de seconde d’une valeur de date/heure compris entre 0 et 59.
La fonction Weekday retourne le jour de la semaine d’une valeur de date/heure. Par défaut, le résultat est compris entre 1 (dimanche) et 7 (samedi). Vous pouvez spécifier une plage différente avec un code de fonction Weekday dans Microsoft Excel ou une valeur d’énumération StartOfWeek :
| Code Excel | Énumération StartOfWeek | Description |
|---|---|---|
| 1, 17 | StartOfWeek.Sunday | Nombres 1 (dimanche) à 7 (samedi). Par défaut. |
| 2, 11 | StartOfWeek.Monday | Nombres 1 (lundi) à 7 (dimanche). |
| 3 | StartOfWeek.MondayZero | Nombres 0 (lundi) à 6 (dimanche). |
| 12 | StartOfWeek.Tuesday | Nombres 1 (mardi) à 7 (lundi). |
| 13 | StartOfWeek.Wednesday | Nombres 1 (mercredi) à 7 (mardi). |
| 14 | StartOfWeek.Thursday | Nombres 1 (jeudi) à 7 (mercredi). |
| 15 | StartOfWeek.Friday | Nombres 1 (vendredi) à 7 (jeudi). |
| 16 | StartOfWeek.Saturday | Nombres 1 (samedi) à 7 (vendredi). |
Toutes les fonctions retournent un nombre.
Pour plus d’informations, voir Utilisation des dates et heures.
Syntaxe
Day( DateTime )
Month( DateTime )
Year( DateTime )
Hour( DateTime )
Minute( DateTime )
Second( DateTime )
- DateHeure : obligatoire. Valeur de date/heure à utiliser.
Weekday( DateTime [, WeekdayFirst ] )
- DateHeure : obligatoire. Valeur de date/heure à utiliser.
- WeekdayFirst : facultatif. Code Excel spécifiant le premier jour de la semaine. S’il n’est pas spécifié, la valeur 1 (dimanche en premier) est utilisée.
Exemples
Dans l’exemple suivant, l’heure actuelle est 15:59:37 et la date actuelle est le jeudi 9 avril 2015.
| Formule | Description | Résultat |
|---|---|---|
| Year( Now() ) | Retourne le composant d’année de la date et de l’heure actuelles. | 2015 |
| Month( Now() ) | Retourne le composant de mois de la date et de l’heure actuelles. | 4 |
| Day( Now() ) | Retourne le composant de jour de la date et de l’heure actuelles. | 9 |
| Hour( Now() ) | Retourne le composant d’heure de la date et de l’heure actuelles. | 15 |
| Minute( Now() ) | Retourne le composant de minute de la date et de l’heure actuelles. | 59 |
| Second( Now() ) | Retourne le composant de seconde de la date et de l’heure actuelles. | 37 |
| Weekday( Now() ) | Retourne le composant de jour de la semaine de la date et de l’heure actuelles en utilisant le dimanche comme premier jour de la semaine. | 5 |
| Weekday( Now(), 14 ) | Retourne le composant de jour de la semaine de la date et de l’heure actuelles en utilisant un code Excel pour spécifier le jeudi comme premier jour de la semaine. | 1 |
| Weekday( Now(), StartOfWeek.Wednesday ) | Retourne le composant de jour de la semaine de la date et de l’heure actuelles en utilisant l’énumération StartOfWeek pour spécifier le mercredi comme premier jour de la semaine. | 2 |