Source code for pyams_utils.timezone

#
# Copyright (c) 2008-2015 Thierry Florac <tflorac AT ulthar.net>
# All Rights Reserved.
#
# This software is subject to the provisions of the Zope Public License,
# Version 2.1 (ZPL).  A copy of the ZPL should accompany this distribution.
# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
# FOR A PARTICULAR PURPOSE.
#

"""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.

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
from pyramid.interfaces import IRequest
from zope.interface.common.idatetime import ITZInfo

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')


[docs]@adapter_config(context=IRequest, provides=ITZInfo) def tzinfo(request=None): # pylint: disable=unused-argument """request to timezone adapter There is no easy way to get timezone from a request. This adapter assumes that the timezone is given by a registered utility... """ util = query_utility(IServerTimezone) if util is not None: return pytz.timezone(util.timezone) return GMT
[docs]def tztime(value): """Convert datetime to local timezone :param datetime value: input datetime; value is assumed to be in GMT if no timezone is given """ if not value: return None if not isinstance(value, datetime): return value if not value.tzinfo: value = GMT.localize(value) return value.astimezone(tzinfo())
[docs]def gmtime(value): """Convert datetime to GMT Value is assumed to be in GMT if no timezone is given """ if not value: return None if not isinstance(value, datetime): return value if not value.tzinfo: value = GMT.localize(value) return value.astimezone(GMT)
[docs]def localgmtime(value): """Convert datetime to GMT Value is assumed to be in server timezone if none is given """ if not value: return None if not isinstance(value, datetime): return value if not value.tzinfo: value = tzinfo().localize(value) return value.astimezone(GMT)