Dokumentation/Calc Funktionen/KALENDERWOCHE

    From The Document Foundation Wiki
    This page is a translated version of the page Documentation/Calc Functions/WEEKNUM and the translation is 100% complete.
    Other languages:


    Funktionsname:

    KALENDERWOCHE

    Kategorie:

    Datum und Zeit

    Zusammenfassung:

    Bestimmt die Kalenderwoche für das als Zeitstempel oder als Text mitgegebene Datum. Es existieren mehrere Nummerierungssysteme und daher hat KALENDERWOCHE ein Argument, um auszuwählen, wie Woche 1 des Jahres definiert ist und mit welchem Tag die Woche beginnt.

    Syntax:

    KALENDERWOCHE(Datum [; Modus])

    Rückgabewerte:

    Gibt eine Ganzzahl im Bereich [0, 53] zurück, was dem Wochentag des angegebenen Datums entspricht, kodiert in Übereinstimmung mit dem angegebenen Modus.

    Argumente:

    Datum ist das Datum (in Anführungszeichen) oder der Zeitstempel, ggf. aus einer Referenz auf eine Zelle, die als auszuwertendes Datum gelten soll.

    Modus ist eine Ganzzahl, die die erste Woche im Jahr definiert und den Wochenstart festlegt. Die möglichen Werte für den Modus und ihre Bedeutung sind in der folgenden Tabelle aufgelistet. In dieser Tabelle unterscheidet die Spalte Definition der Woche 1 zwischen zwei Methoden zur Auswahl der Woche 1 des Jahres – eine Methode definiert die Woche 1 als die Woche, mit dem 1. Januar, die zweite Methode definiert Woche 1 als die Woche mit dem ersten Donnerstag im Jahr. (Das ist die Methode, die von der ISO 8601 empfohlen wird). Falls er fehlt, ist der Standardwert für den Modus 1.

    Beschreibung des Moduses
    Modus Definition der Woche 1 Start der Woche
    1 1. Januar Sonntag
    2 1. Januar Montag
    11 1. Januar Montag
    12 1. Januar Dienstag
    13 1. Januar Mittwoch
    14 1. Januar Donnerstag
    15 1. Januar Freitag
    16 1. Januar Samstag
    17 1. Januar Sonntag
    21 Erster Donnerstag im Jahr Montag
    150 Erster Donnerstag im Jahr Montag
    • Falls Datum kein gültiges Datum ist, dann meldet KALENDERWOCHE einen #WERT!.
    • KALENDERWOCHE ignoriert alle Zeitkomponenten vom Datum.
    • Falls Modus nicht numerisch ist, dann meldet KALENDERWOCHE einen #WERT! Fehler.
    • Falls Modus keine Ganzzahl ist, dann verkürzt KALENDERWOCHE den Wert.
    • Falls (nach einer eventuellen Kürzung) Modus keiner der oben angeführten Möglichkeiten ist, meldet KALENDERWOCHE einen invalid argument error (Fehler:502).
    • Falls Kompatibilität zu Microsoft EXCEL wichtig für Ihre Tabelle ist, dann meiden Sie bitte den Modus 150, denn dieser steht zwar im ODF 1.2, wird aber von EXCEL nicht unterstützt.

    Zusätzliche Informationen:

    Allgemeine Informationen über die Datums- und Zeit-Funktionen in Calc

    Note pin.svg

    Anmerkung:
    Der Einfachheit halber werden die Informationen dieses Unterabschnittes auf allen Seiten der Funktionen in Calc wiederholt, die Funktionen aus der Kategorie Datum und Zeit bearbeiten.

    • Intern wird Datum/Zeit als Dezimalzahl verarbeitet. Das kommt ab und zu als Zeitstempel zum Ausdruck. Zum Beispiel entspricht der 08.02.2021, 12:00:00 dem Zeitstempel 44235,5. Der ganzzahlige Anteil des Zeitstempels (vor dem Dezimalpunkt) ist die Anzahl der Tage seit einem vordefinierten Startdatum. Der gebrochene Teil des Zeitstempels (nach dem Dezimalpunkt) ist die Tageszeit ausgedrückt als Teil des Tages. Zum Beispiel stellt 0,25 die Uhrzeit 06:00:00 und 0,75 die Uhrzeit 18:00:00 dar.
    • Calc nutzt den 30.12.1899 als Standard Startdatum (Tag 0). Unter Extras ▸ Optionen ▸ LibreOffice Calc ▸ Berechnen kann allerdings ein alternatives Startdatum eingestellt werden. Solange Sie aber keine speziellen Anforderungen an die Tabellenanwendungen haben, empfehlen wir keine Änderungen an dieser Einstellung vorzunehmen. Falls Sie Zellen mit Datums-Werten kopieren und in andere Tabellen einfügen, kontrollieren Sie, dass beide Dokumente das gleiche Startdatum verwenden, um unerwartete Änderungen an den Datumsanzeigen zu vermeiden.
    • Ein negativer Zeitstempel entspricht einem Datum vor dem Calc Startdatum. Calc berechnet alle Daten zurück bis zum 15.10.1582 unter Verwendung des Gregorianischen Kalenders für frühere Daten.
    • Ein Zeitstempel ist das selbe wie jede andere Zahl, außer wir entscheiden uns dazu, sie als Datum/Zeit darzustellen. Sie können eine Zahl in eine Zelle eingeben und dann die Formatierung der Zelle ein Datum/eine Zeit darstellen lassen. Sie können in eine Zelle auch ein Datum/eine Zeit eingeben und dann die Formatierung der Zelle auf einen Zeitstempel ändern.
    • Zur Klarstellung: die Beschreibungen der Calc Funktionen in dieser Wiki nutzen das Standard ISO 8601 Format für Datum und Zeit da dieses unabhängig von Ihren lokalen Einstellungen sein sollte. Der Standard Wert auf Ihrem Computer mag unterschiedlich dazu sein. Wenn Sie ein Datum als Teil einer Formel eingeben, können Schräg- oder Bindestriche als Trennzeichen im Datum als mathematische Operatoren gedeutet werden. Daher wird ein Datum in diesem Format nicht als Datum erkannt und führt zu fehlerhaften Berechnungen. Um ein Datum als Datum erkannt zu bekommen, nutzen Sie bitte die DATUM-Funktion oder platzieren Sie das Datum in Anführungsstrichen in der ISO 8601-Notation. Vermeiden Sie lokale Datums-Formate, die Fehler erzeugen können, falls das Dokument in einer anderen Lokalisierung geladen wird.
    • Zeit-Zonen Information wird in den Datum & Zeit Funktionen von Calc nicht verwendet.
    • Falls Sie zwei Ziffern in der Jahresangabe (zum Beispiel 21 statt 2021) angeben wollen, muss Calc wissen, ob Sie 1921 oder 2021 meinen. Gehen Sie zu Extras ▸ Optionen ▸ LibreOffice ▸ Allgemein, um sich den Jahrebereich, wie Calc zweistellige Jahresangeben interpretieren soll, anzeigen zu lassen bzw. zu ändern.
    • Calc nutzt Logik um zu entscheiden, wie Text behandelt werden soll, der als Operand in einer arithmetrischen Operation oder als Argument einer Funktion angegeben wird und stattdessen eine Zahl erwartet wird. In diesem Kontext ist unzweifelhafte Übertragung für ISO 8601 Daten und Zeiten in ihren erweiterten Formaten mit Trennzeichen möglich. Zum Beispiel gibt die einfache Formel =1 + "2021-02-08"das Ergebnis 2021-02-09 (sofern als Datum formatiert). Trotzdem kann diese Logik durch die Einstellung auf dem Dialog Detaillierte Einstellungen für Berechnungen beeinträchtigt werden. Dieser Dialog findet sich unter Extras ▸ Optionen ▸ LibreOffice Calc ▸ Formel hinter dem Button Details im Bereich Detaillierte Einstellungen für Berechnungen. Falls ein #WERT!-Fehler auftritt, kann das daran liegen, dass Fehler #WERT! berechnen ausgewählt wurde. In dem Fall sollte man mit den anderen selbsterklärenden Optionen im Drop-Down-Feld Konvertierung von Text in eine Zahl experimentieren.

    Beispiele:

    Formel Beschreibung Ergebnis
    =KALENDERWOCHE("2021-01-01") Die Funktion gibt 1 zurück. Da für den Modus nichts angegeben ist, greift der Standardwert 1. Wenn Modus 1 ist, ist der 1. Januar defintiv in Woche 1. 1
    =KALENDERWOCHE("2021-01-03"; 1) Die Funktion gibt 2 zurück. Wenn der Modus 1 ist, beinhaltet die Woche 1 den 1. Januar und der erste Tag der Woche ist der Sonntag. Da der 03.01.2021 ein Sonntag war, war das der erste Tag der zweiten Woche im Jahr. 2
    =KALENDERWOCHE("2021-01-01"; 21) Die Funktion gibt 53 zurück. Wenn der Modus 21 ist, beinhaltet die Woche 1 den ersten Donnerstag im Jahr (07.01.2021) und der erste Tag der Woche ist der Montag (04.01.2021). Daher liegt der 01.01.2021 im letzten Monat von 2020, was die 53. Woche ist (andere Jahre mögen nur 52 Wochen haben). 53
    =KALENDERWOCHE("2021-01-04"; 21) Die Funktion gibt 1 zurück. Wenn der Modus 21 ist, beinhaltet Woche 1 den ersten Donnerstag im Jahr (07.01.2021) und der erste Tag der Woche ist der Montag (04.01.2021). 1
    =KALENDERWOCHE(A1; B1) wobei Zelle A1 das Datum 26.02.2021 enthält und Zelle B1 den Wert 13. Die Funktion gibt 9 zurück. 9
    =KALENDERWOCHE(44251; 13) Die Funktion gibt wieder 9 zurück. 44251 ist der Zeitstempel für den 26.02.2021 und daher sind die Argumente identisch zum vorigen Beispiel. 9
    =KALENDERWOCHE("2021-02-26T15:00:00"; 13.789) Die Funktion gibt wieder 9 zurück. Die Zeitkomponenten des Datums werden ignoriert und der Wert des Modus wird gekürzt auf eine Ganzzahl. 9

    Ähnliche LibreOffice Funktionen:

    TAG

    ISOKALENDERWOCHE

    MONAT

    WOCHENTAG

    KALENDERWOCHE_EXCEL2003

    JAHR

    ODF Standard:

    Kapitel 6.10.21, Teil 2.

    Betroffene (oder ähnliche) EXCEL-Funktionen:

    WEEKNUM