Struct zip::DateTime

pub struct DateTime { /* fields omitted */ }

A DateTime field to be used for storing timestamps in a zip file

This structure does bounds checking to ensure the date is able to be stored in a zip file.

When constructed manually from a date and time, it will also check if the input is sensible (e.g. months are from [1, 12]), but when read from a zip some parts may be out of their normal bounds (e.g. month 0, or hour 31).

Warning

Some utilities use alternative timestamps to improve the accuracy of their ZIPs, but we don't parse them yet. We're working on this, however this API shouldn't be considered complete.

Implementations

impl DateTime

pub fn from_msdos(datepart: u16, timepart: u16) -> DateTime

Converts an msdos (u16, u16) pair to a DateTime object

pub fn from_date_and_time(
    year: u16,
    month: u8,
    day: u8,
    hour: u8,
    minute: u8,
    second: u8
) -> Result<DateTime, ()>

Constructs a DateTime from a specific date and time

The bounds are:

• year: [1980, 2107]
• month: [1, 12]
• day: [1, 31]
• hour: [0, 23]
• minute: [0, 59]
• second: [0, 60]

pub fn from_time(tm: Tm) -> Result<DateTime, ()>

Converts a ::time::Tm object to a DateTime

Returns Err when this object is out of bounds

pub fn timepart(&self) -> u16

Gets the time portion of this datetime in the msdos representation

pub fn datepart(&self) -> u16

Gets the date portion of this datetime in the msdos representation

pub fn to_time(&self) -> Tm

Converts the datetime to a Tm structure

The fields tm_wday, tm_yday, tm_utcoff and tm_nsec are set to their defaults.

pub fn year(&self) -> u16

Get the year. There is no epoch, i.e. 2018 will be returned as 2018.

pub fn month(&self) -> u8

Get the month, where 1 = january and 12 = december

pub fn day(&self) -> u8

Get the day

pub fn hour(&self) -> u8

Get the hour

pub fn minute(&self) -> u8

Get the minute

pub fn second(&self) -> u8

Get the second

Trait Implementations

impl Clone for DateTime

pub fn clone(&self) -> DateTime

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for DateTime

impl Debug for DateTime

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

Formats the value using the given formatter.

impl Default for DateTime

pub fn default() -> DateTime

Constructs an 'default' datetime of 1980-01-01 00:00:00