summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorCurtis Maloney <curtis@tinbrain.net>2013-09-21 13:54:48 +1000
committerTim Graham <timograham@gmail.com>2013-09-21 06:56:17 -0400
commitb8e7730f3e25a0bcabca82bf5a2e06411ffcc92e (patch)
treed06dd090acddf8b8e748ed7b0258e59e63f0b77b /docs
parentb541cf24d03b694bccce337cbc93aaa0c3a08307 (diff)
[1.5.x] Fixed #21133 -- Clarifed documentation about strftime formatting.
Backport of 43a2ec7999 from master
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/class-based-views/mixins-date-based.txt5
-rw-r--r--docs/ref/templates/builtins.txt4
2 files changed, 9 insertions, 0 deletions
diff --git a/docs/ref/class-based-views/mixins-date-based.txt b/docs/ref/class-based-views/mixins-date-based.txt
index 75f2a77615..d1979b9e55 100644
--- a/docs/ref/class-based-views/mixins-date-based.txt
+++ b/docs/ref/class-based-views/mixins-date-based.txt
@@ -4,6 +4,11 @@ Date-based mixins
.. currentmodule:: django.views.generic.dates
+.. note::
+ All the date formatting attributes in these mixins use
+ :func:`~time.strftime` format characters. Do not try to use the format
+ characters from the :ttag:`now` template tag as they are not compatible.
+
YearMixin
---------
diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt
index 1572b15604..0e9f586d1e 100644
--- a/docs/ref/templates/builtins.txt
+++ b/docs/ref/templates/builtins.txt
@@ -1201,6 +1201,10 @@ Formats a date according to the given format.
Uses a similar format as PHP's ``date()`` function (http://php.net/date)
with some differences.
+.. note::
+ These format characters are not used in Django outside of templates. They
+ were designed to be compatible with PHP to ease transitioning for designers.
+
Available format strings:
================ ======================================== =====================