OpenQuizz
Une application de gestion des contenus pédagogiques
pytz Namespace Reference

Namespaces

 exceptions
 
 lazy
 
 reference
 
 tzfile
 
 tzinfo
 

Data Structures

class  _CountryNameDict
 
class  _CountryTimezoneDict
 
class  _FixedOffset
 
class  UTC
 

Functions

def ascii (s)
 
def open_resource (name)
 
def resource_exists (name)
 
def timezone (zone)
 
def FixedOffset (offset, _tzinfos={})
 

Variables

 OLSON_VERSION
 
 VERSION
 
 OLSEN_VERSION
 
 unicode
 
 ZERO
 
 HOUR
 
 hours
 
 UTC
 
 utc
 
 country_timezones
 
 country_names
 
 all_timezones
 
 all_timezones_set
 
 common_timezones
 
 common_timezones_set
 

Detailed Description

datetime.tzinfo timezone definitions generated from the
Olson timezone database:

    ftp://elsie.nci.nih.gov/pub/tz*.tar.gz

See the datetime section of the Python Library Reference for information
on how to use these modules.

Function Documentation

◆ ascii()

def ascii (   s)
>>> ascii('Hello')
'Hello'
>>> ascii('\N{TRADE MARK SIGN}') #doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
    ...
UnicodeEncodeError: ...
>>> ascii('Hello')
'Hello'
>>> ascii(u'Hello')
'Hello'
>>> ascii(u'\N{TRADE MARK SIGN}') #doctest: +IGNORE_EXCEPTION_DETAIL
Traceback (most recent call last):
    ...
UnicodeEncodeError: ...

◆ FixedOffset()

def pytz.FixedOffset (   offset,
  _tzinfos = {} 
)
return a fixed-offset timezone based off a number of minutes.

    >>> one = FixedOffset(-330)
    >>> one
    pytz.FixedOffset(-330)
    >>> str(one.utcoffset(datetime.datetime.now()))
    '-1 day, 18:30:00'
    >>> str(one.dst(datetime.datetime.now()))
    '0:00:00'

    >>> two = FixedOffset(1380)
    >>> two
    pytz.FixedOffset(1380)
    >>> str(two.utcoffset(datetime.datetime.now()))
    '23:00:00'
    >>> str(two.dst(datetime.datetime.now()))
    '0:00:00'

The datetime.timedelta must be between the range of -1 and 1 day,
non-inclusive.

    >>> FixedOffset(1440)
    Traceback (most recent call last):
    ...
    ValueError: ('absolute offset is too large', 1440)

    >>> FixedOffset(-1440)
    Traceback (most recent call last):
    ...
    ValueError: ('absolute offset is too large', -1440)

An offset of 0 is special-cased to return UTC.

    >>> FixedOffset(0) is UTC
    True

There should always be only one instance of a FixedOffset per timedelta.
This should be true for multiple creation calls.

    >>> FixedOffset(-330) is one
    True
    >>> FixedOffset(1380) is two
    True

It should also be true for pickling.

    >>> import pickle
    >>> pickle.loads(pickle.dumps(one)) is one
    True
    >>> pickle.loads(pickle.dumps(two)) is two
    True

◆ open_resource()

def pytz.open_resource (   name)
Open a resource from the zoneinfo subdir for reading.

Uses the pkg_resources module if available and no standard file
found at the calculated location.

It is possible to specify different location for zoneinfo
subdir by using the PYTZ_TZDATADIR environment variable.

◆ resource_exists()

def pytz.resource_exists (   name)
Return true if the given resource exists

◆ timezone()

def pytz.timezone (   zone)
Return a datetime.tzinfo implementation for the given timezone

>>> from datetime import datetime, timedelta
>>> utc = timezone('UTC')
>>> eastern = timezone('US/Eastern')
>>> eastern.zone
'US/Eastern'
>>> timezone(unicode('US/Eastern')) is eastern
True
>>> utc_dt = datetime(2002, 10, 27, 6, 0, 0, tzinfo=utc)
>>> loc_dt = utc_dt.astimezone(eastern)
>>> fmt = '%Y-%m-%d %H:%M:%S %Z (%z)'
>>> loc_dt.strftime(fmt)
'2002-10-27 01:00:00 EST (-0500)'
>>> (loc_dt - timedelta(minutes=10)).strftime(fmt)
'2002-10-27 00:50:00 EST (-0500)'
>>> eastern.normalize(loc_dt - timedelta(minutes=10)).strftime(fmt)
'2002-10-27 01:50:00 EDT (-0400)'
>>> (loc_dt + timedelta(minutes=10)).strftime(fmt)
'2002-10-27 01:10:00 EST (-0500)'

Raises UnknownTimeZoneError if passed an unknown zone.

>>> try:
...     timezone('Asia/Shangri-La')
... except UnknownTimeZoneError:
...     print('Unknown')
Unknown

>>> try:
...     timezone(unicode('\N{TRADE MARK SIGN}'))
... except UnknownTimeZoneError:
...     print('Unknown')
Unknown

Variable Documentation

◆ all_timezones

all_timezones

◆ all_timezones_set

all_timezones_set

◆ common_timezones

common_timezones

◆ common_timezones_set

common_timezones_set

◆ country_names

country_names

◆ country_timezones

country_timezones

◆ HOUR

HOUR

◆ hours

hours

◆ OLSEN_VERSION

OLSEN_VERSION

◆ OLSON_VERSION

OLSON_VERSION

◆ unicode

unicode

◆ UTC

UTC

◆ utc

utc

◆ VERSION

VERSION

◆ ZERO

ZERO