From 06ab9eeaf5b43b7020b68363a23d1aab2e844aa6 Mon Sep 17 00:00:00 2001 From: Jannis Leidel Date: Sun, 16 May 2010 20:48:19 +0000 Subject: [PATCH] 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 --- docs/ref/templates/builtins.txt | 13 +++++++++---- docs/releases/1.2.txt | 16 +++++++++++++++- 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`_