timeutils#

Functions for handling dates and times.

In [1]: import pydarkstar.timeutils

The most useful functions are:

pydarkstar.timeutils.timestamp()
pydarkstar.timeutils.datetime()

In [2]: pydarkstar.timeutils.timestamp('01/01/2015 00:00:00')
Out[2]: 1420070400.0

In [3]: pydarkstar.timeutils.datetime('01/01/2015 00:00:00')
Out[3]: datetime.datetime(2015, 1, 1)

See also

datetime, datetime.datetime

Classes#

pydarkstar.timeutils.DatetimeToTimestamp

Convert datetime object to timestamp.

Functions#

`pydarkstar.timeutils.str_to_datetime`	Convert string to datetime object.
`pydarkstar.timeutils.datetime_to_str`	Convert datetime object to string.
`pydarkstar.timeutils.datetime_to_timestamp`	Convert datetime object to timestamp.
`pydarkstar.timeutils.timestamp_to_datetime`	Convert timestamp to datetime object.
`pydarkstar.timeutils.datetime`	Convert anything (within reason) to a datetime object.
`pydarkstar.timeutils.timestamp`	Convert anything (within reason) to a timestamp.

Documentation#

pydarkstar.timeutils.str_to_datetime(date_string)[source]#

Convert string to datetime object.

Parameters: date_string (str) – string with format '%m/%d/%Y %H:%M:%S'
Returns: datetime object
Return type: datetime.datetime

In [1]: pydarkstar.timeutils.str_to_datetime('01/01/2015 00:00:00')
Out[1]: datetime.datetime(2015, 1, 1, 0, 0)

See also

datetime.datetime.strptime()

pydarkstar.timeutils.datetime_to_str(datetime_obj)[source]#

Convert datetime object to string.

Parameters: datetime_obj (datetime.datetime) – datetime object
Returns: datetime as string
Return type: str

In [1]: pydarkstar.timeutils.datetime_to_str(datetime.datetime(2015, 1, 1))
Out[1]: '01/01/2015 00:00:00'

See also

datetime.datetime.strftime()

class pydarkstar.timeutils.DatetimeToTimestamp[source]#

Convert datetime object to timestamp.

Calculates the total seconds since 01/01/1970.

Warning

Don’t use this class directly.

epoch = datetime.datetime(1970, 1, 1, 0, 0)#: 01/01/1970

pydarkstar.timeutils.datetime_to_timestamp = <pydarkstar.timeutils.DatetimeToTimestamp object>#

Convert datetime object to timestamp.

Parameters: datetime_obj (datetime.datetime) – datetime object
Returns: datetime as integer
Return type: int

In [1]: pydarkstar.timeutils.datetime_to_timestamp(datetime.datetime(2015, 1, 1, 0, 0))
Out[1]: 1420070400.0

See also

datetime.timedelta.total_seconds()

pydarkstar.timeutils.timestamp_to_datetime(stamp)[source]#

Convert timestamp to datetime object.

Parameters: stamp (int, float) – seconds since epoch (01/01/1970)
Returns: datetime object
Return type: datetime.datetime

In [1]: pydarkstar.timeutils.timestamp_to_datetime(1420070400)
Out[1]: datetime.datetime(2015, 1, 1, 0, 0)

See also

datetime.timedelta.utcfromtimestamp()

pydarkstar.timeutils.datetime(*args, **kwargs)[source]#

Convert anything (within reason) to a datetime object.

When there are multiple arguments:

the datetime.datetime constructor is called

If there is only one argument:

if it is a datetime.datetime it is returned
if it is a str it is passed to pydarkstar.timeutils.str_to_datetime()
if it is a int it is passed to pydarkstar.timeutils.timestamp_to_datetime()
if it is a float it is passed to pydarkstar.timeutils.timestamp_to_datetime()

Parameters

args – positional arguments
kwargs – keyword arguments

In [1]: pydarkstar.timeutils.datetime(datetime.datetime(2015, 1, 1))
Out[1]: datetime.datetime(2015, 1, 1)

In [2]: pydarkstar.timeutils.datetime('01/01/2015 00:00:00')
Out[2]: datetime.datetime(2015, 1, 1)

In [3]: pydarkstar.timeutils.datetime(1420070400.0)
Out[3]: datetime.datetime(2015, 1, 1)

In [4]: pydarkstar.timeutils.datetime(1420070400)
Out[4]: datetime.datetime(2015, 1, 1)

pydarkstar.timeutils.timestamp(*args, **kwargs)[source]#

Convert anything (within reason) to a timestamp.

Parameters

args – positional arguments
kwargs – keyword arguments

Passes arguments to pydarkstar.timeutils.datetime()
Passes result to pydarkstar.timeutils.datetime_to_timestamp

In [1]: pydarkstar.timeutils.timestamp('01/01/2015 00:00:00')
Out[1]: 1420070400.0

In [2]: pydarkstar.timeutils.timestamp(datetime.datetime(2015, 1, 1))
Out[2]: 1420070400.0

In [3]: pydarkstar.timeutils.timestamp(1420070400.0)
Out[3]: 1420070400.0

In [4]: pydarkstar.timeutils.timestamp(1420070400)
Out[4]: 1420070400.0