Partager via

Fonctions WeekNum et ISOWeekNum

  • Article

S’applique à : applications canevas Applications pilotées par modèle Power Pages Dataverse formule colonnes

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 StartOfWeek.Sunday La semaine commence le dimanche. Par défaut.
2, 11 StartOfWeek.Monday La semaine commence le lundi.
12 StartOfWeek.Tuesday La semaine commence le mardi.
13 StartOfWeek.Wednesday La semaine commence le mercredi.
14 StartOfWeek.Thursday La semaine commence le jeudi.
15 StartOfWeek.Friday La semaine commence le vendredi.
16 StartOfWeek.Saturday 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

WeekNum(DateTime [, StartOfWeek ])

  • DateHeure : 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)

  • DateHeure : 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