getNthWorkingDay

Code

Date DateUtils.getNthWorkingDay(int n, Date startDay)

Beschreibung

Ermittelt den n-ten Arbeitstag nach dem übergebenen Startdatum.
Die Definition, welcher Wochentag ein Arbeitstag ist, erfolgt über die Anwendungsvariablen:

Bewegliche Feiertage werden mit speziellen Konstanten hinterlegt.
Gültige Konstanten sind:

Weitere Feiertage mit festem Datum können im Format "DD.MM." hinterlegt werden.
Als Trennzeichen muss "$!!$" verwendet werden.

Als Standardeinstellung für die Feiertage sind die hessischen Feiertage hinterlegt.

Parameter

• n: Die Anzahl der Tage ab dem gegebenen Starttag.

  • Ein positiver Wert zählt die Tage in die Zukunft.

  • Ein negativer Wert zählt die Tage in die Vergangenheit.

  • Wird die Zahl Null übergeben, wird das aktuelle Datum zurückgegeben, wenn es sich um einen Arbeitstag handelt.

  • Wird die Zahl Null übergeben, wird das Datum des nächsten Arbeitstages zurückgegeben, wenn es sich nicht um einen Arbeitstag handelt.

• day: Der Starttag, ab dem der n-te Arbeitstag ermittelt werden soll.

Return
Ein Date-Objekt, das den n-ten Arbeitstag repräsentiert.

Beispiele

final Calendar moDec23 = Calendar.getInstance();
moDec23.clear();
moDec23.set(2013, Calendar.DECEMBER, 23);
Date startDay = moDec23.getTime();
Date nthWorkingDay = DateUtils.getNthWorkingDay(3, startDay);
//=> Mit der Standard-Konfiguration (Hessische Feiertage) erhält man Montag, den 30.12.2013 als Date Objekt.