Rust文件时间操作库filetime_creation使用指南

filetime_creation是一个专门用于高效创建和修改文件时间戳的Rust库，它提供了简单易用的API来操作文件的访问时间(atime)和修改时间(mtime)。

安装

在Cargo.toml中添加依赖：

[dependencies]
filetime_creation = "0.2"

基本用法

设置文件时间戳

use filetime_creation::{FileTime, set_file_times};
use std::fs::File;

fn main() -> std::io::Result<()> {
    let file = File::create("example.txt")?;
    
    // 设置访问时间和修改时间为当前时间
    let now = FileTime::now();
    set_file_times("example.txt", now, now)?;
    
    // 设置特定时间
    let custom_time = FileTime::from_unix_time(1_000_000_000, 0); // 2001-09-09 01:46:40
    set_file_times("example.txt", custom_time, custom_time)?;
    
    Ok(())
}

获取文件时间戳

use filetime_creation::metadata;

fn main() -> std::io::Result<()> {
    let meta = metadata("example.txt")?;
    
    println!("访问时间: {:?}", meta.accessed());
    println!("修改时间: {:?}", meta.modified());
    println!("创建时间: {:?}", meta.created());
    
    Ok(())
}

高级功能

批量修改文件时间

use filetime_creation::{FileTime, set_file_times};
use std::fs;
use std::path::Path;

fn update_dir_times(dir: &Path) -> std::io::Result<()> {
    let new_time = FileTime::now();
    
    for entry in fs::read_dir(dir)? {
        let entry = entry?;
        let path = entry.path();
        
        if path.is_dir() {
            update_dir_times(&path)?;
        }
        
        set_file_times(&path, new_time, new_time)?;
    }
    
    Ok(())
}

跨平台兼容性处理

use filetime_creation::{FileTime, set_file_times};
use std::fs::File;

fn set_file_time_safe(path: &str) -> std::io::Result<()> {
    // 确保文件存在
    let _ = File::open(path)?;
    
    // 设置时间戳
    let time = FileTime::from_unix_time(1_000_000_000, 0);
    set_file_times(path, time, time)
        .map_err(|e| {
            eprintln!("设置时间戳失败: {}", e);
            e
        })
}

完整示例代码

下面是一个综合使用filetime_creation库的完整示例：

use filetime_creation::{FileTime, set_file_times, metadata};
use std::fs::{self, File};
use std::path::Path;
use std::time::SystemTime;

fn main() -> std::io::Result<()> {
    // 1. 创建示例文件
    let file_path = "demo_file.txt";
    File::create(file_path)?;
    
    // 2. 设置文件时间戳为当前时间
    let now = FileTime::now();
    set_file_times(file_path, now, now)?;
    
    // 3. 获取并打印文件时间戳
    let meta = metadata(file_path)?;
    println!("初始时间戳:");
    println!("访问时间: {:?}", meta.accessed());
    println!("修改时间: {:?}", meta.modified());
    println!("创建时间: {:?}", meta.created());
    
    // 4. 设置特定时间戳(2001-09-09 01:46:40)
    let custom_time = FileTime::from_unix_time(1_000_000_000, 0);
    set_file_times(file_path, custom_time, custom_time)?;
    
    // 5. 再次获取并打印时间戳
    let updated_meta = metadata(file_path)?;
    println!("\n修改后的时间戳:");
    println!("访问时间: {:?}", updated_meta.accessed());
    println!("修改时间: {:?}", updated_meta.modified());
    
    // 6. 批量修改目录下所有文件时间戳
    let dir_path = "demo_dir";
    fs::create_dir_all(dir_path)?;
    File::create(Path::new(dir_path).join("file1.txt"))?;
    File::create(Path::new(dir_path).join("file2.txt"))?;
    
    println!("\n批量修改目录时间戳...");
    update_dir_times(Path::new(dir_path))?;
    
    // 7. 安全设置时间戳示例
    println!("\n安全设置时间戳示例:");
    set_file_time_safe(file_path)?;
    
    Ok(())
}

// 递归修改目录中所有文件的时间戳
fn update_dir_times(dir: &Path) -> std::io::Result<()> {
    let new_time = FileTime::now();
    
    for entry in fs::read_dir(dir)? {
        let entry = entry?;
        let path = entry.path();
        
        if path.is_dir() {
            update_dir_times(&path)?;
        }
        
        set_file_times(&path, new_time, new_time)?;
        println!("已更新: {:?}", path);
    }
    
    Ok(())
}

// 安全设置时间戳函数
fn set_file_time_safe(path: &str) -> std::io::Result<()> {
    // 确保文件存在
    let _ = File::open(path)?;
    
    // 设置时间戳为2001-09-09 01:46:40
    let time = FileTime::from_unix_time(1_000_000_000, 0);
    set_file_times(path, time, time)
        .map_err(|e| {
            eprintln!("设置时间戳失败: {}", e);
            e
        })
}

注意事项

1. 在某些操作系统上，创建时间(ctime)可能无法修改
2. 需要适当的文件权限才能修改时间戳
3. 对于符号链接，默认操作的是链接指向的文件而非链接本身

filetime_creation库提供了简单直观的方式来处理文件时间戳操作，非常适合需要精确控制文件时间属性的应用场景。