From: Jordi Boggiano <j.boggiano@seld.be>
Date: Wed, 20 Jun 2012 17:45:35 +0000 (+0200)
Subject: Add docs for date_modify
X-Git-Url: http://git.silmor.de/gitweb/?a=commitdiff_plain;h=ae85586e6f4cdac65c5d44a19881489081e9bccb;p=web%2Fkonrad%2Ftwig.git

Add docs for date_modify
---

diff --git a/doc/filters/date_modify.rst b/doc/filters/date_modify.rst
new file mode 100644
index 0000000..303263b
--- /dev/null
+++ b/doc/filters/date_modify.rst
@@ -0,0 +1,18 @@
+``date_modify``
+===============
+
+.. versionadded:: 1.9
+    The date_modify filter has been added in Twig 1.9.
+
+The ``date_modify`` filter modifies a date with a given modifier string:
+
+.. code-block:: jinja
+
+    {{ post.published_at|date_modify("+1 day")|date("m/d/Y") }}
+
+The ``date_modify`` filter accepts strings (it must be in a format supported by the
+`strtotime`_ function) or `DateTime`_ instances. You can easily combine it with the `date`_
+filter for formatting.
+
+.. _`strtotime`:    http://www.php.net/strtotime
+.. _`DateTime`:     http://www.php.net/DateTime