Модули и функции · встроенный MicroPython FEMM 5

time

Системное время и счётчики для длительности расчёта.

Условия работы

time/gmtime/localtime используют системную эпоху; в этой сборке Windows это Unix-эпоха 1970-01-01.
Для длительности применяйте ticks_diff(end,start), поскольку ticks-счётчики циклически переполняются. ticks_add выполняет согласованное циклическое сложение.
localtime и gmtime возвращают 8 полей (Y,M,D,h,m,s,weekday,yday): понедельник=0, номер дня года начинается с 1. Для текстового форматирования используйте datetime.strftime.

time.timeЧитает календарное время; перевод часов может менять разность меток.

time.time

time()

Читает календарное время; перевод часов может менять разность меток.

Аргументы

Аргументы не требуются.

Возвращаемое значение

Число секунд системного времени.

Пример

"Пример time.time.\nСреда: встроенный MicroPython FEMM 5.\nЧитает календарное время; перевод часов может менять разность меток.\nРезультат: Число секунд системного времени."

import time
assert time.time() > 0

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

time.time_nsЧитает системное время в целочисленном представлении.

time.time_ns

time_ns()

Читает системное время в целочисленном представлении.

Аргументы

Аргументы не требуются.

Возвращаемое значение

Целое число наносекунд от системной эпохи.

Пример

"Пример time.time_ns.\nСреда: встроенный MicroPython FEMM 5.\nЧитает системное время в целочисленном представлении.\nРезультат: Целое число наносекунд от системной эпохи."

import time
assert isinstance(time.time_ns(),int) and time.time_ns() > 0

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

time.gmtimeПреобразует системную метку в поля UTC.

time.gmtime

gmtime(secs=None)

Преобразует системную метку в поля UTC.

Аргументы

Аргументы вызова `time.gmtime`
Имя	Назначение и допустимые значения
`secs`	Секунды от эпохи; None/отсутствие означает сейчас.

Возвращаемое значение

Кортеж UTC из 8 полей: (year,month,day,hour,minute,second,weekday,yearday).

Пример

"Пример time.gmtime.\nСреда: встроенный MicroPython FEMM 5.\nПреобразует системную метку в поля UTC.\nРезультат: Кортеж UTC из 8 полей: (year,month,day,hour,minute,second,weekday,yearday)."

import time
assert time.gmtime(0)[:3] == (1970,1,1)

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

time.localtimeУчитывает часовой пояс системы FEMM.

time.localtime

localtime(secs=None)

Учитывает часовой пояс системы FEMM.

Аргументы

Аргументы вызова `time.localtime`
Имя	Назначение и допустимые значения
`secs`	Секунды от эпохи; None/отсутствие означает сейчас.

Возвращаемое значение

Кортеж локального времени из 8 полей: (year,month,day,hour,minute,second,weekday,yearday).

Пример

"Пример time.localtime.\nСреда: встроенный MicroPython FEMM 5.\nУчитывает часовой пояс системы FEMM.\nРезультат: Кортеж локального времени из 8 полей: (year,month,day,hour,minute,second,weekday,yearday)."

import time
assert 1 <= time.localtime()[1] <= 12

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

time.mktimeВыполняет обратное преобразование локального времени.

time.mktime

mktime(t)

Выполняет обратное преобразование локального времени.

Аргументы

Аргументы вызова `time.mktime`
Имя	Назначение и допустимые значения
`t`	Локальные календарные поля; принимаются последовательности длиной 8 или 9. Первые шесть полей задают дату и время.

Возвращаемое значение

Целое число секунд от эпохи.

Пример

"Пример time.mktime.\nСреда: встроенный MicroPython FEMM 5.\nВыполняет обратное преобразование локального времени.\nРезультат: Целое число секунд от эпохи."

import time
ts=1700000000
assert abs(time.mktime(time.localtime(ts))-ts) < 1

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

time.ticks_msЧитает счётчик миллисекунд. Время между отсчётами вычисляйте ticks_diff.

time.ticks_ms

ticks_ms()

Читает счётчик миллисекунд. Время между отсчётами вычисляйте ticks_diff.

Аргументы

Аргументы не требуются.

Возвращаемое значение

Целое значение циклического счётчика.

Пример

"Пример time.ticks_ms.\nСреда: встроенный MicroPython FEMM 5.\nЧитает счётчик миллисекунд. Время между отсчётами вычисляйте ticks_diff.\nРезультат: Целое значение циклического счётчика."

import time
a=time.ticks_ms()
b=time.ticks_ms()
assert time.ticks_diff(b,a) >= 0

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

time.ticks_usЧитает счётчик микросекунд. Время между отсчётами вычисляйте ticks_diff.

time.ticks_us

ticks_us()

Читает счётчик микросекунд. Время между отсчётами вычисляйте ticks_diff.

Аргументы

Аргументы не требуются.

Возвращаемое значение

Целое значение циклического счётчика.

Пример

"Пример time.ticks_us.\nСреда: встроенный MicroPython FEMM 5.\nЧитает счётчик микросекунд. Время между отсчётами вычисляйте ticks_diff.\nРезультат: Целое значение циклического счётчика."

import time
a=time.ticks_us()
b=time.ticks_us()
assert time.ticks_diff(b,a) >= 0

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

time.ticks_cpuЧитает портовый циклический счётчик ticks_cpu; единица зависит от реализации. Для измерений в миллисекундах используйте ticks_ms/ticks_diff.

time.ticks_cpu

ticks_cpu()

Читает портовый циклический счётчик ticks_cpu; единица зависит от реализации. Для измерений в миллисекундах используйте ticks_ms/ticks_diff.

Аргументы

Аргументы не требуются.

Возвращаемое значение

Целое значение циклического счётчика.

Пример

"Пример time.ticks_cpu.\nСреда: встроенный MicroPython FEMM 5.\nЧитает портовый циклический счётчик ticks_cpu; единица зависит от реализации. Для измерений в миллисекундах используйте ticks_ms/ticks_diff.\nРезультат: Целое значение циклического счётчика."

import time
a=time.ticks_cpu()
b=time.ticks_cpu()
assert time.ticks_diff(b,a) >= 0

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

time.ticks_diffУчитывает переполнение при достаточно близких отсчётах.

time.ticks_diff

ticks_diff(ticks1, ticks2)

Учитывает переполнение при достаточно близких отсчётах.

Аргументы

Аргументы вызова `time.ticks_diff`
Имя	Назначение и допустимые значения
`ticks1`	Более поздний отсчёт.
`ticks2`	Более ранний отсчёт того же счётчика.

Возвращаемое значение

Знаковая разность в единицах исходного счётчика.

Пример

"Пример time.ticks_diff.\nСреда: встроенный MicroPython FEMM 5.\nУчитывает переполнение при достаточно близких отсчётах.\nРезультат: Знаковая разность в единицах исходного счётчика."

import time
assert time.ticks_diff(time.ticks_add(100,25),100) == 25

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

time.ticks_addВычисляет будущий момент для ticks_diff.

time.ticks_add

ticks_add(ticks, delta)

Вычисляет будущий момент для ticks_diff.

Аргументы

Аргументы вызова `time.ticks_add`
Имя	Назначение и допустимые значения
`ticks`	Исходный отсчёт.
`delta`	Знаковое приращение в единицах счётчика.

Возвращаемое значение

Циклически приведённый целый отсчёт.

Пример

"Пример time.ticks_add.\nСреда: встроенный MicroPython FEMM 5.\nВычисляет будущий момент для ticks_diff.\nРезультат: Циклически приведённый целый отсчёт."

import time
assert time.ticks_diff(time.ticks_add(100,25),100) == 25

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Этот пример выполнен в установленном FEMM 5.

time.sleepПриостанавливает выполнение сценария; для UI-сценариев учитывайте блокировку потока.

time.sleep

sleep(duration)

Приостанавливает выполнение сценария; для UI-сценариев учитывайте блокировку потока.

Аргументы

Аргументы вызова `time.sleep`
Имя	Назначение и допустимые значения
`duration`	Неотрицательная длительность в секундах.

Возвращаемое значение

None.

Особенности вызова

Паузы не исполняются в автоматическом прогоне примеров.

Пример

"Пример time.sleep.\nСреда: встроенный MicroPython FEMM 5.\nПриостанавливает выполнение сценария; для UI-сценариев учитывайте блокировку потока.\nРезультат: None."

import time
time.sleep(0)

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

time.sleep_msПриостанавливает выполнение сценария; для UI-сценариев учитывайте блокировку потока.

time.sleep_ms

sleep_ms(duration)

Приостанавливает выполнение сценария; для UI-сценариев учитывайте блокировку потока.

Аргументы

Аргументы вызова `time.sleep_ms`
Имя	Назначение и допустимые значения
`duration`	Неотрицательная длительность в миллисекундах.

Возвращаемое значение

None.

Особенности вызова

Паузы не исполняются в автоматическом прогоне примеров.

Пример

"Пример time.sleep_ms.\nСреда: встроенный MicroPython FEMM 5.\nПриостанавливает выполнение сценария; для UI-сценариев учитывайте блокировку потока.\nРезультат: None."

import time
time.sleep_ms(0)

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

time.sleep_usПриостанавливает выполнение сценария; для UI-сценариев учитывайте блокировку потока.

time.sleep_us

sleep_us(duration)

Приостанавливает выполнение сценария; для UI-сценариев учитывайте блокировку потока.

Аргументы

Аргументы вызова `time.sleep_us`
Имя	Назначение и допустимые значения
`duration`	Неотрицательная длительность в микросекундах.

Возвращаемое значение

None.

Особенности вызова

Паузы не исполняются в автоматическом прогоне примеров.

Пример

"Пример time.sleep_us.\nСреда: встроенный MicroPython FEMM 5.\nПриостанавливает выполнение сценария; для UI-сценариев учитывайте блокировку потока.\nРезультат: None."

import time
time.sleep_us(0)

Ожидаемый результат. Проверки assert проходят без исключения.

Скачать пример · Ссылка на функцию

Фрагмент для указанного состояния документа; отдельный автоматический запуск этого примера не выполнялся.

Имена в установленной сборке

Перечень получен во встроенном интерпретаторе. Он включает функции, классы и константы. Ссылки ведут к контрактам; для прямого доступа ulab учитывайте условия этого раздела.

gmtimelocaltimemktimesleepsleep_mssleep_usticks_addticks_cputicks_diffticks_msticks_ustimetime_ns