# time¶

time and timing related functions

The time module is a strict subset of the CPython time module. So, code written in MicroPython will work in CPython but not necessarily the other way around.

time.monotonic() → float

Returns an always increasing value of time with an unknown reference point. Only use it to compare against other values from monotonic.

Returns: the current monotonic time float
time.sleep(seconds: float) → None

Sleep for a given number of seconds.

Parameters: seconds (float) – the time to sleep in fractional seconds
class time.struct_time(time_tuple: tuple)
time.time() → int

Return the current time in seconds since since Jan 1, 1970.

Returns: the current time int
time.monotonic_ns() → int

Return the time of the specified clock clk_id in nanoseconds.

Returns: the current time int
time.localtime(secs: int) → struct_time

Convert a time expressed in seconds since Jan 1, 1970 to a struct_time in local time. If secs is not provided or None, the current time as returned by time() is used. The earliest date for which it can generate a time is Jan 1, 2000.

Returns: the current time time.struct_time
time.mktime(t: struct_time) → int

This is the inverse function of localtime(). Its argument is the struct_time or full 9-tuple (since the dst flag is needed; use -1 as the dst flag if it is unknown) which expresses the time in local time, not UTC. The earliest date for which it can generate a time is Jan 1, 2000.

Returns: seconds int