Partager via


WeekNum et ISOWeekNum fonctions

Fonction S’applique à
ISOWeekNum Colonnes de formule Dataverse d’applications canevas - Applications Power Pages basées sur des modèles
WeekNum Les applications Canvas Copilot Studio Desktop circulent des colonnes de formule Dataverse basées sur des modèles d’applications Power Platform CLI Dataverse functions Power Pages

Retourne le numéro de la semaine pour une date spécifique.

Description

Utilisez les fonctions et ISOWeekNum les WeekNum fonctions 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 spécifier le jour qui commence par 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 lundi comme début de semaine. Dans Excel, la WeekNum fonction prend en charge un code d’ajout 21 qui n’est pas pris en charge ici ; utilisez ISOWeekNum à la place.

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

  • 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