CX_LOCALE::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. Sie entspricht der gleichnamigen Funktion IsDateType, die für ein bestimmtes Datum aufgerufen werden kann, jedoch mit
anderen Parametern.Achtung!
Momentan wird bei der Abfrage nach dem Typ eines Datums die Hierarchie der Locales nicht beachtet! Das bedeutet, das die CX_HOLIDAY Objekte aller Locales in der Hierarchie gleichberechtigt in die Abfrage mit einbezogen
werden.Im Falle eines unvollständigen Datums kann die Überprüfung
nur dann 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 Datumstyp-Tabelle zu entnehmen. Durch die Übergabe von addierten Werte kann in mehreren Bereichen gleichzeitig gesucht werden, so dass z.B. der Wert "11" überprüfen würde, ob der Tag ein "Termin", "Gedenktag" oder
"Ferientag" ist.Code-Beispiel:
In den Beispiel-Programmen wird überprüft, ob der
"25.12.1995" ein Feier- oder Ferientag ist. Dabei wird in beiden Beispielen auf das aktuell eingestellte System-Locale zugegriffen, wobei das folgende Programm direkt das System-Locale
anspricht:
Var(date) CreateTransObject(CX_DATE)
"25.12.1995" date Put
date 12 CallStatic(GetLocale) Call(IsDateType)
Wenn das Ausführen dieses Skriptes TRUE erzeugt, so wurde der
"25.12.1995" entweder als Feier- oder Ferientag
definiert.Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_LOCALE, CX_STATE_LOCALE oder CX_COUNTRY_LOCALE | das Locale |
Top-1 | INTEGER | der Datumstyp-Wert | |
Top-2 | CX_DATE oder CX_SPAN_DATE | das Datum(-sobjekt) | |
Stack(Out) | Top | INTEGER | das Ergebnis der Überprüfung |