Jedes Qgoda-Dokumnt hat eine Eigenschaft date, entweder implizit oder explizit.
Die Variable asset.date enthält das Datum des Dokuments als Sekunden seit der Epoche. Falls es verwendet werden soll, sollte das Datum immer explizit in der Titelei (engl. front matter*) angegeben werden:
---
title: Qgoda ist cool!
date: 2018-11-07
---
Die Welt ist traurig und schön.
Die Angabe des Datums ist sehr flexibel und sie kann auch die Stunde, Minute und Sekunde enthalten. Siehe https://metacpan.org/pod/Date::Parse#EXAMPLE-DATES für die unterstützten Datumsformate.
Falls kein expliziter Wert für Zeit und Datum eines Dokuments angegeben werden, wird das Datum der letzten Änderung an der zugrundeliegenden Datei verwendet.
Datum und Zeit können wie jede andere Template-Variable verwendet werden:
Document created: [% asset.date %].
Dies würde eine Ausgabe wie ”Dokument erzeugt: 1541622661” generiern. Die Zahl 1541622661 sind die Sekunden seit der Epoche. Das ist toll für Computer, aber nicht so toll für Menschen. Aber man kann es besser machen, indem man Methoden des magischen Datums-Objects verwendet:
Document created: [% asset.date.year %]-[% asset.date.month %]-[% asset.date.mday %]
This would now give something like "Document created: 2018-11-07".
The following methods are available:
| Name | Meaning |
|---|---|
| epoch | The seconds since the epoch. You can just as well omit it because it is the default. |
| year | The year part. |
| month | The zero-padded month, "01", "02", ... "12". |
| imonth | The month as a number, "1", "2", ... "12". |
| mday | The zero-padded day of the month, "01", "02", ... "31". |
| imday | The day of the month as a number , "1", "2", ... "31". |
| day | The same as mday. |
| iday | The same as imday. |
| hour | The zero-padded hour of the day, "01", "02", ... "24". |
| ihour | The hour of the day, "1", "2", ... "24". |
As you can see, a leading i (think: integer) stands for numbers as regular
integers. Without it, they are zero-padded.