Lade...
 

CX_STATE_LOCALE - Bundeslandspezifische Daten

CX_STATE_LOCALE

Klassenhierarchie
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

festgelegt werden.

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

;

Methodenverzeichnis (MDI)
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

Datenverzeichnis (DDI)
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

Verwendung in AppsWH
Modul Kurzbeschreibung
locales.mod Ortsspezifische Daten Editiermodul
setlocal.mod Ortsauswahl Basismodul
wrldclck.mod Weltuhr Basismodul