Navigation

  • index
  • modules |
  • next |
  • previous |
  • Sider 0.3.2 »
  • sider — Sider »

sider.datetime — Date and time related utilities¶

For minimum support of time zones, without adding any external dependencies e.g. pytz, Sider had to implement Utc class which is a subtype of datetime.tzinfo.

Because datetime module provided by the Python standard library doesn’t contain UTC or any other tzinfo subtype implementations. (A funny thing is that the documentation of datetime module shows an example of how to implement UTC tzinfo.)

If you want more various time zones support use the third-party pytz package.

class sider.datetime.FixedOffset(offset, name=None)¶

Fixed offset in minutes east from UTC.

>>> import datetime
>>> day = FixedOffset(datetime.timedelta(days=1))
>>> day
sider.datetime.FixedOffset(1440)
>>> day.tzname(None)
'+24:00'
>>> half = FixedOffset(-720)
>>> half
sider.datetime.FixedOffset(-720)
>>> half.tzname(None)
'-12:00'
>>> half.utcoffset(None)
datetime.timedelta(-1, 43200)
>>> zero = FixedOffset(0)
>>> zero.tzname(None)
'UTC'
>>> zero.utcoffset(None)
datetime.timedelta(0)
Parameters:
  • offset (numbers.Integral, datetime.timedelta) – the offset integer in minutes, or timedelta (from a minute to a day)
  • name (basestring) – an optional name. if not present, automatically generated
Raises:

exceptions.ValueError – when offset‘s precision is too short or too long

MAX_PRECISION = datetime.timedelta(1)¶

(datetime.timedelta) The maximum precision of utcoffset().

MIN_PRECISION = datetime.timedelta(0, 60)¶

(datetime.timedelta) The minimum precision of utcoffset().

sider.datetime.UTC = sider.datetime.Utc()¶

(Utc) The singleton instance of Utc.

class sider.datetime.Utc¶

The datetime.tzinfo implementation of UTC.

>>> from datetime import datetime
>>> utc = Utc()
>>> dt = datetime(2012, 3, 15, 0, 15, 30, tzinfo=utc)
>>> dt
datetime.datetime(2012, 3, 15, 0, 15, 30, tzinfo=sider.datetime.Utc())
>>> utc.utcoffset(dt)
datetime.timedelta(0)
>>> utc.dst(dt)
datetime.timedelta(0)
>>> utc.tzname(dt)
'UTC'
sider.datetime.ZERO_DELTA = datetime.timedelta(0)¶

(datetime.timedelta) No difference.

sider.datetime.total_seconds(timedelta)¶

For Python 2.6 compatibility. Equivalent to timedelta.total_seconds() method which was introduced in Python 2.7.

Parameters:timedelta (datetime.timedelta) – the timedelta
Returns:the total number of seconds contained in the duration
sider.datetime.utcnow()¶

The current time in UTC. The Python standard library also provides datetime.datetime.utcnow() function except it returns a naive datetime.datetime value. This function returns tz-aware datetime.datetime value instead.

>>> import datetime
>>> datetime.datetime.utcnow()  
datetime.datetime(...)
>>> utcnow()  
datetime.datetime(..., tzinfo=sider.datetime.Utc())
Returns:the tz-aware datetime value of the current time
Return type:datetime.datetime

Previous topic

sider.threadlocal — Thread locals

Next topic

sider.exceptions — Exception classes

This Page

  • Show Source

Quick search

Enter search terms or a module, class or function name.

Navigation

  • index
  • modules |
  • next |
  • previous |
  • Sider 0.3.2 »
  • sider — Sider »
© Copyright 2016, Hong Minhee. Created using Sphinx 1.3.5.