CX_LOCALE
Klassenhierarchie
- CX_CLASS
- CX_EXPANDABLE
- CX_LOCALE
- CX_EXPANDABLE
Beschreibung: (Business Pattern)
Mit einem Region-Locale werden alle regionenspezifischen Informationen verwaltet. Dabei ist eine "Region" ein beliebig kleiner geografischer oder auch verwaltungstechnischer Raum, wobei eine Region nicht nur einem Staat, sondern stattdessen auch einer anderen Region untergeordnet sein kann, so dass keine Begrenzung in der Schachtelungstiefe von Locales besteht.
Somit kann eine Verfeinerung von Regionen bis auf Teilbereiche eines Unternehmens durchgeführt werden. Ein Beispiel hierfür ist die Definition von Werktagen, die je nach Unternehmensbereich unterschiedlich ausfallen kann. Während in der Produktion möglicherweise Samstags und Sonntags gearbeitet wird, und diese Tage daher als Werktage gelten, können Sams- und Sonntage in der Verwaltung als Nicht-Werktage gelten.
Die Definition der Locale-Information ist hier beschrieben.
In der Standardeinstellung sind die meisten Informationen undefiniert, so dass bei einem Zugriff auf diese Daten die Werte des übergeordneten Locales zurückgegeben werden. Zusätzlich hierzu können für eine Region auch noch Feiertage festgelegt werden.
Code-Beispiel:
Combo(CX_LOCALE::DateSeparatorMA()~DateSeparator, HELP(10151), 280, 20, 55, 25, "classix.num~DateSeparators") [ SELECT:NON_CURRENT: systemLocale DrainWindow(, DateSeparator) ] ObjectList(RegionBox1, 420, 20, 200, 45) [ INITIALIZE: [ "CX_LOCALE::name" 0 ] SetFormat 0 SetSort SELECT: ClearObox(, RegionBox2) GetObjectsSelected Dup -> actLocale Get(sublocales) FillObox(, RegionBox2) actLocale SystemObject Call(SetLocaleByObject) SendMsg(REFRESH_LOCALE_INFO) //des übergeordneten Landes ]
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 | ||
Holidays | COLLECTION | liefert alle CX_HOLIDAY Objekte | ||
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 | ||
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 | ||
PosSignPrecede | 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 | ||
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 | |
SummerWinterChangeDayDescription | INTEGER | liefert der Wochentag, an dem die Umstellung von Sommer- auf Winterzeit stattfindet | ||
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 | ||
WinterSummerChangeDayDescription | INTEGER | liefert der Wochentag, an dem die Umstellung von Winter- auf Sommerzeit stattfindet | ||
WorkingDays | INTEGER | liefert die Arbeitstage des Landes | ||
WorkingDaysMA | * | Arbeitstage des Landes Ein/Ausgabe | ||
NewHoliday | CX_HOLIDAY | Ein neuer Feiertag wird erzeugt und das Locale-Objekt hinzugefügt. | ||
RemoveHoliday | CX_HOLIDAY | Ein Feiertag wird gelöscht | ||
SortedHolidays | INTEGER, INTEGER | COLL | Liefert alle Feiertage in aufstehend sortierter Reihenfolge | |
string | INTEGER | CX_STRING | Liefert die String-Darstellung des Objektes | |
SummerWinterChangeDate | INTEGER | liefert der Monat, in dem von Sommer- auf Winterzeit umgestellt wird | ||
SummerWinterChangeTime | STRING | liefert die Umstellzeit von Sommer- auf Winterzeit | ||
WinterSummerChangeDate | INTEGER | liefert der Monat, in dem von Winter- auf Sommerzeit umgestellt wird | ||
WinterSummerChangeTime | STRING | liefert die Umstellzeit von Winter- auf Sommerzeit |
* MA = Member-Access-Funktion
Datenfeld | Typ | Referenz-Klasse | I* | Kurzbeschreibung |
---|---|---|---|---|
workingDays | CHAR | Werktage des Bundeslandes: 0 = undefiniert, 1 = Montag, 2 = Dienstag, 4 = Mittwoch, 8 = Donnerstag, 16 = Freitag, 32 = Samstag, 64 = Sonntag |
||
countryCode | CHAR | Landescode des übergeordneten Landes | ||
languagePos | CHAR | Systemnummer der Regionensprache | ||
language | MULTIPLE_STRING | Name der Sprache innerhalb der Region als multipler String | ||
timeZone | SHORT | Zeitzone, in der sich die Region befindet | ||
sysLocale | STRING | Locale der C-Standard Lib. | ||
name | MULTIPLE_STRING | Regionname | ||
regionCode | STRING | Regionencode | ||
upperLocale | POINTER | CX_CLASS | übergeordneten Locale | |
stateCode | CHAR | Bundeslandcode des übergeordneten Bundeslandes | ||
accessCode | STRING | Eigene Telefonnummer im internationalen Format; unbekannte Teile sind einfach ausgelassen, d.h. bei einem Land würde nur der Landescode vorhanden sein (z.B. +49- ) | ||
dialingTone | STRING | Code, um eine Amtsleitung zu bekommen; meist eine 0 bei Telefonanlagen | ||
maxLengthOfExtension | SHORT | Maximale Länge der Durchwahl im eigenen Betrieb; bei zweistelligen Durchwahlen z.B. steht hier eine 2 | ||
sublocales | COLL | CX_CLASS | untergeordneten Locale | |
holidays | POINTER | CX_HOLIDAYS | zugeordnete Feiertags- und Feriendefinitionen |
* I = Indizierbares Datenfeld
Modul | Kurzbeschreibung |
---|---|
locales.mod | Ortsspezifische Daten Editiermodul |
setlocal.mod | Ortsauswahl Basismodul |
wrldclck.mod | Weltuhr Basismodul |