Fonctions WeekNum et ISOWeekNum
S’applique à :
Applications canevas Applications pilotées par modèle Power Pages Dataverse Colonnes de formule
Retourne le numéro de la semaine pour une date spécifique.
Description
Utilisez les fonctions WeekNum et ISOWeekNum pour déterminer le numéro de semaine d’une date.
Ces fonctions diffèrent dans la façon dont elles déterminent la première semaine de l’année (semaine 1) :
WeekNum utilise la semaine contenant le 1er janvier comme première semaine de l’année. Le résultat de cette fonction peut aller de 1 à 54.
ISOWeekNum utilise la semaine contenant le premier jeudi de l’année comme première semaine de l’année. Cela suit la Définition standard de date et d’heure ISO 8601 pour la numérotation des semaines. Le résultat de cette fonction peut aller de 1 à 53. Il est possible que 52 ou 53 puissent être retournés pour les premiers jours de janvier puisque les dates pourraient appartenir à la dernière semaine de l’année précédente.
Utilisez le deuxième paramètre pour WeekNum pour spécifier quel jour commence une semaine. Vous pouvez fournir un numéro de code Excel ou utiliser l’énumération StartOfWeek :
| Code Excel | Énumération StartOfWeek | Description |
|---|---|---|
| 1, 17 | Début de la semaine.dimanche | La semaine commence le dimanche. Par défaut. |
| 2, 11 | Début de la semaine.lundi | La semaine commence le lundi. |
| 12 | Début de la semaine.mardi | La semaine commence le mardi. |
| 13 | Début de la semaine.mercredi | La semaine commence le mercredi. |
| 14 | Début de la semaine.jeudi | La semaine commence le jeudi. |
| 15 | Début de la semaine.vendredi | La semaine commence le vendredi. |
| 16 | Début de la semaine.samedi | La semaine commence le samedi. |
ISOWeekNum utilise toujours le lundi comme début de semaine. Dans Excel, la fonction WeekNum prend en charge un code supplémentaire 21 qui n’est pas pris en charge ici ; utilisez plutôt ISOWeekNum.
Si vous transmettez un nombre unique à ces fonctions, la valeur renvoyée est un résultat unique. Si vous transmettez une table à une seule colonne qui contient des nombres, la valeur renvoyée est une table de résultats à une seule colonne, avec un résultat pour chaque enregistrement dans la table de l’argument. Si vous avez une table à plusieurs colonnes, vous pouvez la convertir en table à une seule colonne, comme Utilisation des tables le décrit.
Syntaxe
Numéro de semaine(DateHeure [, Début de la semaine ])
- DateTime - Obligatoire. Valeur de date/heure à utiliser.
- StartOfWeek - Facultatif. Code Excel ou énumération StartOfWeek qui détermine le jour de début de la semaine.
ISOWeekNum(DateTime)
- DateTime - Obligatoire. Valeur de date/heure à utiliser. La semaine commence toujours le lundi.
Exemples
Première et dernière semaines calendaires de 2021
| Date | WeekNum( Date ) | ISOWeekNum( Date ) | WeekNum( Date, StartOfWeek.Wednesday ) |
|---|---|---|---|
| Vendredi1erjanvier2021 | 1 | 53 | 1 |
| Samedi2janvier2021 | 1 | 53 | 1 |
| Dimanche3janvier2021 | 2 | 53 | 1 |
| Lundi4septembre2021 | 2 | 1 | 1 |
| Mardi5janvier2021 | 2 | 1 | 1 |
| Mercredi6janvier2021 | 2 | 1 | 2 |
| Jeudi7janvier2021 | 2 | 1 | 2 |
| Samedi25décembre2021 | 52 | 51 | 52 |
| Dimanche26décembre2021 | 53 | 51 | 52 |
| Lundi27décembre2021 | 53 | 52 | 52 |
| Mardi28décembre2021 | 53 | 52 | 52 |
| Mercredi29décembre2021 | 53 | 52 | 53 |
| Jeudi30décembre2021 | 53 | 52 | 53 |
| Vendredi31décembre2021 | 53 | 52 | 53 |