Carbono

Carbono is a simple Rust API extension for chrono DateTime.

[dependencies]
carbono = "0.1"

Getting Started

use carbono::Carbono;

fn main() {
    let carbono = Carbono::now(); // 2022-12-15 12:30:00

    println!("{}", carbono); // 2022-12-15 12:30:00 UTC

    assert_eq!(carbono.timestamp(), 1671107400);

    assert_eq!(carbono.rfc3339(), "2022-12-15T12:30:00+00:00");
    assert_eq!(carbono.rfc2822(), "Thu, 15 Dec 2022 12:30:00 +0000");

    assert_eq!(carbono.year(), 2022);
    assert_eq!(carbono.month(), 12);
    assert_eq!(carbono.day(), 15);
    assert_eq!(carbono.hour(), 12);
    assert_eq!(carbono.minute(), 30);
    assert_eq!(carbono.second(), 0);

    assert_eq!(carbono.datetime(), "2022-12-15 12:30:00");

    assert_eq!(carbono.date(), "2022-12-15");
    assert_eq!(carbono.time(), "12:30:00");

    assert_eq!(format!("{:?}", carbono.iso_week()), "2022-W50");

    assert_eq!(carbono.weekday(), 3); // Thursday

    assert_eq!(carbono.is_wednesday(), false);
    assert_eq!(carbono.is_thursday(), true);
    assert_eq!(carbono.is_friday(), false);

    assert_eq!(carbono.is_past(), true);
    assert_eq!(carbono.is_future(), false);

    assert_eq!(carbono.is_today(), true); // 2022-12-15

    assert_eq!(carbono.add_day().is_today(), false); // 2022-12-16

    assert_eq!(carbono.add_year().add_month().date(), "2024-01-15");

    assert_eq!(carbono.start_year().datetime(), "2022-01-01 00:00:00");
}

Alter the date and/or time

• add_year()
• sub_year()
• add_years(years: i32)
• sub_years(years: i32)
• add_month()
• sub_month()
• add_months(months: i32)
• sub_months(months: i32)
• add_week()
• sub_week()
• add_weeks(weeks: i64)
• sub_weeks(weeks: i64)
• add_day()
• sub_day()
• add_days(days: i64)
• sub_days(days: i64)
• add_hour()
• sub_hour()
• add_hours(hours: i64)
• sub_hours(hours: i64)
• add_minute()
• sub_minute()
• add_minutes(minutes: i64)
• sub_minutes(minutes: i64)
• add_second()
• sub_second()
• add_seconds(seconds: i64)
• sub_seconds(seconds: i64)

Move to the start/end of period

• start_year
• start_month
• start_day
• start_hour
• start_minute
• end_year
• end_month
• end_day
• end_hour
• end_minute