Go to main content

Menu

Posted

Contents

Syntax

<txp:posted />

The posted tag is a single tag which is used to return the publication date of the article being displayed. The default format is determined by the settings specified in the ‘Date format’ or ‘Archive date format’ fields in the Preferences panel. It can be overridden with the format attribute.

Attributes

Tag will accept the following attributes (case-sensitive) as well as the global attributes :

calendar="calendar string"
Set the calendar (for example, chinese).
Values: any valid ICU calendar string.
Default: unset.
format="format string"
Override the default date format set in the Preferences panel.
Values: any valid strftime string values, since, iso8601 (ISO 8601 reference), w3cdtf (W3CDTF reference), or rfc822 (RFC 822 reference).
Default: the ‘Date format’ set in preferences.
gmt="boolean"
Return either local time (according to the set time zone preferences) or GMT.
Values: 0 (local time) or 1 (GMT).
Default: 0.
lang="ISO language code"
Format time string suitable for the specified language (locale).
Values: locales adhere to ISO-639.
Default: unset (time format set in the Preferences panel.

Examples

Example 1: ‘since’ format date setting

<p>
    Posted:
    <txp:posted format="since" />
</p>

This would result in the following HTML output:

<p>Posted: 29 days ago</p>

Example 2: Custom format date setting

<p>
    Posted:
    <txp:posted format="%b %d, %Y" />
</p>

This would result in the following HTML output:

<p>Posted: Feb 03, 2014</p>

Example 3: Extended custom format date setting

<p>
    Posted:
    <time datetime="<txp:posted format="iso8601" />">
        <txp:posted class="time-day" wraptag="span" format="%d" />
        <txp:posted class="time-month" wraptag="span" format="%b" />
        <txp:posted class="time-year" wraptag="span" format="%Y" />
    </time>
</p>

This would result in the following HTML output, which provides styling hooks for each date part:

<p>
    Posted:
    <time datetime="2014-02-03T10:43:39Z">
        <span class="time-day">03</span>
        <span class="time-month">Feb</span>
        <span class="time-year">2014</span>
    </time>
</p>

Genealogy

Version 4.0.4

class and wraptag attributes added.

If you notice any kind of problem with this page's construction or content (outdated information, typos, broken links, or whatever), open an issue to have it sorted. Or have a go at it yourself. :)