summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorPhilipp Bosch <hello@pb.io>2019-03-21 15:20:09 +0100
committerTim Graham <timograham@gmail.com>2019-03-21 10:20:09 -0400
commit0b8abd7cdf1a5bae96dd0640af10ad504f104d06 (patch)
treec6c160a39581c6146d63c7078fdfd0b344787799 /docs
parent8f1cc7e9e61758475ddd6586e0fede4af1ca0e8d (diff)
Used monospace font in date template filter format character docs.
Helps distinguish between lowercase L and uppercase I.
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/templates/builtins.txt78
1 files changed, 39 insertions, 39 deletions
diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt
index 7aed6ee6fe..9509377a24 100644
--- a/docs/ref/templates/builtins.txt
+++ b/docs/ref/templates/builtins.txt
@@ -1342,83 +1342,83 @@ Available format strings:
Format character Description Example output
================ ======================================== =====================
**Day**
-d Day of the month, 2 digits with ``'01'`` to ``'31'``
+``d`` Day of the month, 2 digits with ``'01'`` to ``'31'``
leading zeros.
-j Day of the month without leading ``'1'`` to ``'31'``
+``j`` Day of the month without leading ``'1'`` to ``'31'``
zeros.
-D Day of the week, textual, 3 letters. ``'Fri'``
-l Day of the week, textual, long. ``'Friday'``
-S English ordinal suffix for day of the ``'st'``, ``'nd'``, ``'rd'`` or ``'th'``
+``D`` Day of the week, textual, 3 letters. ``'Fri'``
+``l`` Day of the week, textual, long. ``'Friday'``
+``S`` English ordinal suffix for day of the ``'st'``, ``'nd'``, ``'rd'`` or ``'th'``
month, 2 characters.
-w Day of the week, digits without ``'0'`` (Sunday) to ``'6'`` (Saturday)
+``w`` Day of the week, digits without ``'0'`` (Sunday) to ``'6'`` (Saturday)
leading zeros.
-z Day of the year. ``0`` to ``365``
+``z`` Day of the year. ``0`` to ``365``
**Week**
-W ISO-8601 week number of year, with ``1``, ``53``
+``W`` ISO-8601 week number of year, with ``1``, ``53``
weeks starting on Monday.
**Month**
-m Month, 2 digits with leading zeros. ``'01'`` to ``'12'``
-n Month without leading zeros. ``'1'`` to ``'12'``
-M Month, textual, 3 letters. ``'Jan'``
-b Month, textual, 3 letters, lowercase. ``'jan'``
-E Month, locale specific alternative
+``m`` Month, 2 digits with leading zeros. ``'01'`` to ``'12'``
+``n`` Month without leading zeros. ``'1'`` to ``'12'``
+``M`` Month, textual, 3 letters. ``'Jan'``
+``b`` Month, textual, 3 letters, lowercase. ``'jan'``
+``E`` Month, locale specific alternative
representation usually used for long
date representation. ``'listopada'`` (for Polish locale, as opposed to ``'Listopad'``)
-F Month, textual, long. ``'January'``
-N Month abbreviation in Associated Press ``'Jan.'``, ``'Feb.'``, ``'March'``, ``'May'``
+``F`` Month, textual, long. ``'January'``
+``N`` Month abbreviation in Associated Press ``'Jan.'``, ``'Feb.'``, ``'March'``, ``'May'``
style. Proprietary extension.
-t Number of days in the given month. ``28`` to ``31``
+``t`` Number of days in the given month. ``28`` to ``31``
**Year**
-y Year, 2 digits. ``'99'``
-Y Year, 4 digits. ``'1999'``
-L Boolean for whether it's a leap year. ``True`` or ``False``
-o ISO-8601 week-numbering year, ``'1999'``
+``y`` Year, 2 digits. ``'99'``
+``Y`` Year, 4 digits. ``'1999'``
+``L`` Boolean for whether it's a leap year. ``True`` or ``False``
+``o`` ISO-8601 week-numbering year, ``'1999'``
corresponding to the ISO-8601 week
number (W) which uses leap weeks. See Y
for the more common year format.
**Time**
-g Hour, 12-hour format without leading ``'1'`` to ``'12'``
+``g`` Hour, 12-hour format without leading ``'1'`` to ``'12'``
zeros.
-G Hour, 24-hour format without leading ``'0'`` to ``'23'``
+``G`` Hour, 24-hour format without leading ``'0'`` to ``'23'``
zeros.
-h Hour, 12-hour format. ``'01'`` to ``'12'``
-H Hour, 24-hour format. ``'00'`` to ``'23'``
-i Minutes. ``'00'`` to ``'59'``
-s Seconds, 2 digits with leading zeros. ``'00'`` to ``'59'``
-u Microseconds. ``000000`` to ``999999``
-a ``'a.m.'`` or ``'p.m.'`` (Note that ``'a.m.'``
+``h`` Hour, 12-hour format. ``'01'`` to ``'12'``
+``H`` Hour, 24-hour format. ``'00'`` to ``'23'``
+``i`` Minutes. ``'00'`` to ``'59'``
+``s`` Seconds, 2 digits with leading zeros. ``'00'`` to ``'59'``
+``u`` Microseconds. ``000000`` to ``999999``
+``a`` ``'a.m.'`` or ``'p.m.'`` (Note that ``'a.m.'``
this is slightly different than PHP's
output, because this includes periods
to match Associated Press style.)
-A ``'AM'`` or ``'PM'``. ``'AM'``
-f Time, in 12-hour hours and minutes, ``'1'``, ``'1:30'``
+``A`` ``'AM'`` or ``'PM'``. ``'AM'``
+``f`` Time, in 12-hour hours and minutes, ``'1'``, ``'1:30'``
with minutes left off if they're zero.
Proprietary extension.
-P Time, in 12-hour hours, minutes and ``'1 a.m.'``, ``'1:30 p.m.'``, ``'midnight'``, ``'noon'``, ``'12:30 p.m.'``
+``P`` Time, in 12-hour hours, minutes and ``'1 a.m.'``, ``'1:30 p.m.'``, ``'midnight'``, ``'noon'``, ``'12:30 p.m.'``
'a.m.'/'p.m.', with minutes left off
if they're zero and the special-case
strings 'midnight' and 'noon' if
appropriate. Proprietary extension.
**Timezone**
-e Timezone name. Could be in any format,
+``e`` Timezone name. Could be in any format,
or might return an empty string, ``''``, ``'GMT'``, ``'-500'``, ``'US/Eastern'``, etc.
depending on the datetime.
-I Daylight Savings Time, whether it's ``'1'`` or ``'0'``
+``I`` Daylight Savings Time, whether it's ``'1'`` or ``'0'``
in effect or not.
-O Difference to Greenwich time in hours. ``'+0200'``
-T Time zone of this machine. ``'EST'``, ``'MDT'``
-Z Time zone offset in seconds. The ``-43200`` to ``43200``
+``O`` Difference to Greenwich time in hours. ``'+0200'``
+``T`` Time zone of this machine. ``'EST'``, ``'MDT'``
+``Z`` Time zone offset in seconds. The ``-43200`` to ``43200``
offset for timezones west of UTC is
always negative, and for those east of
UTC is always positive.
**Date/Time**
-c ISO 8601 format. (Note: unlike others ``2008-01-02T10:30:00.000123+02:00``,
+``c`` ISO 8601 format. (Note: unlike others ``2008-01-02T10:30:00.000123+02:00``,
formatters, such as "Z", "O" or "r", or ``2008-01-02T10:30:00.000123`` if the datetime is naive
the "c" formatter will not add timezone
offset if value is a naive datetime
(see :class:`datetime.tzinfo`).
-r :rfc:`5322` formatted date. ``'Thu, 21 Dec 2000 16:01:07 +0200'``
-U Seconds since the Unix Epoch
+``r`` :rfc:`5322` formatted date. ``'Thu, 21 Dec 2000 16:01:07 +0200'``
+``U`` Seconds since the Unix Epoch
(January 1 1970 00:00:00 UTC).
================ ======================================== =====================