The zaqar.openstack.common.timeutils module

Time related utilities and helper functions.

advance_time_delta(timedelta)

Advance overridden time using a datetime.timedelta.

advance_time_seconds(seconds)

Advance overridden time by seconds.

clear_time_override()

Remove the overridden time.

delta_seconds(before, after)

Return the difference between two timing objects.

Compute the difference in seconds between two date, time, or datetime objects (as a float, to microsecond resolution).

is_newer_than(after, seconds)

Return True if after is newer than seconds.

is_older_than(before, seconds)

Return True if before is older than seconds.

is_soon(dt, window)

Determines if time is going to happen in the next window seconds.

Parameters:

• dt – the time
• window – minimum seconds to remain to consider the time not soon

Returns:

True if expiration is within the given duration

iso8601_from_timestamp(timestamp)

Returns an iso8601 formatted date from timestamp.

isotime(at=None, subsecond=False)

Stringify time in ISO 8601 format.

marshall_now(now=None)

Make an rpc-safe datetime with microseconds.

Note: tzinfo is stripped, but not required for relative times.

normalize_time(timestamp)

Normalize time in arbitrary timezone to UTC naive object.

parse_isotime(timestr)

Parse time from ISO 8601 format.

parse_strtime(timestr, fmt='%Y-%m-%dT%H:%M:%S.%f')

Turn a formatted time back into a datetime.

set_time_override(override_time=None)

Overrides utils.utcnow.

Make it return a constant time or a list thereof, one at a time.

Parameters:override_time – datetime instance or list thereof. If not given, defaults to the current UTC time.

strtime(at=None, fmt='%Y-%m-%dT%H:%M:%S.%f')

Returns formatted utcnow.

total_seconds(delta)

Return the total seconds of datetime.timedelta object.

Compute total seconds of datetime.timedelta, datetime.timedelta doesn’t have method total_seconds in Python2.6, calculate it manually.

unmarshall_time(tyme)

Unmarshall a datetime dict.

utcnow()

Overridable version of utils.utcnow.

utcnow_ts()

Timestamp version of our utcnow function.