src/pyams_utils/timezone/__init__.py
branchdev-tf
changeset 408 cf2304af0fab
parent 292 b338586588ad
child 419 05ff71a02b2d
--- 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)