--- a/src/pyams_utils/timezone/__init__.py Wed Nov 20 19:26:23 2019 +0100
+++ b/src/pyams_utils/timezone/__init__.py Fri Nov 22 18:51:37 2019 +0100
@@ -10,28 +10,32 @@
# FOR A PARTICULAR PURPOSE.
#
-__docformat__ = 'restructuredtext'
+"""PyAMS_utils.timezone package
+All datetime values should be stored in UTC to avoid any problem.
+Then values can be displayed to users using a specific timezone; by default, used timezone
+is the one specified into server settings via an IServerTimezone utility which is created
+automatically when initializing a new site.
-# import standard library
+There is no easy way to get user's timezone from it's browser settings; so the more common
+choice is to let users define their timezone in their profile's settings.
+"""
+
from datetime import datetime
import pytz
-
-
-# import interfaces
-from pyams_utils.interfaces.timezone import IServerTimezone
from pyramid.interfaces import IRequest
from zope.interface.common.idatetime import ITZInfo
-# import packages
from pyams_utils.adapter import adapter_config
+from pyams_utils.interfaces.timezone import IServerTimezone
from pyams_utils.registry import query_utility
+__docformat__ = 'restructuredtext'
+
+
GMT = pytz.timezone('GMT')
-_tz = pytz.timezone('Europe/Paris')
-tz = _tz
@adapter_config(context=IRequest, provides=ITZInfo)