WEEKNUM

Gibt die Wochenzahl für das angegebene Datum und Jahr entsprechend dem Wert return_type zurück. Die Wochenzahl gibt an, wo die Woche innerhalb eines Jahres numerisch ist.

Für diese Funktion werden zwei Systeme verwendet:

  • System 1: Die Woche, die den 1. Januar enthält, ist die erste Woche des Jahres und wird als Woche 1 nummeriert.
  • System 2: Die Woche, die den ersten Donnerstag des Jahres enthält, ist die erste Woche des Jahres und wird als Woche 1 nummeriert. Dieses System entspricht der in ISO 8601 spezifizierten Methode, welche im Allgemeinen als europäisches Wochennummerierungssystem bezeichnet wird.

Syntax

WEEKNUM(<date>[, <return_type>])  

Parameter

Begriff Definition
Datum Das Datum im datetime-Format
return_type (Optional) Eine Zahl, mit der festgelegt wird, an welchem Tag eine Woche beginnt. Der Standardwert ist 1. Siehe Hinweise.

Rückgabewert

Eine ganze Zahl

Bemerkungen

  • Standardmäßig verwendet die WEEKNUM-Funktion eine Kalenderkonvention, bei der die Woche mit dem 1. Januar als die erste Woche des Jahres betrachtet wird. Die in Europa weit verbreitete Kalendernorm ISO 8601 definiert jedoch die erste Woche als diejenige, bei der die Mehrheit der Tage (vier oder mehr) in das neue Jahr fällt. Dies bedeutet Folgendes: Wenn return_type ein beliebiger gültiger Wert mit Ausnahme von 21 ist, gibt die WEEKNUM-Funktion für Jahre mit drei oder weniger Tagen in der ersten Januarwoche Wochenzahlen zurück, die sich von der ISO 8601-Definition unterscheiden.

  • Für return_type werden mit Ausnahme von 21 die folgenden gültigen Werte von einigen DirectQuery-Datenquellen möglicherweise nicht unterstützt:

    return_type Wochenbeginn System
    1 oder nicht angegeben Sonntag 1
    2 Montag 1
    11 Montag 1
    12 Tuesday 1
    13 Wednesday 1
    14 Thursday 1
    15 Freitag 1
    16 Samstag 1
    17 Sonntag 1
    21 Montag 2

Beispiel 1

Das folgende Beispiel gibt die Wochenzahl für den 14. Februar 2010 zurück. Bei dieser Berechnung wird davon ausgegangen, dass die Woche am Montag beginnt.

= WEEKNUM("Feb 14, 2010", 2) 

Beispiel 2

Das folgende Beispiel gibt die Wochennummer des in der Spalte HireDate gespeicherten Datums aus der Tabelle Employees (Mitarbeiter) zurück. Bei dieser Berechnung wird davon ausgegangen, dass die Woche am Sonntag beginnt.

= WEEKNUM('Employees'[HireDate])

YEARFRAC-Funktion
WEEKDAY-Funktion