Dates

Every Qgoda document or asset has a date property, either implicitely or explicitely.

Specifying the Document Date

The variable asset.date contains the date of the document as seconds since the epoch. If you want to use it in a document, you should always explicitely specify in the document front matter:

---
title: Qgoda Rocks!
date: 2018-11-07
---
It's a sad and beautiful world.

The way you specify the date is pretty much free-form, and you can also include the hour, minutes and seconds. See https://metacpan.org/pod/Date::Parse#EXAMPLE-DATES for various supported formats.

If you do not specify an explicit value for the date and time of a document it defaults to the last modification time of the originating file.

Using the Date

You can use the date and time like any other template variable:

Document created: [% asset.date %].

This would generate output like "Document created: 1541622661". The number 1541622661 are the seconds since the epoch. That is great for computers but not so great for humans. But you can do better by calling methods of the magic date object:

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:

As you can see, a leading i (think: integer) stands for numbers as regular integers. Without it, they are zero-padded.