Python Glossary English

все Python 3osфункция

os.path.getmtime

os.path — метаданные (stat)

Возвращает время последнего изменения файла (секунды с эпохи, float).

Синтаксис

os.path.getmtime(path)

Точность зависит от файловой системы: у FAT она две секунды, поэтому сравнение «файл изменился» по равенству времени ненадёжно, и сборочные инструменты сравнивают ещё и размер. Время отсчитывается в секундах с эпохи UTC; для читаемого вида передайте его в datetime.fromtimestamp. Если нужна наносекундная точность, используйте os.stat(path).st_mtime_ns.

Примеры

import os
import time
print(os.path.getmtime(os.__file__) > 0)   # → True
print(os.path.getmtime(os.__file__) == os.stat(os.__file__).st_mtime)   # → True: getmtime — это os.stat(path).st_mtime
print(os.path.getmtime(os.__file__) <= time.time())   # → True: файл изменён не позже текущего момента
print(time.strftime('%Y-%m-%d', time.localtime(os.path.getmtime(os.__file__))))   # → дата последнего изменения, например 2026-05-14
print(os.path.getmtime('нет-такого-файла'))   # → FileNotFoundError

См. также

Частые ошибки

Открыть в полном глоссарииdocs.python.orgСообщить о неточности