Lade...
 

CX_DATE::MLNameOfDay

CX_DATE::MLNameOfDay

Beschreibung:

Diese Funktion gibt den (Feiertags-) Namen des Tages eines Datums als mehrsprachigen Text 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 leerer multipler String 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 mehrsprachige (Feiertags-)Name des Tages des "3.10.1990" ermittelt.

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(MLNameOfDay)             // liefere den mehrsprachigen (Feiertags-)Tagesnamen
iterate {}                         // extrahiere alle enthaltenen Strings aus dem MLString

Das Ausführen dieses Skriptes gibt "Tag der deutschen Einheit" in allen Landessprachen zurück. Sind beispielsweise Deutsch

und Englisch definiert, so wird "Tag der deutschen Einheit" und "Day of German Reunification" geliefert.

Stack
Stack Position Objekttyp Kurzbeschreibung
Stack(In) Top CX_DATE oder CX_SPAN_DATE das Datum(-sobjekt)
Stack(Out) Top ML_STRING alle (Feiertags-) Namen des Tages
Funktionsaufruf: Call(MLNameOfDay)