Time related utilities and helper functions.
-
heat.openstack.common.timeutils.advance_time_delta(timedelta)[source]
Advance overridden time using a datetime.timedelta.
-
heat.openstack.common.timeutils.advance_time_seconds(seconds)[source]
Advance overridden time by seconds.
-
heat.openstack.common.timeutils.clear_time_override()[source]
Remove the overridden time.
-
heat.openstack.common.timeutils.delta_seconds(before, after)[source]
Compute the difference in seconds between two date, time, or
datetime objects (as a float, to microsecond resolution).
-
heat.openstack.common.timeutils.is_newer_than(after, seconds)[source]
Return True if after is newer than seconds.
-
heat.openstack.common.timeutils.is_older_than(before, seconds)[source]
Return True if before is older than seconds.
-
heat.openstack.common.timeutils.is_soon(dt, window)[source]
Determines if time is going to happen in the next window seconds.
Params dt: | the time |
Params window: | minimum seconds to remain to consider the time not soon |
Returns: | True if expiration is within the given duration |
-
heat.openstack.common.timeutils.iso8601_from_timestamp(timestamp)[source]
Returns a iso8601 formated date from timestamp
-
heat.openstack.common.timeutils.isotime(at=None)[source]
Stringify time in ISO 8601 format
-
heat.openstack.common.timeutils.marshall_now(now=None)[source]
Make an rpc-safe datetime with microseconds.
Note: tzinfo is stripped, but not required for relative times.
-
heat.openstack.common.timeutils.normalize_time(timestamp)[source]
Normalize time in arbitrary timezone to UTC naive object
-
heat.openstack.common.timeutils.parse_isotime(timestr)[source]
Parse time from ISO 8601 format
-
heat.openstack.common.timeutils.parse_strtime(timestr, fmt='%Y-%m-%dT%H:%M:%S.%f')[source]
Turn a formatted time back into a datetime.
-
heat.openstack.common.timeutils.set_time_override(override_time=datetime.datetime(2013, 8, 8, 17, 36, 58, 677944))[source]
Override utils.utcnow to return a constant time or a list thereof,
one at a time.
-
heat.openstack.common.timeutils.strtime(at=None, fmt='%Y-%m-%dT%H:%M:%S.%f')[source]
Returns formatted utcnow.
-
heat.openstack.common.timeutils.unmarshall_time(tyme)[source]
Unmarshall a datetime dict.
-
heat.openstack.common.timeutils.utcnow()[source]
Overridable version of utils.utcnow.
-
heat.openstack.common.timeutils.utcnow_ts()[source]
Timestamp version of our utcnow function.