10 releases (1 stable)
1.0.1 | May 14, 2024 |
---|---|
0.1.8 | Apr 17, 2024 |
0.1.2 | Mar 28, 2024 |
#243 in Date and time
101 downloads per month
Used in datetime-rs
46KB
986 lines
Date
The date
crate provides a simple, easy-to-use Date
struct (and corresponding macro). Date
provides storage for a single Gregorian calendar date.
Date
can currently represent any valid calendar date between years -32,768 and 32,767.
Examples
Making a date:
use date::Date;
let date = Date::new(2012, 4, 21);
You can also use the date!
macro to get a syntax resembling a date literal:
use date::date;
let date = date! { 2012-04-21 };
Overflow
Date
provides an overflowing_new
function that allows for overflow values (for example,
February 30 or December 32), and maps them accordingly. This allows users to perform certain
mathematical computations without having to do their own overflow checking.
Features
date-rs
ships with the following features:
diesel-pg
: Enables interop with PostgreSQLDATE
columns using Diesel.easter
: Enables calculation for the date of Easter.serde
: Enables serialization and desearialization withserde
. (Enabled by default.)tz
: Enables support for time-zone-aware date construction.
Dependencies
~0.1–1.3MB
~26K SLoC