From b0412d597e75d66ac5f07c642abae49c739d4fde Mon Sep 17 00:00:00 2001 From: The 8472 Date: Mon, 25 Sep 2023 19:54:26 +0200 Subject: [PATCH] Document that Instant may or may not include system-suspend time --- library/std/src/time.rs | 2 ++ 1 file changed, 2 insertions(+) diff --git a/library/std/src/time.rs b/library/std/src/time.rs index c638cc61856fa..005d8c767048c 100644 --- a/library/std/src/time.rs +++ b/library/std/src/time.rs @@ -58,6 +58,8 @@ pub use core::time::TryFromFloatSecsError; /// some seconds may be longer than others). An instant may jump forwards or /// experience time dilation (slow down or speed up), but it will never go /// backwards. +/// As part of this non-guarantee it is also not specified whether system suspends count as +/// elapsed time or not. The behavior varies across platforms and rust versions. /// /// Instants are opaque types that can only be compared to one another. There is /// no method to get "the number of seconds" from an instant. Instead, it only