gix-date 0.15.2

use crate::{SecondsSinceUnixEpoch, Time};

/// Serialize this instance as string, similar to what [`write_to()`](Self::write_to()) would do.
impl std::fmt::Display for Time {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let mut buf = Vec::with_capacity(Time::MAX.size());
        self.write_to(&mut buf).expect("write to memory cannot fail");
        // Time serializes as ASCII, which is a subset of UTF-8.
        // Use `from_utf8()` (validated) instead of `from_utf8_unchecked()` for safety,
        // with the option to switch to an unsafe version if 30% performance boost are needed here.
        let raw = std::str::from_utf8(&buf).expect("time serializes as valid UTF-8");
        f.write_str(raw)
    }
}

/// Serialization with standard `git` format
impl Time {
    /// Serialize this instance to `out` in a format suitable for use in header fields of serialized git commits or tags.
    pub fn write_to(&self, out: &mut dyn std::io::Write) -> std::io::Result<()> {
        const SECONDS_PER_HOUR: u32 = 60 * 60;
        let offset = self.offset.unsigned_abs();
        let hours = offset / SECONDS_PER_HOUR;
        let minutes = (offset - (hours * SECONDS_PER_HOUR)) / 60;

        if hours > 99 {
            return Err(std::io::Error::other("Cannot represent offsets larger than +-9900"));
        }

        let mut itoa = itoa::Buffer::new();
        out.write_all(itoa.format(self.seconds).as_bytes())?;
        out.write_all(b" ")?;
        out.write_all(if self.offset < 0 { b"-" } else { b"+" })?;

        const ZERO: &[u8; 1] = b"0";

        if hours < 10 {
            out.write_all(ZERO)?;
        }
        out.write_all(itoa.format(hours).as_bytes())?;

        if minutes < 10 {
            out.write_all(ZERO)?;
        }
        out.write_all(itoa.format(minutes).as_bytes()).map(|_| ())
    }

    /// Computes the number of bytes necessary to write it using [`Time::write_to()`].
    pub const fn size(&self) -> usize {
        let is_negative = self.seconds < 0;
        Self::count_positive_digits(self.seconds.unsigned_abs()) + is_negative as usize + 6
        // space + offset sign + hours (2) + minutes (2)
    }

    /// Count the number of decimal digits in a positive integer.
    const fn count_positive_digits(n: u64) -> usize {
        // Powers of 10 for comparison
        const POW10: [u64; 20] = [
            1,
            10,
            100,
            1_000,
            10_000,
            100_000,
            1_000_000,
            10_000_000,
            100_000_000,
            1_000_000_000,
            10_000_000_000,
            100_000_000_000,
            1_000_000_000_000,
            10_000_000_000_000,
            100_000_000_000_000,
            1_000_000_000_000_000,
            10_000_000_000_000_000,
            100_000_000_000_000_000,
            1_000_000_000_000_000_000,
            10_000_000_000_000_000_000,
        ];

        // Binary search would be nice but not const-fn friendly, so use simple loop
        let mut digits = 1;
        while digits < 20 && n >= POW10[digits] {
            digits += 1;
        }
        digits
    }

    /// The numerically largest possible time instance, whose [size()](Time::size) is the largest possible
    /// number of bytes to write using [`Time::write_to()`].
    pub const MAX: Time = Time {
        seconds: SecondsSinceUnixEpoch::MAX,
        offset: 99 * 60 * 60 + 59 * 60 + 59,
    };
}