hard deprecate Timestamp::to_unix_nanos

This commit is contained in:
KodrAus 2023-05-08 08:35:02 +10:00
parent 6d22d0c187
commit d89c69de98

View File

@ -137,20 +137,14 @@ impl Timestamp {
) )
} }
#[deprecated(note = "use `to_unix` instead")] #[deprecated(note = "use `to_unix` instead; this method will be removed in a future release")]
/// Get the number of fractional nanoseconds in the Unix timestamp. /// Get the number of fractional nanoseconds in the Unix timestamp.
/// ///
/// This method is deprecated and probably doesn't do what you're expecting it to. /// This method is deprecated and probably doesn't do what you're expecting it to.
/// It doesn't return the timestamp as nanoseconds since the Unix epoch, it returns /// It doesn't return the timestamp as nanoseconds since the Unix epoch, it returns
/// the fractional seconds of the timestamp. /// the fractional seconds of the timestamp.
pub const fn to_unix_nanos(&self) -> u32 { pub const fn to_unix_nanos(&self) -> u32 {
// NOTE: This method never did what it said on the tin: instead of panic!("`Timestamp::to_unix_nanos` is deprecated and will be removed: use `Timestamp::to_unix` instead")
// converting the timestamp into nanos it simply returned the nanoseconds
// part of the timestamp.
//
// We can't fix the behavior because the return type is too small to fit
// a useful value for nanoseconds since the epoch.
self.nanos
} }
} }