Функция time() модуля time в Python

Получить время в секундах

Синтаксис:

import time

time.time()
time.time_ns()

Параметры:

нет.

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

функция time.time() - float,
функция time.time_ns() - int.

Описание:

Функция time() модуля time вернет время в секундах с начала эпохи как число с плавающей запятой.

Конкретная дата эпохи и обработка високосных секунд зависит от платформы. В Windows и большинстве систем Unix периодом времени является 1 января 1970 года, 00:00:00 (UTC), и високосные секунды не учитываются во времени с начала эпохи. Это обычно называют временем Unix.

Чтобы узнать, какова эпоха на данной платформе, посмотрите на time.gmtime(0).

Обратите внимание, что, хотя время всегда возвращается как число float, не все системы предоставляют время с большей точностью, чем 1 секунда. Хотя эта функция обычно возвращает неубывающие значения, она может возвращать меньшее значение, чем предыдущий вызов, если системные часы были переведены назад между двумя вызовами.

Число, возвращаемое функцией time.time(), можно преобразовать в более распространенный формат времени (год, месяц, день, час и т. д.) в UTC, передав его в функцию time.gmtime() или по местному времени, передав его функции time.localtime() . В обоих случаях возвращается объект time.struct_time, из которого компоненты календарной даты могут быть доступны как атрибуты.

Функция time.time_ns() работает аналогично time.time(), но возвращает время как целое число наносекунд с начала эпохи.Работает не на всех платформах.

Улучшение в Python 3.13: В Windows функция time.time() теперь использует часы GetSystemTimePrecisionAsFileTime() для разрешения лучше 1 мкс вместо часов GetSystemTimeAsFileTime(), которые имеют разрешение 15,6 мс.

Примеры использования `time.time()`

>>> import time
>>> sec = time.time()
>>> sec
# 1587806227.4762378
>>> struct = time.localtime(sec)
>>> time.strftime('%d.%m.%Y %H:%M', struct)
# '25.04.2020 12:31'