Source code for falcon.util.time

"""Time and date utilities.

This module provides utility functions and classes for dealing with
times and dates. These functions are hoisted into the `falcon` module
for convenience::

    import falcon

    tz = falcon.TimezoneGMT()

"""

import datetime


[docs]class TimezoneGMT(datetime.tzinfo): """GMT timezone class implementing the :py:class:`datetime.tzinfo` interface.""" GMT_ZERO = datetime.timedelta(hours=0)
[docs] def utcoffset(self, dt): """Get the offset from UTC. Args: dt(datetime.datetime): Ignored Returns: datetime.timedelta: GMT offset, which is equivalent to UTC and so is aways 0. """ return self.GMT_ZERO
[docs] def tzname(self, dt): """Get the name of this timezone. Args: dt(datetime.datetime): Ignored Returns: str: "GMT" """ return 'GMT'
[docs] def dst(self, dt): """Return the daylight saving time (DST) adjustment. Args: dt(datetime.datetime): Ignored Returns: datetime.timedelta: DST adjustment for GMT, which is always 0. """ return self.GMT_ZERO