Aktuelle Zeit- und Datumsangaben einfügen

(Auszug aus "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" von Thomas Schraitle)

Mit der Verarbeitungsanweisung <?dbtimestamp?> können Sie in Ihrem DocBook-Dokument aktuelle Zeit- und Datumsangaben einfügen. Dieses Verfahren wird von den DocBook-XSLT-Stylesheets (siehe Datei common/pi.xsl.) seit Version 1.61.1 unterstützt. Die einfachste Möglichkeit, das aktuelle Datum einzufügen, besteht in folgendem Code:

<para>Aktuelles Datum: <?dbtimestamp?>.</para>

Die Verarbeitungsanweisung <?dbtimestamp?> kann jedoch noch mehr: Mit Hilfe des Pseudoattributs format können Sie durch Buchstaben die Ausgabe beeinflussen (ähnlich wie die printf-Funktion). Somit wird durch die folgende Schreibweise der aktuelle Monat ausgegeben:

<para>Aktueller Monat: <?dbtimestampformat="B"?></para>

Beachten Sie, dass Sie einen XSLT-Prozessor benötigen, der die Datumsfunktionen von EXSLT beherrscht. Das sollte auf die gängigsten zutreffen (wie xsltproc, Saxon und Xalan).

Die folgenden Buchstaben sind ab Stylesheet-Version 1.61.1 verfügbar:  

Tabelle: Platzhalter für Zeit- und Datumsangaben

Zeichen Bedeutung
A der ausgeschriebene, lokalisierte Wochentag
a kennzeichnet den abgekürzten, lokalisierten Wochentag, wie Mon für Montag, Die für Dienstag usw.
B der ausgeschriebene, lokalisierte Monat
b der abgekürzte, lokalisierte Monat, wie Jan für Januar, Feb für Februar usw.
c gibt Datum und Uhrzeit im Format wie x und X zurück
d der Tag (engl. day) als Zahl zwischen 01 und 31
H die Stunden (engl. hour) als Zahl zwischen 00 und 23
M die Minuten als Zahl zwischen 00 und 59
m der aktuelle Monat als Zahl zwischen 01 und 12
j die Anzahl der vergangenen Tage im Jahr
S die Sekunden als Zahl zwischen 00 und 59
U gibt die Anzahl der Wochen des Jahres zurück; die Nummerierung erfolgt nach ISO 8601. Dabei enthält die erste Woche den ersten Dienstag des Jahres. Alle weiteren Wochen beginnen mit einem Montag.
w Zahl zwischen 1 bis 7, welche den Wochentag bestimmt; die Nummerierung startet mit 1 für Sonntag, 2 für Montag usw.
X Uhrzeit in folgendem Format: Stunden: Minuten: Sekunden[+|-] Zeitverschiebung
x Datum in folgendem Format: Jahr- Monat- Tag[+|-] Zeitverschiebung
Y Jahr als vierstellige Zahl

Mit Hilfe des Pseudoattributs padding können führende Nullen dargestellt (1, Standardwert) oder unterdrückt (0) werden. Dies trifft auf die Buchstaben d, H und m zu. Somit erzeugt eine Verarbeitungsanweisung wie

<?dbtimestamp format="A, d. B Y"?> 

ein Datum wie:

Donnerstag, 09. Juni 2003

während ein zusätzliches padding="0" folgende Ausgabe erzeugt:

Donnerstag, 9. Juni 2003

  

<< zurück vor >>
Tipp der data2type-Redaktion:
Zum Thema DocBook bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

Copyright © 2009 Millin Verlag
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.

Millin Verlag, Siebengebirgsring 36, 53797 Lohmar, info(at)millin.de