LC_TIME(4) LC_TIME(4)
NAME
LCTIME - Landesspezifische Zeit- und Datumszeichenketten
SYNTAX
/usr/lib/locale/locale/LCTIME
BESCHREIBUNG
Für jede Locale (internationale Umgebung) gibt es eine lesbare Datei,
in der Informationen über die jeweiligen Datums- und Uhrzeitformate
enthalten sind. Diese Datei liegt im Verzeichnis
/usr/lib/locale/locale und heißt LCTIME. Diese Datei enthält u. a.
Einträge zu den Monatsnamen (inklusive deren Abkürzungen); den Namen
der Wochentage (inklusive deren Abkürzungen); den Standardzeichenket-
ten zur Angabe des lokalen Zeit- (%X) und Datumsformats (%x).
Definition der Locale LC_TIME
Für die Locale-Definition werden die folgenden obligatorischen Schlüs-
selwörter erkannt:
abmon Definiert die Abkürzungen für die Monatsnamen gemäß dem
Felddeskriptor %b. (Umwandlungsanweisung in den Funktionen
strftime(), wcsftime() und strptime()). Der Operand
besteht aus 12 durch Semikolons voneinander getrennten
Zeichenketten, die jeweils in doppelten Anführungszeichen
stehen. Die erste Zeichenkette ist die Abkürzung für den
ersten Monat im Jahr (Januar), die zweite ist die Abkür-
zung für den zweiten Monat usw.
mon Definiert die ausgeschriebenen Monatsnamen gemäß dem Feld-
deskriptor %B. Der Operand besteht aus 12 durch Semikolons
voneinander getrennten Zeichenketten, die jeweils in dop-
pelten Anführungszeichen stehen. Die erste Zeichenkette
ist der ausgeschriebene Name des ersten Monats im Jahr
(Januar), die zweite ist der Name des zweiten Monats usw.
abday Definiert die Abkürzungen für die Wochentage gemäß dem
Felddeskriptor %a. Der Operand besteht aus sieben durch
Semikolons voneinander getrennten Zeichenketten, die
jeweils in doppelten Anführungszeichen stehen. Die erste
Zeichenkette ist die Abkürzung für den Wochentag, der dem
Sonntag entspricht, die zweite ist die Abkürzung für den
Wochentag, der dem Montag entspricht usw.
day Definiert die ausgeschriebenen Namen der Wochentage gemäß
dem Felddeskriptor %A. Der Operand besteht aus sieben
durch Semikolons voneinander getrennten Zeichenketten, die
jeweils in doppelten Anführungszeichen stehen. Die erste
Zeichenkette ist der ausgeschriebene Name des Wochentags,
der dem Sonntag entspricht, die zweite ist der Name des
Wochentags, der dem Montag entspricht usw.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
LC_TIME(4) LC_TIME(4)
tfmt Definiert die entsprechende Darstellung der Uhrzeit gemäß
dem Felddeskriptor %X. Der Operand besteht aus einer Zei-
chenkette und kann jede beliebige Kombination aus Zeichen
und Felddeskriptoren enthalten. Ferner kann die Zeichen-
kette Escape-Folgen enthalten.
dfmt Definiert die entsprechende Darstellung des Datums gemäß
dem Felddeskriptor %x. Der Operand besteht aus einer Zei-
chenkette und kann jede beliebige Kombination aus Zeichen
und Felddeskriptoren enthalten. Ferner kann die Zeichen-
kette Escape-Folgen enthalten.
dtfmt Definiert die entsprechende Darstellung von Datum und Uhr-
zeit gemäß dem Felddeskriptor %c. Der Operand besteht aus
einer Zeichenkette und kann jede beliebige Kombination aus
Zeichen und Felddeskriptoren enthalten. Ferner kann die
Zeichenkette Escape-Folgen (\\, \a, \b, \f, \n, \r, \t,
\v) enthalten.
ampm Definiert die entsprechenden Darstellungen für a.m. (vor-
mittags) und p.m. (nachmittags) gemäß dem Felddeskriptor
%p. Der Operand besteht aus zwei durch ein Semikolon
getrennten Zeichenketten, die jeweils in doppelten Anfüh-
rungszeichen stehen. Die erste Zeichenkette stellt die
Angabe für a.m. und die zweite Zeichenkette die Angabe für
p.m. dar.
tfmtampm Definiert die entsprechende Darstellung der Uhrzeit im
12-Stunden-Format mit ampm gemäß dem Felddeskriptor %r.
Der Operand besteht aus einer Zeichenkette und kann jede
beliebige Kombination aus Zeichen und Felddeskriptoren
enthalten. Wenn die Zeichenkette leer ist, wird das 12-
Stunden-Format in der Locale nicht unterstützt.
era Definiert die Zählweise und Darstellung der Jahre für jede
Ära (Zeitabschnitt) in einer Locale. Der Operand besteht
aus durch Semikolons voneinander getrennten Zeichenketten.
Jede Zeichenkette ist ein Segment für die Beschreibung
einer Ära mit dem Format:
direction:offset:startdate:enddate:eraname:eraformat
Hierbei gelten die unten aufgeführten Definitionen. Es kön-
nen so viele Segmente für die Beschreibung von Ären verwen-
det werden, wie zu deren Beschreibung erforderlich sind.
Hinweis: Der Beginn der Ära ist nicht zwangsläufig der
früheste Zeitpunkt in diesem Zeitabschnitt, sondern kann
auch der späteste Zeitpunkt sein. So beginnt nach unserer
Zeitrechnung die Ära vor Christus (v. Chr.) mit dem Tag
vor dem 1. Januar A. D. (n. Chr.) und die Jahreszahlen
nehmen zu, je weiter das Datum zurück liegt.
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
LC_TIME(4) LC_TIME(4)
direction Entweder ein Pluszeichen (+) oder ein Minus-
zeichen (-). Das Pluszeichen gibt an, daß die
Jahre, die näher zum Anfangsdatum startdate
liegen, niedrigere Zahlen haben, als diejeni-
gen, die näher zum Enddatum enddate liegen.
Das Minuszeichen gibt an, daß die Jahre, die
näher zum Anfangsdatum startdate liegen,
höhere Zahlen haben, als diejenigen, die näher
zum Enddatum enddate liegen.
offset Die Jahreszahl, die am nächsten zum Anfangsda-
tum startdate der Ära liegt gemäß dem Feldde-
skriptor %Ey.
startdate Ein Datum im Format yyy/mm/dd, mit dem die Ära
beginnt. Hierbei sind yyyy, mm und dd die Zah-
len für das Jahr, den Monat bzw. den Tag.
Jahre vor dem Jahr 1 n. Chr. werden durch
negative Zahlen dargestellt.
enddate Das Datum, mit dem die Ära endet (im gleichen
Format wie das Anfangsdatum startdate), oder
einer der beiden Sonderwerte -* oder +*. Der
Wert -* gibt an, daß das Enddatum dem Anfang
der Ära entspricht. Der Wert +* gibt an, daß
das Enddatum dem Ende der Ära entspricht.
eraname Eine Zeichenkette, die für die Bezeichnung der
Ära steht, gemäß dem Felddeskriptor %EC.
eraformat Eine Zeichenkette für das Format der Jahresan-
gabe in der Ära gemäß dem Felddeskriptor %EY.
eradfmt Definiert das Datumsformat in der alternativen Schreib-
weise der Ära gemäß dem Felddeskriptor %Ex.
eratfmt Definiert das entsprechende alternative Uhrzeitformat der
Locale gemäß dem Felddeskriptor %EX.
eradtfmt Definiert das entsprechende alternative Datums- und Uhr-
zeitformat der Locale gemäß dem Felddeskriptor %Ec.
altdigits Definiert alternative Symbole für Ziffern gemäß dem Feld-
deskriptorzeichen %O. Der Operand besteht aus durch Semi-
kolons voneinander getrennten Zeichenketten, die jeweils
in doppelten Anführungszeichen stehen. Die erste Zeichen-
kette ist das alternative Symbol, das der Null entspricht,
die zweite Zeichenkette ist das Symbol, das der Eins ent-
spricht usw. Bis zu 100 Zeichenketten für alternative Sym-
bole können angegeben werden. Das Zeichen %O gibt an, daß
anstelle des Wertes die Zeichenkette verwendet wird, die
dem über den Felddeskriptor angegebenen Wert entspricht.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98
LC_TIME(4) LC_TIME(4)
copy Gibt den Namen einer vorhandenen Locale an, die als Defi-
nition für diese Kategorie verwendet werden soll. Wenn
dieses Schlüsselwort angegeben wird, darf kein anderes
Schlüsselwort mehr angegeben werden.
Pro Zeile ist eine Zeichenkette enthalten. Zwischenraumzeichen werden
auf jeden Fall interpretiert. Die Zeichenketten müssen in derselben
Reihenfolge in der Datei enthalten sein, in der sie in obiger Liste
aufgeführt sind.
Zugriff auf LC_TIME aus C-Programmen
Auf folgende Informationen kann zugegriffen werden. Diese entsprechen
Konstanten, die in <langinfo.h> definiert sind und als Argumente zur
Funktion nllanginfo() verwendet werden.
ABDAYx Die Abkürzungen für die Namen der Wochentage (zum Beispiel
Son), wobei x eine Zahl zwischen 1 und 7 ist.
DAYx Die ausgeschriebenen Namen der Wochentage (zum Beispiel
Sonntag), wobei x eine Zahl zwischen 1 und 7 ist.
ABMONx Die Abkürzungen für die Monatsnamen (zum Beispiel Jan),
wobei x eine Zahl zwischen 1 und 12 ist.
MONx Die ausgeshriebenen Monatsnamen (zum Beispiel Januar),
wobei x eine Zahl zwischen 1 und 12 ist.
DTFMT Die entsprechende Darstellung von Datum und Uhrzeit.
DFMT Die entsprechende Darstellung des Datums.
TFMT Die entsprechende Darstellung der Uhrzeit.
AMSTR Das entsprechende Affix für a.m.
PMSTR Das entsprechende Affix für p.m.
TFMTAMPM Die entsprechende Darstellung der Uhzeit im 12-Stunden-
Format mit AMSTR und PMSTR.
ERA Siehe Beschreibung von era in "Definition der Locale
LCTIME" oben.
ERADFMT Das Datumsformat für die Ära.
ERATFMT Das entsprechende alternative Uhrzeitformat der Locale
gemäß dem Felddeskriptor %EX.
ERADTFMT Das entsprechende alternative Datums- und Uhrzeitformat
der Locale gemäß dem Felddeskriptor %Ec.
Seite 4 Reliant UNIX 5.44 Gedruckt 11/98
LC_TIME(4) LC_TIME(4)
ALTDIGITS Die alternativen Symbole für Ziffern entsprechend dem
Umwandlungszeichen %0. Der Wert besteht aus durch Semiko-
lons voneinander getrennten Symbole. Das erste ist das
alternative Symbol, das der Null entspricht, das zweite
ist das Symbol, das der Eins entspricht usw. Bis zu 100
Symbole können angegeben werden.
Die folgende Tabelle zeigt die Entsprechungen zwischen den oben
beschriebenen Angaben und den Umwandlungsanweisungen, die vom Datums-
programm und den Funktionen strftime(), wcsftime() und strptime() ver-
wendet werden.
________________________________________________
| Localedef- | langinfo- | Umwandlungs- |
| Schlüsselwort | Konstante | anweisung |
|_______________|______________|________________|
| abmon | ABMONx | %b |
| mon | MON | %B |
| abday | ABDAYx | %a |
| day | DAYx | %A |
| tfmt | TFMT | %X |
| dfmt | DFMT | %x |
| dtfmt | DTFMT | %c |
| ampm | AMSTR | %p |
| ampm | PMSTR | %p |
| tfmtampm | TFMTAMPM | %r |
| era | ERA | %EC, %Ey, %EY |
| eradfmt | ERADFMT | %Ex |
| eratfmt | ERATFMT | %EX |
| eradtfmt | ERADTFMT | %Ec |
| altdigits | ALTDIGITS | %O |
|_______________|______________|________________|
Pro Zeile ist eine Zeichenkette enthalten. Zwischenraumzeichen werden
auf jeden Fall interpretiert. Die Zeichenketten müssen in derselben
Reihenfolge in der Datei enthalten sein, in der sie in obiger Liste
aufgeführt sind.
BEISPIELE
Beginn der Datei /usr/lib/locale/DeDE.88591/LCTIME:
Jan
Feb
...
Januar
Februar
...
Son
Mon
...
Sonntag
Montag
Seite 5 Reliant UNIX 5.44 Gedruckt 11/98
LC_TIME(4) LC_TIME(4)
...
%T %Z
%d.%m.%y
%a %d.%h.%Y, %T %Z
AM
PM
...
SIEHE AUCH
ctime(3C), nllanginfo(3C), setlocale(3C), strftime(3C), strptime(3C),
wcsftime(3C), langinfo(5).
Seite 6 Reliant UNIX 5.44 Gedruckt 11/98