CX_DATE::IsHoliday
Beschreibung:
Diese Funktion ermittelt, ob ein Tag ein Feiertag ist oder nicht. Das Ergebnis dieser Überprüfung wird
als Wahrheitswert zurückgegeben.
Was für das System als Feiertag gilt, hängt von den Einträgen in den ortsspezifischen Daten ab. Die Einträge in diesen werden nach den lokalen Eingestellungen ausgewählt.
Für die Hierarchie bei der Abfrage nach besonderen Tagen siehe auch IsDateType.
Soll der (Feiertags-)Name bzw. der mehrsprachige
(Feiertags-)Name des Tages ermittelt werden, so sind die Funktionen NameOfDay bzw.
MLNameOfDay zu benutzen.
Im Falle eines unvollständigen Datums kann nur dann die
Überprüfung durchgeführt werden, wenn das Datum aus einer Tages- und Monatsangabe besteht und der Feiertag
einen festen Termin darstellt. So wird für das Datum "25.12" TRUE zurückgegeben, während
der "7.4", der nur in bestimmten Jahren das Osterdatum ist, FALSE erzeugt.
Für eine Datumsperiode bezieht sich diese Funktion auf
ihr Startdatum. Diese Funktion wird auch herangezogen zur für die Bestimmung der tatsächlichen Periodenlänge von Netto-Datumsperioden.
Code-Beispiel:
In dem Beispiel-Programm wird überprüft, ob der "25.12.1995" ein Feiertag ist.
Var(date)
// deklariere eine Variable
CreateTransObject(CX_DATE) -> date // generiere das heutige Tagesdatum
"25.12.1995" date Put
// schreibe das neue Datum in das Datumsobjekt
date Call(IsHoliday)
// teste, ob der Tag ein Feiertag ist
Wenn das Ausführen dieses Skriptes den Wert TRUE erzeugt, so wurde der "25.12.1995" als
Feiertag definiert.
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_DATE oder CX_SPAN_DATE | das Datum(-sobjekt) |
Stack(Out) | Top | INTEGER | das Ergebnis der Überprüfung |