fs.Stats类

从 fs.stat()、fs.lstat() 和 fs.fstat() 及其同步版本返回的对象都属于这种类型。

  • stats.isFile()

  • stats.isDirectory()

  • stats.isBlockDevice()

  • stats.isCharacterDevice()

  • stats.isSymbolicLink()（只在 fs.lstat() 中有效）

  • stats.isFIFO()

  • stats.isSocket()

对于一个普通文件，util.inspect(stats) 将返回非常类似这样的字符串：

  1. {
  2.     dev: 2114,
  3.     ino: 48064969,
  4.     mode: 33188,
  5.     nlink: 1,
  6.     uid: 85,
  7.     gid: 100,
  8.     rdev: 0,
  9.     size: 527,
  10.     blksize: 4096,
  11.     blocks: 8,
  12.     atime: Mon, 10 Oct 2011 23:24:11 GMT,
  13.     mtime: Mon, 10 Oct 2011 23:24:11 GMT,
  14.     ctime: Mon, 10 Oct 2011 23:24:11 GMT,
  15.     birthtime: Mon, 10 Oct 2011 23:24:11 GMT
  16. }

请注意 atime、mtime、birthtime 和 ctime 是 Date 对象的实例，比较这些对象的值，你应该使用合适的方法。对于大多数一般用途 getTime() 会返回自 1 January 1970 00:00:00 UTC 已过的毫秒数并且该整数足以拿来做任何比较，然而也有可用于显示模糊信息的其他方法。更多的细节可以在 MDN JavaScript的参考页 中找到。

状态时间值

在状态对象中的时间有以下语义：

  • atime “访问时间” - 文件数据最后被访问的时间。会被 mknod(2)、utimes(2) 和 read(2) 系统调用更改。

  • mtime “修改时间” - 文件数据最后被修改的时间。会被 mknod(2)、utimes(2) 和 write(2) 系统调用更改。

  • ctime “更改时间” - 文件状态上次更改的时间（索引节点数据修改）。会被 chmod(2)、chown(2)、link(2)、mknod(2)、rename(2)、unlink(2)、utimes(2)、read(2) 和 write(2)系统调用更改。

  • birthtime “出生时间” - 文件创建的时间。在创建文件时设定一次。在文件系统中出生日期不可用，这个字段可能代替保存 ctime 或 1970-01-01T00:00Z（如，Unix 的纪元时间戳 0）两者任一。注意，此值也许比在此情况下的 atime 或 mtime 更加有用。在 Darwin 和其它的 FreeBSD 衍生系统中，如果时间被明确设置到了一个比目前出生时间较早的值，也会设置使用 utimes(2) 系统调用。

在 Node.js v0.12 之前的版本中，在 Windows 系统中，ctime 保存 birthtime。请注意在 v0.12 中，ctime 不是“创建时间”，并且在 Unix 系统中，它从来都不是。