CX_DATE::IsDateType
Beschreibung:
Diese Funktion ermittelt, ob es sich bei einem Datum um einen speziellen freien Tag handelt. Das Ergebnis
dieser Überprüfung wird als Wahrheitswert zurückgegeben.
Welche Tage zu welchen Datumstypen gehören, hängt von den Einträgen in den ortsspezifischen Daten ab. Die Einträge in diesen werden nach den lokalen Eingestellungen ausgewählt.
Achtung!
Momentan wird bei der Abfrage nach dem Typ eines Datums die Hierarchie der Locales nicht beachtet! Das bedeutet, dass die CX_HOLIDAY Objekte aller Locales in der Hierarchie gleichberechtigt in die Abfrage mit einbezogen
werden.
Im Falle eines unvollständigen Datums, kann nur dann die Überprüfung durchgeführt werden, wenn das Datum aus einer Tages- und Monatsangabe besteht und der Tag einen festen Termin darstellt. So wird für das Datum "25.12" TRUE zurückgegeben, während der "7.4", der nur in bestimmten Jahren das Osterdatum ist, FALSE erzeugt. Für eine Datumsperiode bezieht sich diese Funktion auf ihr Startdatum. Als Parameter erwartet die Funktion den bzw. die Typen, auf die das Datum überprüft werden soll. Die Werte für die Typen, sind der Datumstyp-Tabelle zu entnehmen. Durch die Übergabe von addierten Werte kann in mehreren Bereichen gleichzeitig gesucht werden, sodass z.B. der Wert "11" überprüfen würde, ob der Tag ein "Termin", "Gedenktag" oder "Ferientag" ist.
Code-Beispiel:
In dem Beispiel-Programm wird überprüft, ob der "25.12.1996" ein Feier- oder Ferientag ist.
Var(date)
// deklariere eine Variable
CreateTransObject(CX_DATE) -> date // generiere das heutige Tagesdatum
"25.12.1996" date Put
// schreibe das neue Datum in das Datumsobjekt
VACATION HOLIDAY
date Call(IsDateType) // teste, ob der Tag vom bestimmten Typ ist
Wenn das Ausführen dieses Skriptes den Wert TRUE erzeugt, so wurde der "25.12.1996" entweder als Feier- oder Ferientag definiert.
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_DATE oder CX_SPAN_DATE | das Datum(-sobjekt) |
Top-1 | INTEGER | der Typ-Wert | |
Stack(Out) | Top | INTEGER | das Ergebnis der Überprüfung |