Struct ZipDateTime 

pub struct ZipDateTime<TZ = Utc> { /* private fields */ }

Represents a timestamp found in a ZIP file

Implementations

impl<TZ: TimeZoneMarker> ZipDateTime<TZ>

pub fn from_components( year: u16, month: u8, day: u8, hour: u8, minute: u8, second: u8, nanosecond: u32, ) -> Option<Self>

Creates a ZipDateTime from date/time components with validation.

Arguments

• year - Year (1-65535)
• month - Month (1-12)
• day - Day of month (1-31, validated against month)
• hour - Hour (0-23)
• minute - Minute (0-59)
• second - Second (0-59)
• nanosecond - Nanosecond (0-999,999,999), defaults to 0

Errors

Returns None if any component is invalid or the date doesn’t exist (e.g. February 30th, April 31st).

Examples

let utc_datetime = UtcDateTime::from_components(
    2023, 6, 15, 14, 30, 45, 500_000_000
).unwrap();
assert_eq!(utc_datetime.year(), 2023);
assert_eq!(utc_datetime.nanosecond(), 500_000_000);

// Invalid date returns None
assert!(UtcDateTime::from_components(2023, 2, 30, 0, 0, 0, 0).is_none());

pub const fn year(&self) -> u16

Returns the year component of the timestamp.

pub const fn month(&self) -> u8

Returns the month component (1-12) of the timestamp.

pub const fn day(&self) -> u8

Returns the day component (1-31) of the timestamp.

pub const fn hour(&self) -> u8

Returns the hour component (0-23) of the timestamp.

pub const fn minute(&self) -> u8

Returns the minute component (0-59) of the timestamp.

pub const fn second(&self) -> u8

Returns the second component (0-59) of the timestamp.

pub const fn nanosecond(&self) -> u32

Returns the nanosecond component (0-999,999,999) of the timestamp. For timestamps that don’t support nanosecond precision, this returns 0.

pub fn timezone(&self) -> TimeZone

Returns the timezone of this timestamp.

impl ZipDateTime<Utc>

pub fn from_unix(seconds: i64) -> UtcDateTime

Creates a ZipDateTime from a Unix timestamp (seconds since epoch)

pub fn to_unix(&self) -> i64

Convert to Unix timestamp (seconds since epoch).

Returns the number of seconds since the Unix epoch (1970-01-01 00:00:00 UTC). Negative values represent dates before 1970.

Trait Implementations

impl<TZ: Clone> Clone for ZipDateTime<TZ>

fn clone(&self) -> ZipDateTime<TZ>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<TZ: Debug> Debug for ZipDateTime<TZ>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<TZ: TimeZoneMarker> Display for ZipDateTime<TZ>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&ZipDateTime> for DosDateTime

fn from(zip_dt: &ZipDateTime) -> Self

Converts to this type from the input type.

impl<TZ: Hash> Hash for ZipDateTime<TZ>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<TZ: Ord> Ord for ZipDateTime<TZ>

fn cmp(&self, other: &ZipDateTime<TZ>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<TZ: PartialEq> PartialEq for ZipDateTime<TZ>

fn eq(&self, other: &ZipDateTime<TZ>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<TZ: PartialOrd> PartialOrd for ZipDateTime<TZ>

fn partial_cmp(&self, other: &ZipDateTime<TZ>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<TZ: Copy> Copy for ZipDateTime<TZ>

impl<TZ: Eq> Eq for ZipDateTime<TZ>

impl<TZ> StructuralPartialEq for ZipDateTime<TZ>