Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# addWorkDays
`addWorkDays` addiert oder subtrahiert eine bestimmte Anzahl von Arbeitstagen zu einem bestimmten Datumswert. Die Funktion gibt ein Datum für einen Arbeitstag zurück, das auf einen bestimmten Werktag nach oder vor einem bestimmten Eingabedatumswert liegt.
## Syntax
```
addWorkDays(initDate, numWorkDays)
```
## Argumente
*initDate*
Ein gültiges Datum ungleich NULL, das als Startdatum für die Berechnung dient.
+ **Datensatzfeld** — Jedes `date`-Feld aus dem Datensatz, dem Sie diese Funktion hinzufügen.
+ **Datumsfunktion** — Jede Datumsausgabe aus einer anderen `date`-Funktion, wie z. B. `parseDate`, `epochDate`, `addDateTime`. usw.
**Example**
```
addWorkDays(epochDate(1659484800), numWorkDays)
```
+ **Berechnete Felder** — Jedes schnell berechnete Feld, das einen `date` Wert zurückgibt.
**Example**
```
calcFieldStartDate = addDateTime(10, “DD”, startDate)
addWorkDays(calcFieldStartDate, numWorkDays)
```
+ **Parameter** — Beliebiger `datetime` Quick-Parameter.
**Example**
```
addWorkDays($paramStartDate, numWorkDays)
```
+ Beliebige Kombination der oben angegebenen Argumentwerte.
*numWorkDays*
Eine Ganzzahl ungleich Null, die als Enddatum für die Berechnung dient.
+ **Literal** - Ein Integer-Literal, das direkt in den Ausdruckseditor eingegeben wurde.
**Example**
```
```
+ **Datensatzfeld** - Ein beliebiges Datumsfeld aus dem Datensatz
**Example**
```
```
+ **Skalarfunktion oder Berechnung** — Jede skalare Schnellfunktion, die beispielsweise eine Ganzzahlausgabe von einer anderen Funktion zurückgibt `decimalToInt``abs`, usw.
**Example**
```
addWorkDays(initDate, decimalToInt(sqrt (abs(numWorkDays)) ) )
```
+ **Berechnetes Feld** — Jedes schnell berechnete Feld, das einen `date` Wert zurückgibt.
**Example**
```
someOtherIntegerCalcField = (num_days * 2) + 12
addWorkDays(initDate, someOtherIntegerCalcField)
```
+ **Parameter** — Beliebiger `datetime` Quick-Parameter.
**Example**
```
addWorkDays(initDate, $param_numWorkDays)
```
+ Beliebige Kombination der oben angegebenen Argumentwerte.
## Rückgabetyp
Ganzzahl
## Ausgabewerte
Zu den erwarteten Ausgabewerten gehören:
+ Positive Ganzzahl (wenn start\$1date < end\$1date)
+ Positive Ganzzahl (wenn start\$1date > end\$1date)
+ NULL, wenn eines oder beide Argumente einen Nullwert von `dataset field` erhalten.
## Eingabefehler
Unzulässige Argumentwerte führen zu Fehlern, wie in den folgenden Beispielen dargelegt.
+ Die Verwendung eines literalen NULL-Werts als Argument im Ausdruck ist nicht zulässig.
**Example**
```
addWorkDays(NULL, numWorkDays)
```
**Example**
```
Error
At least one of the arguments in this function does not have correct type.
Correct the expression and choose Create again.
```
+ Die Verwendung eines Zeichenfolgenliterals als Argument oder eines anderen Datentyps als Datum im Ausdruck ist nicht zulässig. Im folgenden Beispiel sieht die Zeichenfolge **"2022-08-10"** wie ein Datum aus, ist aber tatsächlich eine Zeichenfolge. Um sie zu verwenden, müssten Sie eine Funktion verwenden, die in einen Datentyp vom Datentyp Datum konvertiert.
**Example**
```
addWorkDays("2022-08-10", 10)
```
**Example**
```
Error
Expression addWorkDays("2022-08-10", numWorkDays) for function addWorkDays has
incorrect argument type addWorkDays(String, Number).
Function syntax expects Date, Integer.
```
## Beispiel
Eine positive Ganzzahl als `numWorkDays`-Argument ergibt ein Datum vor dem Eingabedatum. Eine negative Ganzzahl als `numWorkDays`-Argument ergibt ein resultierendes Datum, das in der Vergangenheit des Eingabedatums liegt. Ein Nullwert für das `numWorkDays`-Argument ergibt denselben Wert wie das Eingabedatum, unabhängig davon, ob es auf einen Arbeitstag oder ein Wochenende fällt oder nicht.
Die `addWorkDays`-Funktion arbeitet mit der Granularität: `DAY`. Die Genauigkeit kann bei keiner Granularität beibehalten werden, die niedriger oder höher als die Stufe `DAY` ist.
```
addWorkDays(startDate, endDate)
```
Nehmen wir an, es gibt ein Feld `employmentStartDate` mit den folgenden Werten:
```
2022-08-10 2022-08-06 2022-08-07
```
Unter Verwendung des obigen Felds und der folgenden Berechnungen wird `addWorkDays` die geänderten Werte wie unten dargestellt zurückgegeben:
```
addWorkDays(employmentStartDate, 7)
2022-08-19
2022-08-16
2022-08-16
addWorkDays(employmentStartDate, -5)
2022-08-02
2022-08-01
2022-08-03
addWorkDays(employmentStartDate, 0)
2022-08-10
2022-08-06
2022-08-07
```
Im folgenden Beispiel wird der anteilige Gesamtbonus, der jedem Mitarbeiter zwei Jahre lang gezahlt wird, auf der Grundlage der Anzahl der Tage berechnet, die jeder Mitarbeiter tatsächlich gearbeitet hat.
```
last_day_of_work = addWorkDays(employment_start_date, 730)
total_days_worked = netWorkDays(employment_start_date, last_day_of_work)
total_bonus = total_days_worked * bonus_per_day
```
![\[alt text not found\]](http://docs.aws.amazon.com/de_de/quick/latest/userguide/images/addWorkDays-function-example.png)