//! Date and time parsing similar to what git can do.//!//! Note that this is not a general purpose time library.//!//! ## Examples//!//! ```//! use gix_date::{//!     parse,//!     parse_header,//!     time::{format, Format},//! };//!//! let time = parse("Thu, 18 Aug 2022 12:45:06 +0800", None).unwrap();//! assert_eq!(time.offset, 8 * 60 * 60);//! assert_eq!(time.format(Format::Raw).unwrap(), "1660797906 +0800");//! assert_eq!(time.format(Format::Custom(format::ISO8601)).unwrap(), "2022-08-18 12:45:06 +0800");//!//! let from_header = parse_header("1660797906 +0800").unwrap();//! assert_eq!(from_header, time);//! ```//! ## Feature Flags#![cfg_attr(    all(doc, feature = "document-features"),    doc = ::document_features::document_features!())]#![cfg_attr(all(doc, feature = "document-features"), feature(doc_cfg))]#![deny(missing_docs, unsafe_code)]///pub mod time; ///pub mod parse;pub use parse::function::{parse, parse_header}; pub use gix_error::ValidationError as Error; /// A timestamp with timezone.#[derive(Default, PartialEq, Eq, Debug, Hash, Ord, PartialOrd, Clone, Copy)]#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]pub struct Time {    /// The seconds that have passed since UNIX epoch. This makes it UTC, or `<seconds>+0000`.    pub seconds: SecondsSinceUnixEpoch,    /// The time's offset in seconds, which may be negative to match the `sign` field.    pub offset: OffsetInSeconds,} /// The number of seconds since unix epoch.////// Note that negative dates represent times before the unix epoch.////// ### Deviation////// `git` only supports dates *from* the UNIX epoch, whereas we chose to be more flexible at the expense of stopping time/// a few million years before the heat-death of the universe.pub type SecondsSinceUnixEpoch = i64;/// time offset in seconds.pub type OffsetInSeconds = i32;