From defa3adbe898bfb10f497ae5c6cae7981bfa63c7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Thibault=20Delavall=C3=A9e?= Date: Mon, 16 Sep 2013 12:30:47 +0200 Subject: [PATCH] [DOC] read_group: added comments for the new formatting option bzr revid: tde@openerp.com-20130916103047-lpbf7czflyvgtonu --- doc/changelog.rst | 2 ++ openerp/osv/orm.py | 13 ++++++++++++- 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/doc/changelog.rst b/doc/changelog.rst index eadfe81b5e8..46f84364c76 100644 --- a/doc/changelog.rst +++ b/doc/changelog.rst @@ -6,6 +6,8 @@ Changelog `trunk` ------- +- Added support of custom group_by format and display format when using group_by + on a datetime field, using datetime_format context key - Improved ``html_email_clean`` in tools: better quote and signature finding, added shortening. - Cleaned and slightly refactored ``ir.actions.server``. The ``loop``, ``sms`` diff --git a/openerp/osv/orm.py b/openerp/osv/orm.py index f081e11b9e2..25ed8bdf861 100644 --- a/openerp/osv/orm.py +++ b/openerp/osv/orm.py @@ -2601,7 +2601,18 @@ class BaseModel(object): :param list groupby: fields by which the records will be grouped :param int offset: optional number of records to skip :param int limit: optional max number of records to return - :param dict context: context arguments, like lang, time zone + :param dict context: context arguments, like lang, time zone. A special + context key exist for datetime fields : ``datetime_format``. + context[``datetime_format``] = { + 'field_name': { + groupby_format: format for to_char (default: yyyy-mm) + display_format: format for displaying the value + in the result (default: MMM yyyy) + interval: day, month or year; used for begin + and end date of group_by intervals + computation (default: month) + } + } :param list orderby: optional ``order by`` specification, for overriding the natural sort ordering of the groups, see also :py:meth:`~osv.osv.osv.search`