Node.js stats.birthtime 属性

在 Node.js 中，stats.birthtime 属性返回一个文件或目录被创建的时间。这个属性是一个 Date 对象，表示为一个 UTC 时间戳。

语法

const fs = require('fs');

fs.stat('path/to/file', (err, stats) => {
  console.log(stats.birthtime);
});

示例

下面是一个简单的示例，演示如何使用 stats.birthtime 属性来获取文件的创建时间。

const fs = require('fs');

fs.stat('./file.txt', (err, stats) => {
  if (err) {
    console.error(err);
    return;
  }

  console.log(`File created on: ${stats.birthtime}`);
});

运行上述代码，输出应该类似于以下内容：

File created on: 2021-07-01T00:00:00.000Z

注意事项

• stats.birthtime 属性在 Windows 上无法保证精准度。在 Windows 上，birthtime 实际上只记录了文件、目录或者符号链接被创建的时间，而不会自动更新。因此，birthtime 根据不同的操作系统和文件系统有不同的表现。
• 在 Node.js 10.0.0 及更早版本中，stats.birthtime 属性被称为 stats.ctimeMs，并且返回一个毫秒级的数字。从 Node.js 10.0.0 开始，stats.birthtime 被引入，返回一个 JavaScript Date 对象。

参考资料

• Node.js docs: fs.Stats
• MDN: Date