Python文件时间戳获取：os.stat的权威指南

import os
import datetime
import time

def get_file_timestamps(file_path):
    """
    获取指定文件的创建时间、修改时间和访问时间。

    Args:
        file_path (str): 文件的完整路径。

    Returns:
        dict: 包含 'creation_time', 'modification_time', 'access_time' 的字典，
              值为 datetime 对象。如果文件不存在或发生其他错误，则返回 None。
    """
    try:
        # 获取文件状态信息
        file_stat = os.stat(file_path)

        # 提取原始时间戳（Unix Epoch秒数）
        # st_ctime: 元数据修改时间 (Unix/Linux) 或创建时间 (Windows)
        # st_mtime: 文件内容修改时间
        # st_atime: 文件最后访问时间
        creation_timestamp = file_stat.st_ctime
        modification_timestamp = file_stat.st_mtime
        access_timestamp = file_stat.st_atime

        # 将时间戳转换为datetime对象，方便阅读和操作
        creation_datetime = datetime.datetime.fromtimestamp(creation_timestamp)
        modification_datetime = datetime.datetime.fromtimestamp(modification_timestamp)
        access_datetime = datetime.datetime.fromtimestamp(access_timestamp)

        return {
            "creation_time": creation_datetime,
            "modification_time": modification_datetime,
            "access_time": access_datetime
        }
    except FileNotFoundError:
        print(f"错误：文件 '{file_path}' 不存在。")
        return None
    except Exception as e:
        print(f"获取文件时间戳时发生未知错误：{e}")
        return None

# 示例用法
if __name__ == "__main__":
    # 定义一个测试文件路径
    test_file_name = "sample_document.txt"

    # 1. 创建一个测试文件（如果不存在）
    if not os.path.exists(test_file_name):
        with open(test_file_name, "w") as f:
            f.write("这是一个用于测试文件时间戳的示例文档。\n")
            f.write("初始内容。\n")
        print(f"已创建测试文件: {test_file_name}")
    else:
        print(f"测试文件已存在: {test_file_name}")

    # 2. 获取并打印初始文件时间戳
    print("\n--- 初始文件时间戳 ---")
    initial_timestamps = get_file_timestamps(test_file_name)
    if initial_timestamps:
        print(f"文件路径: {test_file_name}")
        print(f"创建时间 (st_ctime): {initial_timestamps['creation_time']}")
        print(f"修改时间 (st_mtime): {initial_timestamps['modification_time']}")
        print(f"访问时间 (st_atime): {initial_timestamps['access_time']}")

    # 3. 模拟文件内容修改，观察 st_mtime 变化
    print("\n--- 修改文件内容后 ---")
    time.sleep(1) # 暂停1秒，确保时间戳有明显变化
    with open(test_file_name, "a") as f:
        f.write("追加了新的内容。\n")
    modified_timestamps = get_file_timestamps(test_file_name)
    if modified_timestamps:
        print(f"文件路径: {test_file_name}")
        print(f"创建时间 (st_ctime): {modified_timestamps['creation_time']}")
        print(f"修改时间 (st_mtime): {modified_timestamps['modification_time']}")
        print(f"访问时间 (st_atime): {modified_timestamps['access_time']}")

    # 4. 模拟文件访问，观察 st_atime 变化（可能不明显，取决于系统配置）
    print("\n--- 访问文件内容后 ---")
    time.sleep(1) # 暂停1秒
    with open(test_file_name, "r") as f:
        _ = f.read() # 读取文件内容
    accessed_timestamps = get_file_timestamps(test_file_name)
    if accessed_timestamps:
        print(f"文件路径: {test_file_name}")
        print(f"创建时间 (st_ctime): {accessed_timestamps['creation_time']}")
        print(f"修改时间 (st_mtime): {accessed_timestamps['modification_time']}")
        print(f"访问时间 (st_atime): {accessed_timestamps['access_time']}")

    # 5. 尝试获取不存在的文件时间戳
    print("\n--- 尝试获取不存在的文件时间戳 ---")
    get_file_timestamps("non_existent_file.txt")

    # 可选：清理测试文件
    # try:
    #     os.remove(test_file_name)
    #     print(f"\n已删除测试文件: {test_file_name}")
    # except OSError as e:
    #     print(f"删除文件时发生错误: {e}")