[IMP] orm: dynamic dates

Author: kmagusiak

content/developer/reference/backend/orm.rst

@@ -1034,6 +1034,37 @@ and you can negate 1 using ``'!'`` (NOT).
 
 .. automethod:: odoo.fields.Domain.validate
 
+.. _reference/orm/dynamic_values:
+
+Dynamic values
+~~~~~~~~~~~~~~
+
+In the context of search domains, for
+:ref:`date and datetime fields <reference/fields/date>`, the value can be a
+moment relative to *now* in the timezone of the user. A simple language is
+provided to specify these dates. It is a string separated by spaces.
+The first term is optional and is "today" (at midnight) or "now".
+Then each term starts with "+" (add), "-" (subtract) or "=" (set) followed by
+an integer and date unit or a lower-case weekday.
+
+The date units are: "d" (days), "w" (weeks), "m" (months), "y" (years),
+"H" (hours), "M" (minutes), "S" (seconds).
+For weekdays, "+" and "-" mean next and previous weekday (unless we are already
+in that weekday) and "=" means in current week starting on Monday.
+
+When setting a date, the lower-units (hours, minutes and seconds) are set to 0.
+"=3H" means *at 3:00:00*, "=5d" means *5th day of current month at midnight*,
+"=1m" means *January, same day of month, at midnight*.
+
+.. example::
+
+    .. code-block:: python
+
+        Domain('some_date', '=', 'today')  # today
+        Domain('some_date', '=', '=1d')  # first day of month (at midnight)
+        Domain('create_date', '>', '-3d +1H')  # now - 3 days + 1 hour
+        Domain('create_date', '>=', '=monday -1w')  # Monday of the previous week
+
 Unlink
 ------