CX_STATE_LOCALE
Klassenhierarchie
-
CX_CLASS
- CX_EXPANDABLE
- CX_LOCALE
- CX_STATE_LOCALE
- CX_LOCALE
- CX_EXPANDABLE
Beschreibung:
Mit einem State-Locale werden alle
bundeslandspezifischen Informationen verwaltet. Standardmäßig sind alle
Einstellungen "auf Null gesetzt", was bedeutet, das bei einem Zugriff die Daten des
(zwingend) übergeordneten Country-Locales zurückgegeben werden. Soll in der
Datei CX_ROOTDIR\SYSTEM\LOCALES.TXT
ein neues Bundesland aufgenommen werden, so muss der Eintrag mit dem Schlüsselwort
"STATE" beginnen. Daraufhin folgen die Definitionen der einzelnen
Informationen. Der stateCode und countryCode müssen dabei
zwingend eingegeben werden, um das State-Locale eindeutig identifizieren zu können.
Die folgende Aufführung zeigt alle Informationen, die in einem
State-Locale enthalten sind, und wie die Standard-Einstellung aussieht. Die
Angabe in der Datei erfolgt dabei durch den Feldnamen gefolgt von einem
"=" und der gewünschten Einstellung.
Die Umstellzeitpunkte von Winter- auf Sommerzeit und umgekehrt sind als periodisches
Datum codiert. In der Standardeinstellung sind sie, wie auch alle anderen
Informationen, undefiniert, so dass bei einem Zugriff auf diese Daten die
Umstellzeitpunkte des Landes zurückgegeben werden. Zusätzlich hierzu können für
ein Bundesland auch noch bundeslandweite Feiertage
Code-Beispiel:
Define(InsertLocale)
Var(tmpLocale)
-> tmpLocale
tmpLocale ifnot
{
CreateTransObject(CX_COUNTRY_LOCALE)
}
else
{
tmpLocale Type case
CX_COUNTRY_LOCALE:
CreateTransObject(CX_STATE_LOCALE)
CX_LOCALE:
CX_STATE_LOCALE : CreateTransObject(CX_LOCALE)
default: cancel
endCase
Dup tmpLocale Insert(sublocales)
}
-> systemLocale
systemLocale FillObox(, LocalesTree)
systemLocale Select(, LocalesTree)
systemLocale SendMsg(EDIT_LOCALE_NAME)
// systemLocale DrainWindow
Funktion | MA* | Parameter | Rückgabe | Kurzbeschreibung |
---|---|---|---|---|
AllHolidays/AllHolidayObjects | (OBJECT, OBJECT, INTEGER) | COLL | liefert alle Feiertagen in einem Zeitraum | |
BaseCentury | INTEGER | liefert aktuelles Jahrhundert | ||
BaseCenturyMA | * | Aktuelles Jahrhundert Ein/Ausgabe | ||
CodeMap | INTEGER | liefert die Zeichenumsetztabelle | ||
CodeMapMA | * | Zeichenumsetztabelle Ein/Ausgabe | ||
Country | STRING | liefert die Landesname | ||
CountryCode | INTEGER | liefert einen Landescode | ||
CountryCodeMA | * | der Landescode Ein/Ausgabe | ||
CountryMA | * | Landesname Ein/Ausgabe | ||
CurrencyUnitPrecedes | INTEGER | Zeigt mit Hilfe eines Wahrheitswertes an, ob eine Währungs-Einheit vor dem Wert oder nach dem Wert angezeigt werden soll. Steht der Wert auf 1 wird die Einheit vor dem Wert angezeigt. | ||
CurrencyUnitPrecedesMA | * | Position einer Währungs-Einheit Ein/Ausgabe. | ||
CurrencyUnitSeparation | INTEGER | Zeigt mit Hilfe eines Wahrheitswertes an, ob zwischen einer Währungs-Einheit und dem Wert (egal in welcher Reihenfolge) ein Leerzeichen angezeigt werden soll. | ||
CurrencyUnitSeparationMA | * | Leerzeichen zwischen einer Währungs-Einheit Ein/Ausgabe | ||
DateFormat | INTEGER | liefert das aktuelle Datumsformat | ||
DateFormatMA | * | Datumsformat Ein/Ausgabe | ||
DateSeparator | STRING | liefert das Trennzeichen für ein Datum | ||
DateSeparatorMA | * | Trennzeichen für ein Datum Ein/Ausgabe | ||
DecimalSeparator | STRING | liefert das Trennzeichen für Dezimalzahlen | ||
DecimalSeparatorMA | * | Trennzeichen für Dezimalzahlen Ein/Ausgabe | ||
DiallingPrefix | STRING | - veraltet/ deprecated - | ||
DiallingPrefixMA | * | - veraltet/ deprecated - | ||
EndTimeZone | INTEGER | liefert die Endzeitzone des Landes in Minutenabweichung von der MEZ | ||
EndTimeZoneMA | * | Endzeitzone des Landes Ein/Ausgabe | ||
FirstDayOfWeek | INTEGER | liefert der erste Tag der Woche | ||
FirstDayOfWeekMA | * | Erster Tag der Woche Ein/Ausgabe | ||
FractionSeparator | STRING | liefert das Trennungszeichen für Zähler und Nenner bei Brüchen | ||
FractionSeparatorMA | * | Trennungszeichen für Zähler und Nenner bei Brüchen Ein/Ausgabe | ||
Grouping | STRING | liefert das Formatierungszeichen, die angeben, nach wie viel Stellen ein Tausendertrenner in eine Zahl eingefügt wird | ||
GroupingMA | * | Formatierungszeichen für Tausendertrenner in eine Zahl Ein/Ausgabe | ||
InsertHoliday | neuen Feiertag einfügen | |||
IntCurrencySymbol | STRING | liefert das internationale Währungssymbol | ||
IntCurrencySymbolMA | * | Internationales Währungssymbol Ein/Ausgabe | ||
IsAnniversary | (OBJECT) | INTEGER | testet, ob ein Tag ein Gedenktag ist | |
IsDateType | (OBJECT, INTEGER) | INTEGER | testet, ob es sich bei einem Datum um einen speziellen freien Tag handelt | |
IsHoliday | (OBJECT) | INTEGER | testet, , ob ein Tag ein Feiertag ist | |
IsTerm | (OBJECT) | INTEGER | testet, ob ein Tag ein Termin ist | |
IsVacation | (OBJECT) | INTEGER | testet, ob ein Tag ein Ferientag ist | |
Language | MLSTRING | liefert der Name der Sprache als multipler String | ||
LanguageMA | * | Name der Sprache Ein/Ausgabe | ||
LanguagePos | INTEGER | liefert die Systemnummer der Landessprache | ||
LanguagePosMA | * | Systemnummer der Landessprache Ein/Ausgabe | ||
LocaleCode | STRING | liefert die Abkürzung des Landesnamen | ||
LocaleCodeMA | * | Abkürzung des Landesnamen Ein/Ausgabe | ||
LocaleName | STRING | aktuelle Localname ( Landesname) | ||
MLLocaleName | MLSTRING | aktuelle Localname ( Landesname) als mehrsprachigen Text | ||
MLSpecialNameOfDay | INTEGER, CX_DATE | MLSTRING | Liefert bestimmten mehrsprachigen (Feiertags-) Namen des Tages eines Datums | |
NegativeSign | STRING | liefert das Minuszeichen | ||
NegativeSignMA | * | Minuszeichen Ein/Ausgabe | ||
NegSignPrecedes | INTEGER | Zeigt mit Hilfe eines Wahrheitswertes an, ob das Minuszeichen vor der Zahl steht. Falls nicht, so steht es dahinter. | ||
NegSignPrecedesMA | * | die Position des Minuszeichens Ein/Ausgabe | ||
NegSpaceSeparation | INTEGER | Zeigt mit Hilfe eines Wahrheitswertes an, ob zwischen dem Vorzeichen und der Zahl eine Leerstelle liegen soll | ||
NegSpaceSeparationMA | * | eine Leerstelle zwischen dem Vorzeichen und der Zahl Ein/Ausgabe | ||
NewHoliday | CX_HOLIDAY | ein neuer Feiertag wird erzeugt und das Locale Objekt wird hinzugefügt | ||
NonCurrencyUnitPrecedes | INTEGER | Zeigt mit Hilfe eines Wahrheitswertes an, ob eine Nicht-Währungs-Einheit vor oder nach dem Wert eines CX_VALUEs angezeigt werden soll. Steht der Wert auf 1 wird die Einheit vor dem Wert angezeigt. | ||
NonCurrencyUnitPrecedesMA | * | Position einer Nicht-Währungs-Einheit eines CX_VALUEs. Ein/Ausgabe. | ||
NonCurrencyUnitSeparation | INTEGER | Zeigt mit Hilfe eines Wahrheitswertes an, ob zwischen einer nicht-Währungs-Einheit und dem Wert (egal in welcher Reihenfolge) eines CX_VALUEs ein Leerzeichen angezeigt werden soll. | ||
NonCurrencyUnitSeparationMA | * | Steuert Leerzeichen zwischen dem Wert und einer Nicht-Währungs-Einheit eines CX_VALUEs | ||
NumPrecision | INTEGER | liefert die Anzahl an Nachkommastellen | ||
NumPrecisionMA | * | Anzahl an Nachkommastellen Ein/Ausgabe | ||
PathOfLocale | COLL | den kompletten Pfad eines Locales | ||
PositiveSign | STRING | liefert das Pluszeichen | ||
PositiveSignMA | * | Pluszeichen Ein/Ausgabe | ||
PosSignPrecedes | INTEGER | Zeigt mit Hilfe eines Wahrheitswertes an, ob das Pluszeichen vor der Zahl steht. Falls nicht, so steht es dahinter. | ||
PosSignPrecedesMA | * | die Position des Pluszeichens Ein/Ausgabe | ||
PosSpaceSeparation | INTEGER | Zeigt mit Hilfe eines Wahrheitswertes an, ob zwischen dem Vorzeichen und der Zahl eine Leerstelle liegen soll | ||
PosSpaceSeparationMA | * | eine Leerstelle ob zwischen dem Vorzeichen und der Zahl Ein/Ausgabe | ||
RawHolidays | COLL | liefert alle Feiertage | ||
RemoveHoliday | CX_HOLIDAY | Ein Feiertag wird gelöscht | ||
SortedHolidays | INTEGER, INTEGER | COLL | Liefert alle Feiertage in aufstehend sortierter Reihenfolge | |
SpecialNameOfDay | (OBJECT, INTEGER) | STRING | liefert einen bestimmten mehrsprachigen (Feiertags-) Namen des Tages eines Datums | |
SpecialMLNameOfDay | (OBJECT, INTEGER) | MLSTRING | liefert einen bestimmten mehrsprachigen (Feiertags-) Namen des Tages eines Datums | |
string | INTEGER | CX_STRING | Liefert die String-Darstellung des Objektes | |
SummerWinterChangeDate | INTEGER | liefert der Monat, in dem von Sommer- auf Winterzeit umgestellt wird | ||
SummerWinterChangeDayDescription | INTEGER | liefert der Wochentag, an dem die Umstellung von Sommer- auf Winterzeit stattfindet | ||
SummerWinterChangeTime | STRING | liefert die Umstellzeit von Sommer- auf Winterzeit | ||
ThousandsSeparator | STRING | liefert das Trennzeichen für tausender Stellen | ||
ThousandsSeparatorMA | * | Trennzeichen für tausender Stellen Ein/Ausgabe | ||
TimeFormat | INTEGER | liefert das Zeitformat | ||
TimeFormatMA | * | Zeitformat Ein/Ausgabe | ||
TimeSeparator | STRING | liefert das Trennzeichen für eine Zeitangabe | ||
TimeSeparatorMA | * | Trennzeichen für eine Zeitangabe Ein/Ausgabe | ||
TimeZone | INTEGER | liefert die Startzeitzone des Landes in Minutenabweichung von der MEZ | ||
TimeZoneMA | * | Startzeitzone des Landes in Minutenabweichung von der MEZ Ein/Ausgabe | ||
UnknownPartOfDate | STRING | liefert das Zeichen für unbekannte Bestandteile eines unvollständigen Datums | ||
UnknownPartOfDateMA | * | Zeichen für unbekannte Bestandteile eines unvollständigen Datums Ein/Ausgabe | ||
WinterSummerChangeDate | INTEGER | liefert der Monat, in dem von Winter- auf Sommerzeit umgestellt wird | ||
WinterSummerChangeDayDescription | INTEGER | liefert der Wochentag, an dem die Umstellung von Winter- auf Sommerzeit stattfindet | ||
WinterSummerChangeTime | STRING | liefert die Umstellzeit von Winter- auf Sommerzeit | ||
WorkingDays | INTEGER | liefert die Arbeitstage des Landes | ||
WorkingDaysMA | * | Arbeitstage des Landes Ein/Ausgabe |
* MA = Member-Access-Funktion
Datenfeld | Typ | Referenz-Klasse | I* | Kurzbeschreibung |
---|---|---|---|---|
countryCode | CHAR | Landescode des übergeordneten Landes | ||
name | MULTIPLE_STRING | Name des Bundeslandes | ||
sublocales | COLL | CX_CLASS | untergeordneten Locale | |
pos1 | SHORT | lfd. Nr. dieses Wochentags im Monat | ||
day1 | SHORT | Wochentag, an dem die Umstellung von Winter- auf Sommerzeit stattfindet | ||
languagePos | CHAR | Systemnummer der Regionensprache | ||
workingDays | CHAR | Arbeitstage des Bundeslandes: 0 = undefiniert, 1 = Montag, 2 = Dienstag, 4 = Mittwoch, 8 = Donnerstag, 16 = Freitag, 32 = Samstag, 64 = Sonntag |
||
pos2 | SHORT | lfd. Nr. dieses Wochentags im Monat | ||
day2 | SHORT | Wochentag, an dem die Umstellung von Sommer- auf Winterzeit stattfindet | ||
gran1 | SHORT | Bezugsbereich | ||
language | MULTIPLE_STRING | Name der Sprache innerhalb der Region als multipler String | ||
freq1 | SHORT | Frequenz | ||
timeZone | SHORT | Zeitzone, in der sich die Region befindet | ||
gran2 | SHORT | Bezugsbereich | ||
freq2 | SHORT | Frequenz | ||
date1 | INTEGER | Monat, in dem von Winter- auf Sommerzeit umgestellt wird | ||
sysLocale | STRING | Locale der C-Standard Lib. | ||
upperLocale | POINTER | CX_CLASS | übergeordneten Locale | |
changeTime1 | STRING | Umstellzeit von Winter- auf Sommerzeit | ||
date2 | INTEGER | Monat, in dem von Sommer- auf Winterzeit umgestellt wird | ||
stateCode | CHAR | Bundeslandcode | ||
changeTime2 | STRING | Umstellzeit von Sommer- auf Winterzeit | ||
endTimeZone | SHORT | Endzeitzone des Landes in Minutenabweichung von der MEZ |
* I = Indizierbares Datenfeld
Modul | Kurzbeschreibung |
---|---|
locales.mod | Ortsspezifische Daten Editiermodul |
setlocal.mod | Ortsauswahl Basismodul |
wrldclck.mod | Weltuhr Basismodul |