Struct DateTime

pub struct DateTime {
    pub inner: OffsetDateTime,
}

Log timestamp type.

Parse using FromStr impl. Format using the Display trait. Convert timestamp into/from SystemTime to use. Supports compare and sorting.

Fields

inner: OffsetDateTime

Implementations

impl DateTime

pub fn utc() -> Self

utc time

pub fn now() -> Self

local zone time

pub fn set_offset(self, offset_sec: i32) -> DateTime

set offset

let mut  dt = fastdate::DateTime::utc();
dt = dt.set_offset(fastdate::offset_sec());

pub fn add(self, d: Duration) -> Self

add Duration

pub fn sub(self, d: Duration) -> Self

sub Duration

pub fn add_sub_sec(self, sec: i64) -> Self

add/sub sec

pub fn before(&self, other: &DateTime) -> bool

is self before on other?

pub fn after(&self, other: &DateTime) -> bool

is self after on other?

pub fn unix_timestamp(&self) -> i64

unix_timestamp sec

pub fn unix_timestamp_micros(&self) -> i64

unix_timestamp micros

pub fn unix_timestamp_millis(&self) -> i64

unix_timestamp millis

pub fn unix_timestamp_nano(&self) -> i128

unix_timestamp nano

pub fn from_timestamp(sec: i64) -> DateTime

from timestamp sec

pub fn from_timestamp_micros(micros: i64) -> DateTime

from timestamp micros

pub fn from_timestamp_millis(ms: i64) -> DateTime

from timestamp millis

pub fn from_timestamp_nano(nano: i128) -> DateTime

from timestamp nano

pub fn format(&self, fmt: &str) -> String

format support token = [“YYYY”,“MM”,“DD”,“hh”,“mm”,“ss”,“.000000”,“.000000000”,“+00:00”]

let dt = fastdate::DateTime::from((
        fastdate::Date {
            day: 1,
            mon: 1,
            year: 2000,
        },
        fastdate::Time {
            nano: 123456000,
            sec: 11,
            minute: 1,
            hour: 1,
        })).set_offset(8 * 60 * 60);
  println!("{}",dt.format("YYYY-MM-DD hh:mm:ss"));
  println!("{}",dt.format("YYYY-MM-DD hh:mm:ss.000000"));
  println!("{}",dt.format("YYYY-MM-DD hh:mm:ss.000000+00:00"));
  println!("{}",dt.format("YYYY/MM/DD/hh/mm/ss/.000000/+00:00"));
  println!("{}",dt.format("YYYY-MM-DD/hh/mm/ss"));

pub fn parse(format: &str, arg: &str) -> Result<DateTime, Error>

parse an string by format. format support token = [“YYYY”,“MM”,“DD”,“hh”,“mm”,“ss”,“.000000”,“+00:00”,“Z”] format str must be example: parse nano

 fastdate::DateTime::parse("YYYY-MM-DD hh:mm:ss.000000000Z", "2022-12-13 11:12:14.123456789Z").unwrap();
 fastdate::DateTime::parse("YYYY-MM-DD hh:mm:ss.000000000+00:00", "2022-12-13 11:12:14.123456789+06:00").unwrap();

or time zone(UTC+Hour)

 fastdate::DateTime::parse("YYYY-MM-DD hh:mm:ss.000000+00:00", "2022-12-13 11:12:14.123456+06:00").unwrap();
 fastdate::DateTime::parse("YYYY-MM-DD hh:mm:ss.000000+00:00", "2022-12-13 11:12:14.123456-03:00").unwrap();

or time zone(UTC)

 fastdate::DateTime::parse("YYYY-MM-DD hh:mm:ss.000000Z", "2022-12-13 11:12:14.123456Z").unwrap();

parse local time

 fastdate::DateTime::parse("YYYY-MM-DD hh:mm:ss.000000","2022-12-13 11:12:14.123456").unwrap();

or any position

 fastdate::DateTime::parse("YYYY-MM-DD,hh:mm:ss.000000","2022-12-13,11:12:14.123456").unwrap();

or time zone(UTC)

 fastdate::DateTime::parse("YYYY-MM-DD hh:mm:ss.000000Z", "2022-12-13 11:12:14.123456Z").unwrap();

or time zone(UTC+Hour)

 fastdate::DateTime::parse("YYYY-MM-DD hh:mm:ss.000000+00:00", "2022-12-13 11:12:14.123456+08:00").unwrap();

pub fn week_day(&self) -> u8

get week_day

pub fn nano(&self) -> u32

pub fn ms(&self) -> u16

pub fn micro(&self) -> u32

get micro secs

pub fn sec(&self) -> u8

get sec

pub fn minute(&self) -> u8

minute

pub fn hour(&self) -> u8

get hour

pub fn day(&self) -> u8

get day

pub fn mon(&self) -> u8

get mon

pub fn year(&self) -> i32

get year

pub fn offset(&self) -> i32

offset sec

pub fn offset_hms(&self) -> (i8, i8, i8)

offset_hms: hour,minute,sec

pub fn from_system_time(s: SystemTime, offset: i32) -> Self

pub fn display_stand(&self) -> String

stand “0000-00-00 00:00:00.000000000”

pub fn display(&self, zone: bool) -> String

RFC3339 “0000-00-00T00:00:00.000000000Z” RFC3339 “0000-00-00T00:00:00.000000000+00:00:00”

pub fn do_display(&self, buf: &mut [u8; 38], add_zone: bool) -> usize

let mut buf: [u8; 38] = *b“0000-00-00T00:00:00.000000000+00:00:00“; than print this: RFC3339 “0000-00-00T00:00:00.000000000Z” RFC3339 “0000-00-00T00:00:00.000000000+00:00:00”

pub fn set_nano(self, nano: u32) -> Self

pub fn from_str_default( arg: &str, default_offset: i32, ) -> Result<DateTime, Error>

Trait Implementations

impl Add<&Duration> for DateTime

type Output = DateTime

The resulting type after applying the + operator.

fn add(self, rhs: &Duration) -> Self::Output

Performs the + operation.

impl Add<Duration> for DateTime

type Output = DateTime

The resulting type after applying the + operator.

fn add(self, rhs: Duration) -> Self::Output

Performs the + operation.

impl Clone for DateTime

fn clone(&self) -> DateTime

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DateTime

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DateTime

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for DateTime

fn fmt(&self, f: &mut Formatter<'_>) -> Result

fmt RFC3339Nano = “2006-01-02T15:04:05.999999999”

impl From<(Date, Time)> for DateTime

fn from(arg: (Date, Time)) -> Self

Converts to this type from the input type.

impl From<(Date, Time, i32)> for DateTime

from(Date{},Time{},offset_sec())

fn from(arg: (Date, Time, i32)) -> Self

Converts to this type from the input type.

impl From<(Date, i32)> for DateTime

from((Date{},offset_sec()))

fn from(arg: (Date, i32)) -> Self

Converts to this type from the input type.

impl From<Date> for DateTime

fn from(arg: Date) -> Self

Converts to this type from the input type.

impl From<DateTime> for Date

fn from(arg: DateTime) -> Self

Converts to this type from the input type.

impl From<DateTime> for SystemTime

fn from(v: DateTime) -> SystemTime

Converts to this type from the input type.

impl From<DateTime> for Time

fn from(arg: DateTime) -> Self

Converts to this type from the input type.

impl From<SystemTime> for DateTime

fn from(v: SystemTime) -> DateTime

Converts to this type from the input type.

impl From<Time> for DateTime

fn from(arg: Time) -> Self

Converts to this type from the input type.

impl FromStr for DateTime

fn from_str(arg: &str) -> Result<DateTime, Error>

parse_from_str

“2019-10-12T07:20:50.52Z” (UTC+0) “2019-10-12T07:20:50.52+00:00” (UTC+0) “2019-10-12T14:20:50.52+07:00” (UTC+7) “2019-10-12T03:20:50.52-04:00” (UTC-4)

type Err = Error

The associated error which can be returned from parsing.

impl Hash for DateTime

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for DateTime

fn cmp(&self, other: &DateTime) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for DateTime

fn eq(&self, other: &DateTime) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for DateTime

fn partial_cmp(&self, other: &DateTime) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for DateTime

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Sub<&Duration> for DateTime

type Output = DateTime

The resulting type after applying the - operator.

fn sub(self, rhs: &Duration) -> Self::Output

Performs the - operation.

impl Sub<Duration> for DateTime

type Output = DateTime

The resulting type after applying the - operator.

fn sub(self, rhs: Duration) -> Self::Output

Performs the - operation.

impl Sub for DateTime

type Output = Duration

The resulting type after applying the - operator.

fn sub(self, rhs: DateTime) -> Self::Output

Performs the - operation.

impl Eq for DateTime

impl StructuralPartialEq for DateTime