Python Glossary English

Python 3.4+pathlibфункция

pathlib.Path.stat()

метаданные

Возвращает структуру os.stat_result с метаданными файла: размер, время изменения, права доступа.

Синтаксис

p.stat()
p.stat().st_size
p.stat().st_mtime

stat() каждый раз лезет в файловую систему и кидает FileNotFoundError, если пути нет, — сохраняйте результат в переменную, а не дёргайте p.stat() отдельно под каждое поле. st_size — байты, st_mtime — float-секунды от эпохи (в дату переводится через datetime.fromtimestamp), а биты прав в st_mode на Windows почти ничего не значат. Для символической ссылки stat() показывает метаданные цели; чтобы увидеть саму ссылку, нужен lstat().

Примеры

from pathlib import Path
f = Path('stat_test.txt')
f.write_text('hello')
st = f.stat()
st.st_size # → 5
st.st_mtime # → float (unix timestamp)
import datetime
datetime.datetime.fromtimestamp(st.st_mtime) # → datetime объект
f.unlink()

См. также

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

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