WeekNum

Syntaxe

Paramètres

Description

Cette fonction permet de retourner le numéro de semaine d'une date.

Remarques

• Retourne le numéro de semaine dans l'année : La fonction WeekNum permet d'obtenir le rang d'une semaine dans l'année civile à partir d'une date donnée. Par exemple, une date située en février peut renvoyer 6, indiquant qu'elle appartient à la sixième semaine de l'année. Cela facilite l'analyse temporelle de données.
• Le début de la semaine est personnalisable : Le second paramètre StartOfWeek permet de définir si la semaine commence le dimanche (1, par défaut) ou le lundi (2). Ce choix est important pour respecter les usages culturels ou professionnels (comme les normes ISO qui considèrent le lundi comme premier jour).
• Utile pour des regroupements par semaine : WeekNum est souvent utilisé pour regrouper des événements ou des enregistrements par semaine, ce qui est utile dans les tableaux de bord, rapports ou filtres dynamiques dans les applications Power Apps, comme pour afficher l'activité hebdomadaire.
• Pratique pour planifier ou suivre des tâches : La fonction est particulièrement utile dans des applications de gestion de projets, de ressources ou de planning, où les tâches ou événements doivent être organisés par numéro de semaine plutôt que par dates précises.
• La valeur retournée est un entier de 1 à 53 : Selon l'année et le jour de départ défini, la fonction retourne une valeur entière comprise entre 1 et 53. Il peut y avoir 53 semaines dans certaines années, notamment lorsque le 1er janvier tombe en fin de semaine.
• Peut être combinée avec Today() ou Now() : Pour obtenir la semaine actuelle, il suffit d'utiliser WeekNum(Today()). Cela permet d'ajuster des affichages ou comportements en fonction de la semaine en cours, par exemple pour générer un sommaire de la semaine ou afficher des messages spécifiques.
• Doit être utilisée avec prudence pour des comparaisons entre années : Le numéro de semaine seul n'identifie pas une période unique dans le temps. Par exemple, la semaine 10 de 2024 n'est pas équivalente à la semaine 10 de 2025. Il faut donc souvent le combiner avec l'année (Year(DateTime)) pour éviter les erreurs de logique.
• Idéale pour les calculs statistiques périodiques : WeekNum est un excellent outil pour réaliser des statistiques hebdomadaires, comme la moyenne de ventes par semaine, le taux de fréquentation ou d'incidents. Il contribue à produire des analyses temporelles structurées sans devoir manipuler directement des intervalles de dates.