fs.utimes(path, atime, mtime, callback)

版本历史

版本	变更
v10.0.0	参数 `callback` 不再是可选的。不传入它会在运行时抛出 `TypeError`。
v8.0.0	`NaN`、`Infinity` 和 `-Infinity` 不再是有效的时间说明符。
v7.6.0	参数 `path` 可以是使用 `file:` 协议的 WHATWG `URL` 对象。支持目前仍处于实验阶段。
v7.0.0	参数 `callback` 不再是可选的。不传入它将触发 ID 为 DEP0013 的弃用警告。
v4.1.0	现在允许使用数字字符串、`NaN` 和 `Infinity` 作为时间说明符。
v0.4.2	新增于: v0.4.2

path <string> | <Buffer> | <URL>
atime <number> | <string> | <Date>
mtime <number> | <string> | <Date>
callback <Function>
- err <Error>

更改 path 引用的对象的文件系统时间戳。

atime 和 mtime 参数遵循以下规则：

值可以是代表 Unix 纪元时间的数字、Date、或数字字符串（例如 '123456789.0'）。
如果该值不能转换为数字，或者是 NaN，Infinity 或 -Infinity，则将抛出 Error。

History

Version	Changes
v10.0.0	The `callback` parameter is no longer optional. Not passing it will throw a `TypeError` at runtime.
v8.0.0	`NaN`, `Infinity`, and `-Infinity` are no longer valid time specifiers.
v7.6.0	The `path` parameter can be a WHATWG `URL` object using `file:` protocol. Support is currently still experimental.
v7.0.0	The `callback` parameter is no longer optional. Not passing it will emit a deprecation warning with id DEP0013.
v4.1.0	Numeric strings, `NaN` and `Infinity` are now allowed time specifiers.
v0.4.2	Added in: v0.4.2

path <string> | <Buffer> | <URL>
atime <number> | <string> | <Date>
mtime <number> | <string> | <Date>
callback <Function>
- err <Error>

Change the file system timestamps of the object referenced by path.

The atime and mtime arguments follow these rules:

Values can be either numbers representing Unix epoch time in seconds, Dates, or a numeric string like '123456789.0'.
If the value can not be converted to a number, or is NaN, Infinity or -Infinity, an Error will be thrown.