Lade...
 

CX_DATE::NameOfDay

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 Startdatum

Code-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
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
Funktionsaufruf: Call(NameOfDay)