8.1.5 Funktionen
Um während des Evaluierungsprozesses Umgebungswerte einsetzen zu können,
stellt der Document Generator einige Funktionen zur Verfügung,
die in Vorlagen oder Instanzen genutzt werden können:
&base(file name);-
löscht die Pfadinformation und Erweiterung eines Dateinamens, z.B.:
&base(/home/bscw/www/faq.dtm); ergibt faq
- &rel(path);
-
erzeugt einen relativen Pfadnamen, z.B.:
Wenn &rel(/Images); in einer Vorlage, die ein Dokument /faq/index.htm erzeugt,
einen Bilderordner bezeichnet, so wird der Ausdruck in ../Images umgewandelt.
Soll dagegen ein Dokument /faq/question/install.htm erzeugt werden, so liefert die Funktion
../../Images.
- &size(file name, [B|K|M|G]);
gibt die Größe der angegeben Datei in Bytes, Kilobytes, Megabytes oder
Gigabytes zurück, z. B.:
&size(/Download/bscw34.exe, M); -> 8.43 - &date(format);
-
setzt die aktuelle Tageszeit ein. In dem Parameter format können folgende
Formatierungszeichen verwendet werden:
| Zeichen | Bedeutung |
|---|
%a | Abkürzung für den Wochentag | %A | Wochentag | %b | Abkürzung für den Monatsnamen | %B | Monatsname | %c | Standarddarstellung für Datum und Uhrzeit | %d | Tag im Monat als Dezimalzahl [01,31] | %H | Stunde als Dezimalzahl (24 Stunden) [00,23] | %I | Stunde als Dezimalzahl (12 Stunden) [01,12] | %j | Tag im Jahr als Dezimalzahl [001,366] | %m | Monat als Dezimalzahl [01,12] | %M | Minute als Dezimalzahl [00,59] | %p | entweder AM oder PM | %S | Sekunden als Dezimalzahl [00,60] | %U | Wochennummer im Jahr (Sonntag ist der erste
Tag in der Woche) [00,53]. Alle Tage in einem neuen Jahr, die
dem ersten Sonntag vorausgehen, sind in Woche 0. | %w | Wochentag als Zahl [0(Sonntag),6] | %W | Wochennummer im Jahr (Montag ist der erste
Tag in der Woche) [00,53] | %x | Standarddarstellung für Datum | %X | Standarddarstellung für Uhrzeit | %y | Jahr ohne Jahrhundert [00,99] | %Y | Jahr mit Jahrhundert | %Z | Name der Zeitzone | %% | das Zeichen "%" |
Zum Beispiel:
Am 10.10.2004 ergibt &date(%B %Y); -> Oktober 2004
|