Crate date_calculations

This crate provides helper functions for calculating shifts in Chrono’s NaiveDate values for various periods (week, month, quarter, year) for common shifts in direction (beginning_of_, end_of_, previous_, and next_).

The dates passed to these functions should be Gregorian dates to ensure proper calcuation.

use chrono::prelude::*;
use date_calculations::*;

let twenty_twenty_one = NaiveDate::from_ymd_opt(2021, 1, 31).unwrap();

assert_eq!(next_year(&twenty_twenty_one).unwrap().year(), 2022);
assert_eq!(next_year(&twenty_twenty_one).unwrap().month(), 1);
assert_eq!(next_year(&twenty_twenty_one).unwrap().day(), 1);

assert_eq!(previous_quarter(&twenty_twenty_one).unwrap().year(), 2020);
assert_eq!(previous_quarter(&twenty_twenty_one).unwrap().month(), 10);
assert_eq!(previous_quarter(&twenty_twenty_one).unwrap().day(), 1);

Functions

beginning_of_month

Returns the first day of the current month and year.

beginning_of_quarter

Returns the first day of the current quarter and year.

beginning_of_week

Returns the beginning of the week relative to the provided date.

beginning_of_year

Returns the first day of the year (January 1) of the current year.

end_of_month

Returns the last day of the current month and year.

end_of_quarter

Returns the last day of the current quarter and year.

end_of_week

Returns the end of the week relative to the provided date.

end_of_year

Returns the last day of the year (December 31) of the current year.

next_month

Returns the first day of the next month.

next_quarter

Returns the first day of the next quarter.

next_week

Returns the beginning of the next week.

next_year

Returns the first day of the year (January 1) of the next year.

previous_month

Returns the first day of the previous month.

previous_quarter

Returns the first day of the previous quarter.

previous_week

Returns the end of the next week.

previous_year

Returns the first day of the year (January 1) of the previous year.