doc: note non-monotonic clock in crypto.randomUUIDv7

nabeel378 · aduh95 · commit 1684ab8ff891 · 2026-05-07T15:41:35.000+02:00
Signed-off-by: nabeel378 <mohammadnabeeljameel@gmail.com> PR-URL: #62600 Reviewed-By: Filip Skokan <panva.ip@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com>
diff --git a/doc/api/crypto.md b/doc/api/crypto.md
@@ -5822,7 +5822,9 @@ added: REPLACEME
 Generates a random [RFC 9562][] version 7 UUID. The UUID contains a millisecond
 precision Unix timestamp in the most significant 48 bits, followed by
 cryptographically secure random bits for the remaining fields, making it
-suitable for use as a database key with time-based sorting.
+suitable for use as a database key with time-based sorting. The embedded
+timestamp relies on a non-monotonic clock and is not guaranteed to be strictly
+increasing.
 
 ### `crypto.scrypt(password, salt, keylen[, options], callback)`
 
