Pycom FiPy, Руководство пользователя, Страница: 378 / 496

utime – Time Functions
The
utime
module provides functions for getting the current time and date, measuring time
intervals, and for delays.
Time Epoch : Pycom’s ESP32 port uses standard for POSIX systems epoch of
1970-01-01
00:00:00 UTC
.
Maintaining actual calendar date/time
This requires a Real Time Clock (RTC). On systems with underlying OS (including some
RTOS), an RTC may be implicit. Setting and maintaining actual calendar time is
responsibility of OS/RTOS and is done outside of MicroPython, it just uses OS API to query
date/time. On baremetal ports however system time depends on
machine.RTC()
object. The
current calendar time may be set using
machine.RTC().datetime(tuple)
function, and
maintained by following means:
By a backup battery (which may be an additional, optional component for a particular
board).
Using networked time protocol (requires setup by a port/user).
Set manually by a user on each power-up (many boards then maintain RTC time across
hard resets, though some may require setting it again in such case).
If actual calendar time is not maintained with a system/MicroPython RTC, functions below
which require reference to current absolute time may behave not as expected.
Functions
utime.gmtime([secs])
Convert a time expressed in seconds since the Epoch (see above) into an 8-tuple which
contains:
(year, month, mday, hour, minute, second, weekday, yearday)
If
secs
is not
provided or
None
, then the current time from the RTC is used.
year
includes the century (for example 2014).
month
is 1-12
mday
is 1-31
hour
is 0-23
minute
is 0-59
second
is 0-59
weekday
is 0-6 for Mon-Sun
5.3.14 utime
378