vorhergehendes Kapitelrückwärtsaufwärtsvorwärtsnächste Kapitel  englisch   Inhalt    Index  

11.5 Funktionen

Um während des Evaluierungsprozesses Werte von Umgebungsvariablen einsetzen zu können, stellt der Document Generator einige Funktionen zur Verfügung, die in Vorlagen oder Instanzen benutzt werden können:

&base(Dateiname);
entfernt Pfadinformation und Erweiterung aus einem Dateinamen. Beispiel:
&base(/home/bscw/www/faq.dtm); -> faq

&rel(Pfad);
erzeugt einen relativen Pfadnamen aus einem absoluten Pfadnamen, und zwar relativ zu dem Dokument, das erzeugt werden soll (gesetzt im Evaluierungsparameter document). Beispiel: Wenn man den Funktionsausdruck &rel(/Images); in einer Vorlage benutzt, die ein Dokument /faq/index.htm erzeugt, so wird dieser Ausdruck in ../Images umgewandelt. Soll dagegen ein Dokument /faq/question/install.htm erzeugt werden, so wird der Ausdruck zu ../../Images ausgewertet.

&size(Dateiname, [B|K|M|G]);
liefert die Größe der angegeben Datei in Bytes, Kilobytes, Megabytes oder Gigabytes. Beispiel:
&size(/Download/bscw34.exe, M); -> 8.43

&date(Format);
liefert das aktuelle Datum und die Tageszeit. In dem Parameter Format können die folgenden Formatierungsanweisungen verwendet werden. Sie werden hier ohne die optionalen Angaben zu Feldbreite und Genauigkeit angegeben.

Anweisung   Bedeutung
%aAbkürzung für den Wochentag
%AWochentag
%bAbkürzung für den Monatsnamen
%BMonatsname
%cStandarddarstellung für Datum und Uhrzeit
%dTag im Monat als Dezimalzahl [01, 31]
%HStunde als Dezimalzahl (24 Stunden) [00, 23]
%IStunde als Dezimalzahl (12 Stunden) [01, 12]
%jTag im Jahr als Dezimalzahl [001, 366]
%mMonat als Dezimalzahl [01, 12]
%MMinute als Dezimalzahl [00, 59]
%pAM oder PM je nach Tageszeit
%SSekunde als Dezimalzahl [00, 60]
%UWochennummer im Jahr (Sonntag ist der erste Tag der Woche) [00, 53]. Alle Tage des Jahres, die dem ersten Sonntag vorausgehen, gehören zu Woche 0.
%wWochentag als Zahl [0 (Sonntag), 6]
%WWochennummer im Jahr (Montag ist der erste Tag der Woche) [00, 53]. Alle Tage des Jahres, die dem ersten Montag vorausgehen, gehören zu Woche 0.
%xStandarddarstellung für Datum
%XStandarddarstellung für Tageszeit
%yJahr ohne Jahrhundert [00, 99]
%YJahr mit Jahrhundert
%ZName der Zeitzone (oder leere Zeichenkette, wenn Zeitzone unbekannt ist)
%%das Zeichen ‚%

Beispiel: &date(%B %Y); ergibt am 10.10.2005 Oktober 2005.


 vorhergehendes Kapitelrückwärtsaufwärtsvorwärtsnächste Kapitel  englisch   Inhalt    Index