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 | 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 |