Lade...
 

CX_DATE::MLSpecialNameOfDay

CX_DATE::MLSpecialNameOfDay

Beschreibung:

Diese Funktion gibt einen bestimmten (Feiertags-) Namen des Tages eines Datums als mehrsprachigen Text zurück.

Diese Funktion ist dann notwendig, wenn ein Datum mehrere Namen besitzt. In diesem Fall liefert die Funktion MLNameOfDay einen unbestimmten Namen, d.h. es wird der zurückgeliefert, der zuerst gefunden wird. Diese Funktion erlaubt dagegen den kontrollierten Zugriff auf einen bestimmten Namen.
Ein Beispiel hierfür kann z.B. der "25.12" eines Jahres sein. Dieser Tag ist sowohl ein Feiertag ("1. Weihnachtstag"), als auch meistens ein Ferientag, da die Weihnachtsferien üblicherweise vor Weihnachten beginnen und nach Silvester enden. In diesem Fall handelt es sich bei diesem Tag sowohl um einen Feier-, als auch einen Ferientag, so dass er zwei Bezeichnungen hat. Um nun beide Bezeichnungen abfragen zu können, wird der Funktion der gewünschte Datumstyp als Zahl codiert übergeben. Die Werte sind der Datumstyp-Tabelle zu entnehmen.

Code-Beispiel:

Um den Feiertagsnamen des "25.12.1996" zu bekommen, wird die Funktion folgendermaßen aufgerufen: 

Var(date) CreateTransObject(CX_DATE) -> date  // erzeuge Objekt

"25.12.1996" date Put                         // setze den Wert des Datums
VACATION date Call(MLSpecialNameOfDay)       // ermittle den Namen für den Ferientyp
iterate {}                                    // extrahiere alle enthaltenen Strings aus dem MLString
HOLIDAY date Call(MLSpecialNameOfDay)         // ermittle den Namen des Feiertagtyps
iterate {}                                    // extrahiere alle enthaltenen Strings aus dem MLString

Das Ausführen dieses Skriptes gibt "Weihnachts-Ferien" und "1. Weihnachtstag"

in allen Landessprachen zurück. Sind beispielsweise Deutsch und Englisch definiert, so werden zunächst "Weihnachts-Ferien" und "Christmas Holidays" dann "1. Weihnachtstag" und "Christmas" geliefert.

Stack
Stack Position Objekttyp Kurzbeschreibung
Stack(In) Top CX_DATE oder CX_SPAN_DATE das Datum(-sobjekt)
Stack(Out) Top ML_STRING alle abgekürzten Namen für den Monat
Funktionsaufruf: Call(MLSpecialNameOfDay)