WeekNum- und ISOWeekNum-Funktionen
Gilt für:
Canvas-Apps Modellgesteuerte Apps Dataverse-Formelspalten
Gibt die Wochenzahl eines bestimmten Datum zurück.
Beschreibung
Verwenden Sie die WeekNum und ISOWeekNum-Funktionen zum Ermitteln der Wochennummer eines Datums.
Diese Funktionen unterscheiden sich darin, wie sie die erste Woche des Jahres (Woche 1) bestimmen:
WeekNum verwendet die Woche mit dem 1. Januar als erste Woche des Jahres. Das Ergebnis dieser Funktion kann zwischen 1 und 54 liegen.
ISOWeekNum verwendet die Woche, die den ersten Donnerstag des Jahres enthält, als erste Woche des Jahres. Dies folgt der ISO 8601-Standarddefinition für Datum und Uhrzeit für Wochennummerierung. Das Ergebnis dieser Funktion kann zwischen 1 und 53 liegen. Es ist möglich, dass 52 oder 53 für die ersten Januartage zurückgegeben werden, da die Daten zur letzten Woche des Vorjahres gehören könnten.
Verwenden Sie den zweiten Parameter bei WeekNum, um anzugeben, an welchem Tag eine Woche beginnt. Sie können entweder eine Excel-Codenummer angeben oder die StartOfWeek-Enumeration verwenden:
| Excel-Code | StartOfWeek-Enumeration | Beschreibung |
|---|---|---|
| 1, 17 | StartOfWeek.Sunday | Die Woche beginnt am Sonntag. Standard. |
| 2, 11 | StartOfWeek.Monday | Woche beginnt am Montag. |
| 12 | StartOfWeek.Tuesday | Woche beginnt am Dienstag. |
| 13 | StartOfWeek.Wednesday | Woche beginnt am Mittwoch. |
| 14 | StartOfWeek.Thursday | Woche beginnt am Donnerstag. |
| 15 | StartOfWeek.Friday | Woche beginnt am Freitag. |
| 16 | StartOfWeek.Saturday | Woche beginnt am Samstag. |
ISOWeekNum verwendet immer Montag als Wochenbeginn. In Excel unterstützt die WeekNum-Funktion einen Zusatzcode 21, der hier nicht unterstützt wird; verwenden Sie stattdessen ISOWeekNum.
Wenn Sie diesen Funktionen eine einzelne Zahl übergeben, ist der Rückgabewert ein einzelnes Ergebnis. Wenn Sie eine einspaltige Tabelle übergeben, die Zahlen enthält, ist der Rückgabewert eine einspaltige Tabelle mit Ergebnissen, ein Ergebnis für jeden Datensatz in der Argumenttabelle. Mehrspaltige Tabellen können in einspaltige Tabellen umgeformt werden, wie unter Arbeiten mit Tabellen beschrieben wird.
Syntax
WeekNum(DateTime [, StartOfWeek ])
- DateTime ‑ Erforderlich: Der zu verarbeitende Datum/Uhrzeit-Wert
- StartOfWeek – Optional. Excel-Code oder StartOfWeek-Enumeration, die bestimmt, an welchem Tag die Woche beginnt.
ISOWeekNum(DateTime)
- DateTime ‑ Erforderlich: Der zu verarbeitende Datum/Uhrzeit-Wert Die Woche beginnt immer am Montag.
Beispiele
Erste und letzte Kalenderwoche von 2021
| Datum | WeekNum( Datum ) | ISOWeekNum( Datum ) | WeekNum( Datum, StartOfWeek.Wednesday ) |
|---|---|---|---|
| Freitag,Januar1,2021 | 1 | 53 | 1 |
| Samstag,Januar2,2021 | 1 | 53 | 1 |
| Sonntag,Januar3,2021 | 2 | 53 | 1 |
| Montag,Januar4,2021 | 2 | 1 | 1 |
| Dienstag,Januar5,2021 | 2 | 1 | 1 |
| Mittwoch,Januar6,2021 | 2 | 1 | 2 |
| Donnerstag,Januar7,2021 | 2 | 1 | 2 |
| Samstag,Dezember25,2021 | 52 | 51 | 52 |
| Sonntag,Dezember26,2021 | 53 | 51 | 52 |
| Montag,Dezember27,2021 | 53 | 52 | 52 |
| Dienstag,Dezember28,2021 | 53 | 52 | 52 |
| Mittwoch,Dezember29,2021 | 53 | 52 | 53 |
| Donnerstag,Dezember30,2021 | 53 | 52 | 53 |
| Freitag,Dezember31,2021 | 53 | 52 | 53 |