diff --git a/doc/api/fs.md b/doc/api/fs.md index d6eb4208ef0a..9a76ba0abe64 100644 --- a/doc/api/fs.md +++ b/doc/api/fs.md @@ -896,6 +896,12 @@ If `len` is negative then `0` will be used. * `atime` {number|string|Date} @@ -1531,6 +1537,12 @@ Changes the ownership on a symbolic link. added: - v14.5.0 - v12.19.0 +changes: + - version: REPLACEME + pr-url: https://github.com/nodejs/node/pull/66634 + description: Negative numeric times are no longer replaced with the + current time, and instead represent times before the Unix + epoch. --> * `path` {string|Buffer|URL} @@ -2217,6 +2229,12 @@ documentation for more detail. * `path` {string|Buffer|URL} @@ -2229,7 +2247,8 @@ 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, `Date`s, or a - numeric string like `'123456789.0'`. + numeric string like `'123456789.0'`. Negative values represent times before + the Unix epoch. * If the value can not be converted to a number, or is `NaN`, `Infinity`, or `-Infinity`, an `Error` will be thrown. @@ -3621,6 +3640,11 @@ If `len` is negative then `0` will be used. * `path` {string|Buffer|URL} @@ -7118,6 +7164,11 @@ Synchronous unlink(2). Returns `undefined`.