Lade...
 

CX_DATE::IsDateType

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

+                 // Konstanten für die zu prüfenden Klassen (Summe: 12)

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