summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJannis Leidel <jannis@leidel.info>2010-05-16 20:48:19 +0000
committerJannis Leidel <jannis@leidel.info>2010-05-16 20:48:19 +0000
commit06ab9eeaf5b43b7020b68363a23d1aab2e844aa6 (patch)
treec11b8d532553c6b067e4767738856ee25f5d273f
parent34ddcd9939568e7d19a0059647a9faaf36972083 (diff)
downloaddjango-06ab9eeaf5b43b7020b68363a23d1aab2e844aa6.tar.gz
Added notes about the two new date format specifiers (``c`` and ``u``) added in 1.2. Thanks for the patch, Ramiro Morales.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@13267 bcc190cf-cafb-0310-a4f2-bffc1f526a37
-rw-r--r--docs/ref/templates/builtins.txt13
-rw-r--r--docs/releases/1.2.txt16
2 files changed, 24 insertions, 5 deletions
diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt
index 393aab99e5..002aa3f416 100644
--- a/docs/ref/templates/builtins.txt
+++ b/docs/ref/templates/builtins.txt
@@ -723,6 +723,10 @@ escaped, because it's not a format character::
This would display as "It is the 4th of September".
+.. versionadded:: 1.2
+
+The ``c`` and ``u`` format specification characters were added in Django 1.2.
+
.. templatetag:: regroup
regroup
@@ -1132,8 +1136,8 @@ Formats a date according to the given format.
Given format can be one of the predefined ones ``DATE_FORMAT``,
``DATETIME_FORMAT``, ``SHORT_DATE_FORMAT`` or ``SHORT_DATETIME_FORMAT``,
-or a custom format, same as the `now`_ tag. Note that predefined formats may
-vary depending on the current locale.
+or a custom format, same as the :ttag:`now` tag. Note that predefined formats
+may vary depending on the current locale.
For example::
@@ -1780,11 +1784,12 @@ time
Formats a time according to the given format.
Given format can be the predefined one ``TIME_FORMAT``, or a custom format,
-same as the `now`_ tag. Note that the predefined format is locale depending.
+same as the :ttag:`now` tag. Note that the predefined format is locale-
+dependant.
The time filter will only accept parameters in the format string that relate
to the time of day, not the date (for obvious reasons). If you need to
-format a date, use the `date`_ filter.
+format a date, use the :tfilter:`date` filter.
For example::
diff --git a/docs/releases/1.2.txt b/docs/releases/1.2.txt
index d94aefed7e..4538b901cf 100644
--- a/docs/releases/1.2.txt
+++ b/docs/releases/1.2.txt
@@ -235,7 +235,7 @@ definitions to use the new prototype as soon as possible.
If your ``get_db_prep_*()`` methods made no use of the database
connection, you should be able to upgrade by renaming
``get_db_prep_value()`` to ``get_prep_value()`` and
-``get_db_prep_lookup()`` to ``get_prep_lookup()`. If you require
+``get_db_prep_lookup()`` to ``get_prep_lookup()``. If you require
database specific conversions, then you will need to provide an
implementation ``get_db_prep_*`` that uses the ``connection``
argument to resolve database-specific values.
@@ -997,3 +997,17 @@ If a user has JavaScript enabled in their browser, the interface for
inline objects in the admin now allows inline objects to be
dynamically added and removed. Users without JavaScript-enabled
browsers will see no change in the behavior of inline objects.
+
+New ``now`` template tag format specifier characters: ``c`` and ``u``
+---------------------------------------------------------------------
+
+The argument to the :ttag:`now` has gained two new format characters:
+``c`` to specify that a datetime value should be formatted in ISO 8601
+format, and ``u`` that allows output of the microseconds part of a
+datetime or time value.
+
+These are also available in others parts like the :tfilter:`date` and
+:tfilter:`time` template filters, the ``humanize`` template tag library
+and the new `format localization`_ framework.
+
+.. _format localization: `Improved localization`_