CX_DATE::NameOfDay
Beschreibung:
Diese Funktion gibt den (Feiertags-) Namen des Tages eines Datums in der eingestellten Landessprache zurück.
Die Feiertage werden in einer speziellen Tabelle gehalten und können länderspezifisch angepasst werden. Sollte der Tag kein Feiertag sein, so wird ein Leerstring (= "") zurückgegeben. Im Falle eines unvollständigen Datums kann nur dann der Feiertagsname zurückgegeben werden, wenn das Datum aus einer Tages- und Monatsangabe besteht und der Feiertag einen festen Termin darstellt. So wird für das Datum "24.12" "Weihnachten" zurückgegeben, während der "7.4", der nur in bestimmten Jahren das Osterdatum ist, einen Leerstring erzeugt. Um nur zu bestimmen, ob ein Tag ein Feiertag ist oder nicht, benutze man die Funktion IsHoliday. Für eine Datumsperiode bezieht sich diese
Funktion auf ihr StartdatumCode-Beispiel:
In dem Beispiel-Programm wird der Name des Tages des "3.10.1990" ermittelt, wobei davon ausgegangen
wird, dass Deutsch als Landessprache eingestellt ist.
Var(date)
// deklariere eine Variable
CreateTransObject(CX_DATE) -> date // generiere das heutige Tagesdatum
"3.10.1990" date Put
// schreibe das neue Datum in das Datumsobjekt
date Call(NameOfDay)
// liefere den Feiertagsnamen
Das Ausführen dieses Skriptes erzeugt den String "Tag der deutschen Einheit"
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_DATE oder CX_SPAN_DATE | das Datum(-sobjekt) |
Stack(Out) | Top | STRING | der (Feiertags-)Name des Tages |