README.md

epoch-converter

epoch-converter enables conversion between seconds and units of time as well as between an epoch timestamp and units of time.

Important note

⚠️ epoch-converter always rounds down.

Usage

Add epoch-converter = "0.1.3" to your Cargo.toml

units()

This function converts a number of seconds into various units of time:

• Seconds
• Minutes
• Hours
• Days
• Weeks
• Months (using 30.44 days per month)
• Years (using 365.24 days per year)

use epoch_converter::units::units;

fn main() {
    let seconds = 63115200;
    println!("{} years", units(seconds).years); // Print the number of years in 63115200 seconds.
    println!("{} months", units(seconds).months); // Print the number of months in 63115200 seconds.
    println!("{} days", units(seconds).days); // Print the number of days in 63115200 seconds.
}

epoch_units()

This function converts an epoch timestamp into various units of time elapsed since Jan 1, 0001 on the Gregorian calendar:

• Seconds
• Minutes
• Hours
• Days
• Weeks
• Months (using 30.44 days per month)
• Years (using 365.24 days per year)

use epoch_converter::epoch_units::epoch_units;

fn main() {
    let epoch = 1278504000;
    println!("{} years", epoch_units(epoch).years); // Print the number of years in the epoch timestamp 1278504000.
    println!("{} months", epoch_units(epoch).months); // Print the number of months in the epoch timestamp 1278504000.
    println!("{} days", epoch_units(epoch).days); // Print the number of days in the epoch timestamp 1278504000.
}