use std::cmp::Ordering;
use std::str::FromStr;
use std::time::SystemTime;
use format::FormattedDateTime;
use strptime::ParseError;
use strptime::ParseResult;
use strptime::Parser;
use strptime::RawDateTime;
#[macro_export]
macro_rules! datetime {
($y:literal-$m:literal-$d:literal $h:literal : $mi:literal : $s:literal) => {{
#[allow(clippy::zero_prefixed_literal)]
{
$crate::DateTime::ymd($y, $m, $d).hms($h, $mi, $s).build()
}
}};
($y:literal-$m:literal-$d:literal $h:literal : $mi:literal : $s:literal $($tz:ident)::+) => {{
#[cfg(feature = "tz")]
#[allow(clippy::zero_prefixed_literal)]
{
match $crate::DateTime::ymd($y, $m, $d).hms($h, $mi, $s).tz($crate::tz::$($tz)::+) {
Ok(dt) => dt.build(),
Err(_) => panic!("invalid date/time and time zone combination"),
}
}
#[cfg(not(feature = "tz"))]
{
compile_error!("The `tz` feature must be enabled to specify a time zone.");
}
}};
}
#[cfg(feature = "diesel-pg")]
mod db;
mod format;
pub mod interval;
#[cfg(feature = "serde")]
mod serde;
pub use date::date;
pub use date::Date;
pub use date::Weekday;
#[cfg(feature = "tz")]
pub mod tz {
pub use date::tz::*;
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub(crate) enum TimeZone {
Unspecified,
Tz(::tz::TimeZoneRef<'static>),
FixedOffset(i32),
}
impl TimeZone {
pub(crate) const fn ut_offset(&self, timestamp: i64) -> TzResult<i32> {
match self {
Self::Unspecified => Ok(0),
Self::FixedOffset(offset) => Ok(*offset),
Self::Tz(tz) => match tz.find_local_time_type(timestamp) {
Ok(t) => Ok(t.ut_offset()),
Err(e) => Err(e),
},
}
}
}
}
#[derive(Clone, Copy, Debug, Eq)]
pub struct DateTime {
seconds: i64,
nanos: u32,
#[cfg(feature = "tz")]
tz: tz::TimeZone,
}
impl DateTime {
pub const fn ymd(year: i16, month: u8, day: u8) -> DateTimeBuilder {
DateTimeBuilder {
date: Date::new(year, month, day),
seconds: 0,
nanos: 0,
#[cfg(feature = "tz")]
tz: tz::TimeZone::Unspecified,
offset: 0,
}
}
pub const fn from_timestamp(timestamp: i64, nanos: u32) -> Self {
let mut timestamp = timestamp;
let mut nanos = nanos;
while nanos >= 1_000_000_000 {
nanos -= 1_000_000_000;
timestamp += 1;
}
Self {
seconds: timestamp,
nanos,
#[cfg(feature = "tz")]
tz: tz::TimeZone::Unspecified,
}
}
pub fn now() -> Self {
let dur = SystemTime::now()
.duration_since(SystemTime::UNIX_EPOCH)
.expect("System clock set prior to January 1, 1970");
Self::from_timestamp(dur.as_secs() as i64, dur.subsec_nanos())
}
}
#[cfg(feature = "tz")]
impl DateTime {
#[inline]
pub const fn with_tz(mut self, tz: tz::TimeZoneRef<'static>) -> Self {
self.tz = tz::TimeZone::Tz(tz);
self
}
}
impl DateTime {
#[inline]
pub const fn year(&self) -> i16 {
Date::from_timestamp(self.tz_adjusted_seconds()).year()
}
#[inline]
pub const fn month(&self) -> u8 {
Date::from_timestamp(self.tz_adjusted_seconds()).month()
}
#[inline]
pub const fn day(&self) -> u8 {
Date::from_timestamp(self.tz_adjusted_seconds()).day()
}
#[inline]
pub const fn weekday(&self) -> Weekday {
Date::from_timestamp(self.tz_adjusted_seconds()).weekday()
}
#[inline]
pub const fn hour(&self) -> u8 {
(self.tz_adjusted_seconds() % 86_400 / 3_600) as u8
}
#[inline]
pub const fn minute(&self) -> u8 {
((self.tz_adjusted_seconds() % 3600) / 60) as u8
}
#[inline]
pub const fn second(&self) -> u8 {
(self.tz_adjusted_seconds() % 60) as u8
}
#[inline]
pub const fn nanosecond(&self) -> u32 {
self.nanos
}
#[inline]
pub const fn day_of_year(&self) -> u16 {
self.date().day_of_year()
}
#[inline]
pub const fn date(&self) -> Date {
Date::from_timestamp(self.tz_adjusted_seconds())
}
#[inline]
pub const fn as_seconds(&self) -> i64 {
self.seconds
}
#[inline]
pub const fn as_milliseconds(&self) -> i64 {
self.seconds * 1_000 + (self.nanos / 1_000_000) as i64
}
#[inline]
pub const fn as_microseconds(&self) -> i64 {
self.seconds * 1_000_000 + (self.nanos / 1_000) as i64
}
#[inline]
pub const fn as_nanoseconds(&self) -> i128 {
self.seconds as i128 * 1_000_000_000 + self.nanos as i128
}
#[inline(always)]
const fn tz_adjusted_seconds(&self) -> i64 {
self.seconds + self.tz_offset()
}
const fn tz_offset(&self) -> i64 {
#[cfg(feature = "tz")]
{
match self.tz.ut_offset(self.seconds) {
Ok(offset) => offset as i64,
Err(_) => panic!("Invalid time zone"),
}
}
#[cfg(not(feature = "tz"))]
0
}
}
impl DateTime {
pub fn format(&self, format: &'static str) -> FormattedDateTime {
FormattedDateTime { dt: self, format }
}
}
impl DateTime {
pub fn parse(datetime_str: impl AsRef<str>, fmt: &'static str) -> ParseResult<Self> {
let parser = Parser::new(fmt);
parser.parse(datetime_str)?.try_into()
}
}
impl PartialEq for DateTime {
fn eq(&self, other: &Self) -> bool {
self.seconds == other.seconds && self.nanos == other.nanos
}
}
impl PartialOrd for DateTime {
fn partial_cmp(&self, other: &Self) -> Option<Ordering> {
Some(self.cmp(other))
}
}
impl Ord for DateTime {
fn cmp(&self, other: &Self) -> Ordering {
let seconds_cmp = self.seconds.cmp(&other.seconds);
match seconds_cmp {
Ordering::Equal => self.nanos.cmp(&other.nanos),
_ => seconds_cmp,
}
}
}
impl FromStr for DateTime {
type Err = ParseError;
#[rustfmt::skip]
fn from_str(s: &str) -> ParseResult<Self> {
if let Ok(dt) = Parser::new("%Y-%m-%dT%H:%M:%S").parse(s) { return dt.try_into(); }
if let Ok(dt) = Parser::new("%Y-%m-%dT%H:%M:%S%z").parse(s) { return dt.try_into(); }
if let Ok(dt) = Parser::new("%Y-%m-%d %H:%M:%S").parse(s) { return dt.try_into(); }
if let Ok(dt) = Parser::new("%Y-%m-%d %H:%M:%S%z").parse(s) { return dt.try_into(); }
if let Ok(dt) = Parser::new("%Y-%m-%dT%H:%M:%S%.6f").parse(s) { return dt.try_into(); }
if let Ok(dt) = Parser::new("%Y-%m-%dT%H:%M:%S%.6f%z").parse(s) { return dt.try_into(); }
if let Ok(dt) = Parser::new("%Y-%m-%d %H:%M:%S%.6f").parse(s) { return dt.try_into(); }
if let Ok(dt) = Parser::new("%Y-%m-%d %H:%M:%S%.6f%z").parse(s) { return dt.try_into(); }
if let Ok(dt) = Parser::new("%Y-%m-%dT%H:%M:%S%.9f").parse(s) { return dt.try_into(); }
if let Ok(dt) = Parser::new("%Y-%m-%dT%H:%M:%S%.9f%z").parse(s) { return dt.try_into(); }
if let Ok(dt) = Parser::new("%Y-%m-%d %H:%M:%S%.9f").parse(s) { return dt.try_into(); }
if let Ok(dt) = Parser::new("%Y-%m-%d %H:%M:%S%.9f%z").parse(s) { return dt.try_into(); }
if let Ok(dt) = Parser::new("%Y-%m-%d %H:%M:%SZ").parse(s) { return dt.try_into(); }
Parser::new("%Y-%m-%dT%H:%M:%SZ").parse(s)?.try_into()
}
}
impl TryFrom<RawDateTime> for DateTime {
type Error = ParseError;
fn try_from(value: RawDateTime) -> ParseResult<Self> {
let date = value.date()?;
let time = value.time().unwrap_or_default();
Ok(match time.utc_offset() {
#[cfg(feature = "tz")]
Some(utc_offset) => Self::ymd(date.year(), date.month(), date.day())
.hms(time.hour(), time.minute(), time.second())
.nanos(time.nanosecond() as u32)
.utc_offset(utc_offset)
.build(),
#[cfg(not(feature = "tz"))]
Some(_) => panic!("Enable the `tz` feature to parse datetimes with UTC offsets."),
None => Self::ymd(date.year(), date.month(), date.day())
.hms(time.hour(), time.minute(), time.second())
.nanos(time.nanosecond() as u32)
.build(),
})
}
}
#[must_use]
pub struct DateTimeBuilder {
date: Date,
seconds: i64,
nanos: u32,
#[cfg(feature = "tz")]
tz: tz::TimeZone,
offset: i64,
}
impl DateTimeBuilder {
pub const fn hms(mut self, hour: u8, minute: u8, second: u8) -> Self {
assert!(hour < 24, "Hour out of bounds");
assert!(minute < 60, "Minute out of bounds");
assert!(second < 60, "Second out of bounds");
self.seconds = (hour as i64 * 3600) + (minute as i64 * 60) + second as i64;
self
}
pub const fn nanos(mut self, nanos: u32) -> Self {
assert!(nanos < 1_000_000_000, "Nanos out of bounds.");
self.nanos = nanos;
self
}
#[cfg(feature = "tz")]
pub const fn tz(mut self, tz: tz::TimeZoneRef<'static>) -> tz::TzResult<Self> {
self.offset = match tz.find_local_time_type(self.date.timestamp() + self.seconds) {
Ok(t) => t.ut_offset() as i64,
Err(e) => return Err(e),
};
self.tz = tz::TimeZone::Tz(tz);
Ok(self)
}
#[cfg(feature = "tz")]
pub(crate) const fn utc_offset(mut self, offset: i32) -> Self {
self.offset = offset as i64;
self.tz = tz::TimeZone::FixedOffset(offset);
self
}
pub const fn build(self) -> DateTime {
DateTime {
seconds: self.date.timestamp() + self.seconds - self.offset,
nanos: self.nanos,
#[cfg(feature = "tz")]
tz: self.tz,
}
}
}
trait Sealed {}
impl Sealed for date::Date {}
#[allow(private_bounds)]
pub trait FromDate: Sealed {
fn hms(self, hour: u8, minute: u8, second: u8) -> DateTimeBuilder;
}
impl FromDate for date::Date {
fn hms(self, hour: u8, minute: u8, second: u8) -> DateTimeBuilder {
DateTimeBuilder {
date: self,
seconds: 0,
nanos: 0,
#[cfg(feature = "tz")]
tz: tz::TimeZone::Unspecified,
offset: 0,
}
.hms(hour, minute, second)
}
}
#[cfg(test)]
mod tests {
use assert2::check;
use strptime::ParseResult;
#[cfg(feature = "tz")]
use crate::tz;
use crate::DateTime;
use crate::FromDate;
#[test]
fn test_zero() {
let dt = datetime! { 1970-01-01 00:00:00 };
check!(dt.seconds == 0);
}
#[test]
fn test_accessors() {
let dt = datetime! { 2012-04-21 11:00:00 };
check!(dt.year() == 2012);
check!(dt.month() == 4);
check!(dt.day() == 21);
check!(dt.hour() == 11);
check!(dt.minute() == 0);
check!(dt.second() == 0);
}
#[test]
fn test_more_accessors() {
let dt = datetime! { 2024-02-29 13:15:45 };
check!(dt.year() == 2024);
check!(dt.month() == 2);
check!(dt.day() == 29);
check!(dt.hour() == 13);
check!(dt.minute() == 15);
check!(dt.second() == 45);
}
#[test]
fn test_parse_str() -> ParseResult<()> {
for s in [
"2012-04-21 11:00:00",
"2012-04-21T11:00:00",
"2012-04-21 11:00:00.000000",
"2012-04-21 11:00:00Z",
"2012-04-21T11:00:00.000000",
"2012-04-21T11:00:00Z",
] {
let dt = s.parse::<DateTime>()?;
check!(dt.year() == 2012);
check!(dt.month() == 4);
check!(dt.day() == 21);
check!(dt.hour() == 11);
}
Ok(())
}
#[test]
#[cfg(feature = "tz")]
fn test_parse_str_tz() -> ParseResult<()> {
for s in
["2012-04-21 11:00:00-0400", "2012-04-21T11:00:00-0400", "2012-04-21 11:00:00.000000-0400"]
{
let dt = s.parse::<DateTime>()?;
check!(dt.year() == 2012);
check!(dt.month() == 4);
check!(dt.day() == 21);
check!(dt.hour() == 11);
}
Ok(())
}
#[test]
#[allow(clippy::inconsistent_digit_grouping)]
fn test_precision() {
let dt = DateTime::ymd(2012, 4, 21).hms(15, 0, 0).build();
check!(dt.as_seconds() == 1335020400);
check!(dt.as_milliseconds() == 1335020400_000);
check!(dt.as_microseconds() == 1335020400_000_000);
check!(dt.as_nanoseconds() == 1335020400_000_000_000);
}
#[cfg(feature = "tz")]
#[test]
fn test_tz() -> tz::TzResult<()> {
let dt = DateTime::ymd(2012, 4, 21).hms(11, 0, 0).tz(tz::us::EASTERN)?.build();
check!(dt.as_seconds() == 1335020400);
check!(dt.year() == 2012);
check!(dt.month() == 4);
check!(dt.day() == 21);
check!(dt.hour() == 11);
let dt = DateTime::ymd(1970, 1, 1).tz(tz::us::PACIFIC)?.build();
check!(dt.as_seconds() == 3600 * 8);
Ok(())
}
#[cfg(feature = "tz")]
#[test]
fn test_unix_tz() {
let dt = DateTime::from_timestamp(1335020400, 0).with_tz(tz::us::EASTERN);
check!(dt.as_seconds() == 1335020400);
check!(dt.year() == 2012);
check!(dt.month() == 4);
check!(dt.day() == 21);
check!(dt.hour() == 11);
}
#[test]
fn test_from_date_trait() {
let dt = date::date! { 2012-04-21 }.hms(11, 0, 0).build();
check!(dt.year() == 2012);
check!(dt.month() == 4);
check!(dt.day() == 21);
check!(dt.hour() == 11);
}
}