Dokumentation/Calc Funktionen/ARBEITSTAG.INTL
TDF LibreOffice Document Liberation Project Community Blogs Weblate Nextcloud Redmine Ask LibreOffice Spende
Funktionsname:
ARBEITSTAG.INTL
Kategorie:
Datum und Zeit
Zusammenfassung:
Berechnet das Datum, welches die angegebene Anzahl von Arbeitstagen vor oder nach dem angegebenen Datum liegt. Feiertage (oder andere arbeitsfreie Tage) können angegeben werden. Die Standard-Arbeitswoche kann geändert werden.
Syntax:
ARBEITSTAG.INTL(Startdatum; Tage[; [Wochenende][; Feiertage]])
Rückgabewerte:
Gibt den Zeitstempel des Tages als Ganzzahl zurück, der die angegebene Anzahl Arbeitstage vor oder nach dem angegebenen Datum liegt. Der Rückgabewert ist standardmäßig als Datum formatiert. Andere Formate können eingestellt werden.
Argumente:
Startdatum ist das Datum (in Anführungszeichen) oder der Zeitstempel, ggf. aus einer Referenz auf eine Zelle, die als Startdatum in die Berechnung eingehen soll.
Tage ist ist eine Ganzzahl oder eine Referenz auf eine Zelle mit der Ganzzahl, welche die Anzahl der Arbeitstage ist, die als Offset in der Berechnung gilt. Ein positiver Wert gibt ein Ergebnis nach dem Startdatum, ein negativer Wert gibt ein Ergebnis vor dem Startdatum.
Wochenende ist eine Zahl oder ein Text oder eine Referenz auf eine Zelle, die eine dieser Typen enthält. Dadurch definiert sich die genutzte Standard Arbeitswoche. Die möglichen numerischen Optionen zeigen einen einfachen Weg, die Arbeitswoche anzugeben. Die folgende Tabelle zeigt die möglichen Werte. Werte 1 bis 7 betreffen eine Woche mit zwei arbeitsfreien Tagen, die Werte 11 bis 17 betreffen eine Woche mit einem arbeitsfreien Tag.
Zahl | arbeitsfreie Tage |
---|---|
1 oder weggelassen | Samstag und Sonntag |
2 | Sonntag und Montag |
3 | Montag und Dienstag |
4 | Dienstag und Mittwoch |
5 | Mittwoch und Donnerstag |
6 | Donnerstag und Freitag |
7 | Freitag und Samstag |
11 | nur Sonntag |
12 | nur Montag |
13 | nur Dienstag |
14 | nur Mittwoch |
15 | nur Donnerstag |
16 | nur Freitag |
17 | nur Samstag |
Ein Text ist eine flexiblere Methode, um eine Arbeitswoche zu definieren. Der Text umfasst sieben Stellen. - '0' zeigt einen Arbeitstag und '1' zeigt einen arbeitsfreien Tag an. Jede Stelle bezeichnet einen Tag der Woche, begonnen mit dem Montag. Zum Beispiel definiert "0100011" den Dienstag, Samstag und Sonntag als arbeitsfreie Tage.
Feiertage ist eine Liste von Feiertagen (oder alle anderen Tage), die nicht als Arbeitstage gelten. Diese Liste kann als Zellbereich mit Zeitstempeln (vielleicht im Datumsformat) übergeben werden. Alternativ kann die Liste als Aufzählung entweder als Daten (in Anführungszeichen) oder als Zeitstempel mitgegeben werden. Falls die Liste fehlt, werden keine Feiertage berücksichtigt.
- Falls Startdatum kein gültiges Datum ist, dann meldet ARBEITSTAG.INTL einen #WERT! Fehler.
- ARBEITSTAG.INTL ignoriert Zeitanteile am Startdatum.
- Falls Tage nicht numerisch ist, dann meldet ARBEITSTAG.INTL einen invalid argument error (Fehler:502).
- Falls Tage keine Ganzzahl ist, dann kürzt sie ARBEITSTAG.INTL auf eine Ganzzahl.
- Falls eine Zeichenkette für das Wochenende angegeben ist, und die Zeichenkette nicht exakt sieben Zeichen hat, meldet ARBEITSTAG.INTL einen #WERT! Fehler. Falls die Zeichenkette sieben Zeichen hat, aber mindestens eines dieses Zeichen weder '0' noch '1' ist, meldet ARBEITSTAG.INTL einen invalid argument error (Fehler:502).
- Falls eine Zahl für das Wochenende angegeben ist, und die Zahl keine Ganzzahl ist, meldet ARBEITSTAG.INTL einen invalid argument error (Fehler:502). Falls die Zahl eine Ganzzahl ist, aber weder zwischen 1 und 7 noch zwischen 11 und 17 liegt, meldet ARBEITSTAG.INTL einen invalid argument error (Fehler:502).
- Falls das Wochenende als eine Referenz auf eine Zelle angegeben ist, und diese Zelle eine Fehlermeldung (so wie #NAME?) enthält, wird diese Fehlermeldung auch von ARBEITSTAG.INTL als Ergebnis zurückgegeben.
- Falls Feiertage als Aufzählung mitgegeben wird, und ein Eintrag aus der Aufzählung kein Datum und kein Zeitstempel, dann meldet ARBEITSTAG.INTL einen #WERT! Fehler.
- Falls Feiertage als Zellbereich mitgegeben wird, dann werden in den meisten Fällen Zellen, die kein Datum oder Zeitstempel im relevanten Zeitraum enthalten, ignoriert. Wenn eine Zelle trotzdem einen Fehlercode (wie z. Bsp. #NAME?) enthält, dann wird dieser Fehler als Ergebnis von ARBEITSTAG.INTL zurückgegeben.
Zusätzliche Informationen:
Spezifische Eigenheiten der Funktion ARBEITSTAG.INTL
Die Reihenfolge der optionalen Parameter Feiertage und Wochenende ist für ARBEITSTAG.INTL anders als von den ODF 1.2 spezifiziert. Außerdem ist die Definition vom Wochenende für Calc’s ARBEITSTAG.INTL gegenüber den ODF 1.2 erweitert. Die Funktion ARBEITSTAG.INTL ist kompatibel zur gleichnamigen Funktion in EXCEL.
Allgemeine Informationen über die Datums- und Zeit-Funktionen in Calc
- 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 ▸ ▸ ▸ 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 ▸ ▸ ▸ , 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 Ergebnis2021-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 ▸ ▸ ▸ 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 |
---|---|---|
=ARBEITSTAG.INTL("2021-02-10"; 10) | Die Funktion gibt den 24.02.2021 zurück. Der Tag, der 10 Arbeitstage nach dem 10.02.2021 liegt, ist der 24.02.2021. | 24.02.2021 |
=ARBEITSTAG.INTL(44256; −5,8) | Die Funktion gibt den 22.02.2021 zurück. Der Wert 44256 ist der Zeitstempel für den 01.03.2021. Calc verkürzt die Dezimalzahl -5,8 auf die Ganzzahl -5. Der Tag, der 5 Arbeitstage vor dem 01.03.2021 liegt, ist der 22.02.2021. | 22.02.2021 |
=ARBEITSTAG.INTL("2020-01-01"; 254;; {"2020-01-01"; "2020-04-10"; "2020-04-13"; "2020-05-08"; "2020-05-25"; "2020-08-31"; "2020-12-25"; "2020-12-28"}) | Die Funktion gibt den 31.12.2020 zurück. Der Tag, der unter der Berücksichtigung der aufgelisteten Feiertage 254 Arbeitstage nach dem 01.01.2020 liegt, ist der 31.12.2020. | 31.12.2020 |
=ARBEITSTAG.INTL(G1; G2; G3:G7) wobei die Zelle G1 das Datum 01.12.2001 enthält, die Zelle G2 enthält die Zahl 17 und die Zellen G3 bis G7 enthalten die Daten 24.12.2001, 25.12.2001, 26.12.2001, 31.12.2001, 01.01.2002 . |
Die Funktion gibt den 28.12.2001 zurück. Der 28.12.2001 war unter Berücksichtigung der aufgelisteten Feiertage 17 Arbeitstage nach dem 01.12.2001. | 28.12.2001 |
=ARBEITSTAG.INTL("2021-02-10"; 10; 11) | Die Funktion gibt den 22.02.2021 zurück. Der Tag, der unter der Voraussetzung eines einzigen arbeitsfreien Tages pro Woche (Sonntag) 10 Arbeitstage nach dem 10.02.2021 liegt, ist der 22.02.2021. | 22.02.2021 |
=ARBEITSTAG.INTL("2021-02-10"; 10; "0000001") | Die Funktion gibt wieder den 22.02.2021 zurück. Der Tag, der unter der Voraussetzung eines einzigen arbeitsfreien Tages pro Woche (Sonntag) 10 Arbeitstage nach dem 10.02.2021 liegt, ist der 22.02.2021. | 22.02.2021 |
Ähnliche LibreOffice Funktionen:
ODF Standard:
Betroffene (oder ähnliche) EXCEL-Funktionen:
WORKDAY.INTL seit Version 2010.