De functies WeekNum en ISOWeekNum
Van toepassing op:
Canvas-apps Modelgestuurde apps Dataverse-formulekolommen
Retourneert het weeknummer van een bepaalde datum.
Omschrijving
Gebruik de functies WeekNum en ISOWeekNum om het weeknummer van een datum te bepalen.
Deze functies verschillen in hoe ze de eerste week van het jaar (week 1) bepalen:
WeekNum gebruikt de week met 1 januari als de eerste week van het jaar. Het resultaat van deze functie kan variëren van 1 tot 54.
ISOWeekNum gebruikt de week met de eerste donderdag van het jaar als de eerste week van het jaar. Hierbij wordt de ISO 8601-standaarddefinitie voor datum en tijd voor weeknummering gevolgd. Het resultaat van deze functie kan variëren van 1 tot 53. Het is mogelijk dat 52 of 53 voor de eerste dagen van januari wordt geretourneerd, omdat de datums tot de laatste week van het voorgaande jaar kunnen behoren.
Gebruik de tweede parameter voor WeekNum om op te geven op welke dag een week begint. U kunt een Excel-codenummer opgeven of de StartOfWeek-opsomming gebruiken:
| Excel-code | Opsomming BeginVanWeek | Beschrijving |
|---|---|---|
| 1, 17 | BeginVanWeek.Zondag | Week begint op zondag. Standaard. |
| 2, 11 | BeginVanWeek.Maandag | Week begint op maandag. |
| 12 | BeginVanWeek.Dinsdag | Week begint op dinsdag. |
| 13 | BeginVanWeek.Woensdag | Week begint op woensdag. |
| 14 | BeginVanWeek.Donderdag | Week begint op donderdag. |
| 15 | BeginVanWeek.Vrijdag | Week begint op vrijdag. |
| 16 | BeginVanWeek.Zaterdag | Week begint op zaterdag. |
ISOWeekNum gebruikt altijd maandag als het begin van de week. In Excel ondersteunt de functie WeekNum een optelcode 21 die hier niet wordt ondersteund; gebruik in plaats daarvan ISOWeekNum.
Als u één getal doorgeeft aan deze functies, is de resulterende waarde één resultaat. Als u een tabel met één kolom doorgeeft die getallen bevat, is de geretourneerde waarde een tabel met één kolom met resultaten (één resultaat voor elke record in de tabel voor het argument). Als u een tabel met meerdere kolommen hebt, kunt u deze omvormen tot een tabel met één kolom, zoals wordt beschreven in werken met tabellen.
Syntaxis
WeekNum(DateTime [, StartOfWeek ])
- DateTime: vereist. De datum/tijd-waarde waarop de bewerking wordt toegepast.
- StartOfWeek: optioneel. Excel-code of StartOfWeek-opsomming die bepaalt op welke dag de week begint.
ISOWeekNum(DateTime)
- DateTime: vereist. De datum/tijd-waarde waarop de bewerking wordt toegepast. De week begint altijd op maandag.
Voorbeelden
Eerste en laatste kalenderweken van 2021
| Datum | WeekNum( Date ) | ISOWeekNum( Date ) | WeekNum( Date, StartOfWeek.Wednesday ) |
|---|---|---|---|
| Vrijdag,1januari,2021 | 0 | 53 | 0 |
| Zaterdag,2januari,2021 | 0 | 53 | 0 |
| Zondag,3januari,2021 | 2 | 53 | 0 |
| Maandag,4januari,2021 | 2 | 0 | 0 |
| Dinsdag,5januari,2021 | 2 | 0 | 0 |
| Woensdag,6januari,2021 | 2 | 0 | 2 |
| Donderdag,7januari,2021 | 2 | 0 | 2 |
| Zaterdag,25december,2021 | 52 | 51 | 52 |
| Zondag,26december,2021 | 53 | 51 | 52 |
| Maandag,27december,2021 | 53 | 52 | 52 |
| Dinsdag,28december,2021 | 53 | 52 | 52 |
| Woensdag,29december,2021 | 53 | 52 | 53 |
| Donderdag,30december,2021 | 53 | 52 | 53 |
| Vrijdag,31december,2021 | 53 | 52 | 53 |