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

版本历史

版本	变更
v18.0.0	将无效回调传给 `callback` 参数现在会抛出 `ERR_INVALID_ARG_TYPE` 而不是 `ERR_INVALID_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
v18.0.0	Passing an invalid callback to the `callback` argument now throws `ERR_INVALID_ARG_TYPE` instead of `ERR_INVALID_CALLBACK`.
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.
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.