date(1) date(1)
NAME
date - Datum und Uhrzeit ausgeben oder Systemuhr stellen
SYNTAX
date [-u] [+format] Format 1
date [-a [-] ssss.fff] [-u] [neuesdatum] Format 2
BESCHREIBUNG
date schreibt das aktuelle Datum und die Uhrzeit auf die Standardaus-
gabe (Format 1). Das Format, in dem date Datum und Uhrzeit ausgibt,
hängt vom Wert der Umgebungsvariablen LCTIME bzw., wenn diese leer
oder nicht definiert ist, vom Wert der Umgebungsvariablen LANG ab.
Sind LCTIME und LANG beide leer bzw. nicht definiert, ist die ent-
sprechende Datenbasis nicht vorhanden oder hat eine der NLS-Umgebungs-
variablen einen ungültigen Wert, dann verhält sich date, als wäre das
System nicht internationalisiert, d. h., es gibt Datum und Uhrzeit im
amerikanischen Format aus.
Als Systemverwalter können Sie mit date außerdem die Systemuhr stellen
(Format 2). Dies sollten Sie aber nur im Einbenutzer-Betrieb tun, wenn
alle Dateisysteme abgehängt sind. Andernfalls kann es zu Inkonsisten-
zen in den Dateisystemen kommen.
Arbeitsweise
Das System arbeitet mit der Weltzeit UTC (Universal Time Coordinated;
gleichbedeutend mit GMT - Greenwich Mean Time). date wandelt die UTC
in die Ortszeit um und umgekehrt. Ist die Umgebungsvariable TZ defi-
niert und die Option -u nicht gesetzt, so wird sie zur Bestimmung der
Zeitzone bzw. zur Umrechnung der UTC in die Ortszeit verwendet (siehe
sh(1), "Standard-Variablen der Shell").
OPTIONEN
Format 1: Datum und Uhrzeit ausgeben lassen
date [-u] [+format]
Kein Argument angegeben:
date gibt das aktuelle Datum und die Uhrzeit in der aktuell gül-
tigen internationalisierten Umgebung aus.
-u date gibt das aktuelle Datum und die Uhrzeit in Greenwich-Zeit
aus.
Wenn die Option -u angegeben ist, dann wird die Angabe +format
ignoriert.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
date(1) date(1)
+format
Mit dem Argument format bestimmen Sie das Ausgabeformat von date.
Enthält format Leer- bzw. Tabulatorzeichen oder sonstige Sonder-
zeichen der Shell, die die Shell nicht interpretieren soll, dann
schließen Sie format in Hochkommas ein: +'format'.
format ist dem Format des ersten Arguments der C-Funktion bzw.
der awk-Funktion printf() ähnlich [siehe awk(1), printf(1) und
die C-Funktion printf(3S)].
format erlaubt es, mit Hilfe von Feldbezeichnern die Ausgabe von
date zu formatieren.
Feldbezeichner sind von der Form %buchstabe. Sie werden bei der
Ausgabe durch ihren Wert ersetzt. Alle Zeichen, die nicht Teil
eines Feldbezeichners sind, werden unverändert ausgegeben. Am
Schluß der Ausgabe wird auf jeden Fall ein Neue-Zeile-Zeichen
ausgegeben.
In der folgenden Übersicht sind die möglichen Feldbezeichner auf-
gelistet. Zwischen den Feldbezeichnern %h und %b besteht kein
Unterschied; aus Kompatibilitätsgründen wurden jedoch beide
Bezeichner beibehalten.
_________________________________________________________________
| %n | Neue-Zeile-Zeichen |
|______|_________________________________________________________|
| %t | Tabulatorzeichen |
|______|_________________________________________________________|
| %c | Datum und Uhrzeit im Standard-Format der aktuell gülti-|
| | gen internationalisierten Umgebung |
|______|_________________________________________________________|
| %C | Jahrhundert (2stellig, die ersten beiden Ziffern der |
| | Jahreszahl, 00-99) |
|______|_________________________________________________________|
| %D | Datum im Format %m/%d/%y |
|______|_________________________________________________________|
| %x | Datum im Format der aktuell gültigen internationalen |
| | Umgebung |
|______|_________________________________________________________|
| %y | Jahr (2stellig, die letzten beiden Ziffern der Jahres- |
| | zahl, 00-99) |
|______|_________________________________________________________|
| %Y | Jahr (4stellig, alle Ziffern der Jahreszahl) |
|______|_________________________________________________________|
| %m | Monat (01 bis 12) |
|______|_________________________________________________________|
| %h | Monat (in Buchstaben, abgekürzt) im Format der aktuell |
| | gültigen internationalisierten Umgebung |
|______|_________________________________________________________|
| %b | wie %h |
|______|_________________________________________________________|
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
date(1) date(1)
_________________________________________________________________
| %B | Monat (in Buchstaben, ausgeschrieben) im Format der |
| | aktuell gültigen internationalen Umgebung |
|______|_________________________________________________________|
| %W | Woche im Jahr (00 bis 53, Montag ist der erste Tag in |
| | der Woche). Alle Tage vor dem ersten Montag im Januar |
| | gehören zur Woche 0. |
|______|_________________________________________________________|
| %V | Woche im Jahr (01 bis 53, Montag ist der erste Tag in |
| | der Woche). Die erste Woche im Januar wird als Woche 1 |
| | gezählt, wenn sie mindestens 4 Tage enthält. Andern- |
| | falls zählt diese Woche als Woche 53 zum Vorjahr (nach |
| | ISO 8601). |
|______|_________________________________________________________|
| %U | Woche im Jahr (00 bis 53, Sonntag ist der erste Tag in |
| | der Woche). Alle Tage vor dem ersten Sonntag im Januar |
| | gehören zur Woche 0. |
|______|_________________________________________________________|
| %j | Tag im Jahr (001 bis 366) |
|______|_________________________________________________________|
| %d | Tag im Monat (01 bis 31) |
|______|_________________________________________________________|
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98
date(1) date(1)
_________________________________________________________________
| %e | Tag im Monat (1 bis 31), bei einstelligen Datumsangaben|
| | wird ein Blank vorangestellt |
|______|_________________________________________________________|
| %a | Wochentag (in Buchstaben, abgekürzt) im Format der |
| | aktuell gültigen internationalisierten Umgebung |
|______|_________________________________________________________|
| %A | Wochentag (in Buchstaben, ausgeschrieben) im Format der|
| | aktuell gültigen internationalisierten Umgebung |
|______|_________________________________________________________|
| %w | Wochentag (0 bis 6, Sonntag = 0) |
|______|_________________________________________________________|
| %u | Wochentag (1 bis 7, Montag = 1) |
|______|_________________________________________________________|
| %R | Uhrzeit im Format %H:%M |
|______|_________________________________________________________|
| %T | Uhrzeit im Format %H:%M:%S |
|______|_________________________________________________________|
| %X | Uhrzeit im Format der aktuell gültigen internationali- |
| | sierten Umgebung |
|______|_________________________________________________________|
| %r | Uhrzeit in 12-Stunden-Notation: %I:%M:%S %p |
|______|_________________________________________________________|
| %H | Stunde (00 bis 23) |
|______|_________________________________________________________|
| %I | Stunde (01 bis 12) |
|______|_________________________________________________________|
| %p | Ante-meridiem- bzw. Post-meridiem-Affix im Format der |
| | aktuell gültigen internationalisierten Umgebung |
|______|_________________________________________________________|
| %M | Minute (00 bis 59) |
|______|_________________________________________________________|
| %S | Sekunde (00 bis 61) |
|______|_________________________________________________________|
| %Z | Name der Zeitzone oder keine Ausgabe, falls keine Zeit-|
| | zone vorhanden ist (abhängig von der Umgebungsvariablen|
| | TZ, siehe sh(1), "Standard-Variablen der Shell") |
|______|_________________________________________________________|
Falls in Ihrer lokalen Umgebung eine alternative Darstellung
(z. B. vor und nach Christus) definiert ist, können Sie diese
über modifizierte Feldbezeichner abrufen. Modifizierte Feldbe-
zeichner sind von der Form %Ebuchstabe bzw. %Obuchstabe. In der
folgenden Übersicht sind die möglichen modifizierten Feldbezeich-
ner aufgelistet.
Ist keine alternative Darstellung definiert, geben alle modifi-
zierten Feldbezeichner den Wert des jeweiligen nicht modifizier-
ten Feldbezeichners aus.
Seite 4 Reliant UNIX 5.44 Gedruckt 11/98
date(1) date(1)
_________________________________________________________________
| %Ec | Datum und Uhrzeit im alternativen Format |
|______|_________________________________________________________|
| %EC | Name des Zeitabschnitts (z. B. "Jahr") in der alterna- |
| | tiven Darstellung |
|______|_________________________________________________________|
| %Ex | Datum im alternativen Format |
|______|_________________________________________________________|
| %EX | Uhrzeit im alternativen Format |
|______|_________________________________________________________|
| %Ey | Jahr, mit dem der Zeitabschnitt in der alternativen |
| | Darstellung beginnt |
|______|_________________________________________________________|
| %EY | Jahr in der alternativen Darstellung |
|______|_________________________________________________________|
| %Od | Tag im Monat in alternativer Zifferndarstellung |
|______|_________________________________________________________|
| %Oe | Tag im Monat in alternativer Zifferndarstellung |
|______|_________________________________________________________|
| %OH | Stunde (24-Stunden Uhr) in alternativer Zifferndarstel-|
| | lung |
|______|_________________________________________________________|
| %OI | Stunde (12-Stunden Uhr) in alternativer Zifferndarstel-|
| | lung |
|______|_________________________________________________________|
| %Om | Monat in alternativer Zifferndarstellung |
|______|_________________________________________________________|
| %OM | Minuten in alternativer Zifferndarstellung |
|______|_________________________________________________________|
| %OS | Sekunden in alternativer Zifferndarstellung |
|______|_________________________________________________________|
| %Ou | Wochentag im alternativen Format (Montag = 1) |
|______|_________________________________________________________|
| %OU | Woche im Jahr im alternativer Zifferndarstellung (Regel|
| | wie %U) |
|______|_________________________________________________________|
| %OV | Woche im Jahr in alternativer Zifferndarstellung (Regel|
| | wie %V) |
|______|_________________________________________________________|
| %Ow | Wochentag im alternativen Format (Sonntag = 0) |
|______|_________________________________________________________|
| %OW | Woche im Jahr in alternativer Zifferndarstellung (Regel|
| | wie %W) |
|______|_________________________________________________________|
| %Oy | Jahr im alternativen Format |
|______|_________________________________________________________|
Seite 5 Reliant UNIX 5.44 Gedruckt 11/98
date(1) date(1)
Format 2: Systemuhr stellen
date [-a [-] ssss.fff] [-u] [neuesdatum]
Dieses Format ist nur für den Systemverwalter bestimmt.
Mit diesem Format können Sie entweder die Uhr nachstellen oder das
Datum neu setzen.
-a [-] ssss.fff
Die Uhr des Systems wird ssss Sekunden und fff Sekundenbruchteile
nachgestellt. Die Uhr kann vor oder zurück (-) gestellt werden.
Die Korrektur wird durchgeführt, indem die Systemuhr so lange
beschleunigt oder verlangsamt wird, bis die angegebene Differenz
ausgeglichen ist (ssss darf nicht größer als 2146 sein).
-u Datum und Uhrzeit werden in Greenwich-Zeit gesetzt (siehe auch
Format 1, -u).
neuesdatum
[mmdd]HHMM | mmddHHMM[cc]yy date setzt das Datum und die Uhrzeit
des Systems auf den angegebenen Wert. Für [mmdd]HHMM oder
mmddHHMM[cc]yy geben Sie an:
_____________________________________________________________________
| mm | dd | HH | MM | cc | yy |
|__________|__________|__________|__________|__________|_____________|
| Monat | Tag | Stunde | Minute | Jahrhun- | Jahr (letzte|
| (01 - 12)| (01 - 31)| (00 - 23)| (00 - 59)| dert -1 | 2 Ziffern) |
|__________|__________|__________|__________|__________|_____________|
mmdd nicht angegeben:
date bezieht die angegebene Zeit HHMM auf den aktuellen Tag.
cc nicht angegeben:
date bezieht das angegebene Datum mmddHHMMyy auf das aktuelle
Jahrhundert.
Die Systemuhr sollten Sie nur im Einbenutzer-Betrieb stellen, wenn
alle Dateisysteme abgehängt sind. Andernfalls kann es zu Inkonsisten-
zen in den Dateisystemen kommen.
Seite 6 Reliant UNIX 5.44 Gedruckt 11/98
date(1) date(1)
FEHLERMELDUNGEN
Format 2
date: no permission.
Sie wollten als normaler Benutzer die Systemuhr stellen. Dies
darf jedoch nur der Systemverwalter.
date: bad conversion.
Sie wollten die Systemuhr stellen, haben date jedoch im falschen
Format aufgerufen.
UMGEBUNGSVARIABLEN
TZ Die Umgebungsvariable TZ enthält, falls sie definiert ist, Infor-
mationen über die Zeitzonen. date benutzt die Variable TZ zur
Bestimmung der Zeitzone bzw. zur Umrechnung der Weltzeit UTC
(Universal Time Coordinated) in die Ortszeit und umgekehrt.
Der Wert von TZ besteht aus
- der Standard-Zeitzone,
- der Differenz zur UTC in Stunden und
- eventuell der Sommerzeitzone mit Zeitangaben zur Umstellung
von Standard-Zeit auf Sommerzeit und zurück.
Eine detaillierte Beschreibung zu TZ finden Sie bei sh(1),
"Standard-Variablen der Shell".
INTERNATIONALE UMGEBUNG
Die Umgebungsvariable LCMESSAGES bestimmt die Sprache der Meldungs-
texte. Die Umgebungsvariable LCTIME legt fest, in welcher Sprache und
in welchem Format das Datum und die Uhrzeit ausgegeben werden bzw. der
Wert der Datums- und Zeitkonstanten ausgegeben wird. LCCTYPE bestimmt
die Zeichenklassen und die Zeichenkonvertierung.
Wenn LCMESSAGES, LCTIME oder LCCTYPE nicht oder als leere Zeichen-
kette definiert ist, wird der Wert von LANG als Standardwert für die
jeweils nicht gesetzte oder leere Variable herangezogen. Ist auch LANG
nicht oder als leere Zeichenkette definiert, verhält sich das System
so, als wäre es nicht internationalisiert.
Hat eine der Variablen für die internationale Umgebung einen ungülti-
gen Wert, verhält sich das System so, als wäre keine Variable gesetzt.
Die Umgebungsvariable LCALL bestimmt die gesamte internationale Umge-
bung. LCALL hat Vorrang vor allen anderen Umgebungsvariablen im
Bereich der Internationalisierung.
Seite 7 Reliant UNIX 5.44 Gedruckt 11/98
date(1) date(1)
BEISPIELE
Beispiel 1: Datum und Uhrzeit ausgeben lassen (LANG=DeDE.88591)
[Format 1]
Wenn Sie am 27. März 1997 um 7.43 Uhr MET date ohne Argument aufrufen,
erhalten Sie, falls die Systemuhr die richtige Zeit angibt, die Aus-
gabe:
Do 27.Mär.1997, 07:43:10 MET
Mit der Kommandozeile
date '+DATUM: %d.%m.%y%n ZEIT: %H:%M:%S'
erzeugen Sie folgende Ausgabe:
DATUM: 27.03.97
ZEIT: 07:43:10
Beispiel 2: Systemuhr stellen [Format 2]
Sie arbeiten unter der Systemverwalter-Kennung root. Sie möchten das
Datum und die Uhrzeit auf den 17. März 1989, 16 Uhr 30 setzen. Dazu
gehen Sie in den Einbenutzer-Betrieb und hängen alle Dateisysteme ab.
Dann geben Sie ein:
# date 0317163089
Rufen Sie date im Jahr 1989 auf, dann können Sie die Jahresangabe weg-
lassen.
SIEHE AUCH
cal(1), sysadm(1M), ctime(3C), printf(3S), LCTIME(4), environ(5).
Seite 8 Reliant UNIX 5.44 Gedruckt 11/98