大网数据广告活动
Web 标准与前端开发

File:lastModified 属性

· 52CE 我爱测

File 接口的 **`lastModified`** 只读属性提供文件的上次修改日期,作为自 Unix 纪元(1970 年 1 月 1 日午夜)以来的毫秒数。没有已知最后修改日期的文件返回当前日期。

File API

File 接口的 lastModified 只读属性提供文件的上次修改日期,作为自 Unix 纪元(1970 年 1 月 1 日午夜)以来的毫秒数。没有已知最后修改日期的文件返回当前日期。

值

一个数字,表示自 Unix 纪元以来的毫秒数。

示例

下面的示例将循环遍历你选择的文件,并打印每个文件在过去一年内是否被修改过。

HTML

<input type="file" id="file-picker" name="fileList" multiple />
<output id="output"></output>
output {
  display: block;
  white-space: pre-wrap;
}

JavaScript

const output = document.getElementById("output");
const filePicker = document.getElementById("file-picker");

filePicker.addEventListener("change", (event) => {
  const files = event.target.files;
  const now = new Date();
  output.textContent = "";

  for (const file of files) {
    const date = new Date(file.lastModified);
    // 如果文件超过 1 年没有修改,则为 true
    const stale = now.getTime() - file.lastModified > 31_536_000_000;
    output.textContent += `${file.name} 是${
      stale ? "陈旧的" : "新的"
    }(${date})。\n`;
  }
});

结果

示例

动态创建文件

如果文件是动态创建的,可以在 File.File() 构造函数中提供最后修改时间。如果未提供该参数,lastModified 将会继承文件对象被创建时的时间(来自 Date.now())。

const fileWithDate = new File([], "file.bin", {
  lastModified: new Date(2017, 1, 1),
});
console.log(fileWithDate.lastModified); // 返回 1485903600000

const fileWithoutDate = new File([], "file.bin");
console.log(fileWithoutDate.lastModified); // 返回当前时间

时间精度降低

为了防止计时攻击和指纹识别,someFile.lastModified 的精度可能会根据浏览器设置进行舍入。在 Firefox 中,privacy.reduceTimerPrecision 首选项默认启用,默认为 2ms。你还可以启用 privacy.resistFingerprinting,在这种情况下精度将为 100ms 或 privacy.resistFingerprinting.reduceTimerPrecision.microseconds 的值,以较大者为准。

例如,在降低时间精度的情况下,someFile.lastModified 的结果将始终是 2 的倍数,或者在启用 privacy.resistFingerprinting 的情况下为 100 的倍数(或 privacy.resistFingerprinting.reduceTimerPrecision.microseconds)。

// Firefox 60 中的时间精度降低(2 毫秒)
someFile.lastModifiedDate.getTime();
// 可能是:
// 1519211809934
// 1519211810362
// 1519211811670
// …

// 启用 `privacy.resistFingerprinting` 会降低时间精度
someFile.lastModifiedDate.getTime();
// 可能是:
// 1519129853500
// 1519129858900
// 1519129864400
// …

规范

浏览器兼容性

参见

  • File

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。