Struct dtg_lib::Dtg

source · [−]

pub struct Dtg { /* private fields */ }

Expand description

Date time group

Implementations

source

impl Dtg

source

pub fn now() -> Self

Create a current Dtg

source

pub fn from(s: &str) -> Result<Self, DtgError>

Create a Dtg from a string timestamp

use chrono::{TimeZone, Utc};
use dtg_lib::Dtg;

assert_eq!(
    Dtg::from("1658448142").unwrap(),
    Dtg::from_dt(&Utc.timestamp(1658448142, 0)),
);
assert_eq!(
    Dtg::from("1658448142.936196858").unwrap(),
    Dtg::from_dt(&Utc.timestamp(1658448142, 936196858)),
);

source

pub fn from_x(s: &str) -> Result<Self, DtgError>

Create a Dtg from an “x” format timestamp

use chrono::{TimeZone, Utc};
use dtg_lib::Dtg;

assert_eq!(
    Dtg::from_x("Xg6L02M").unwrap(),
    Dtg::from_dt(&Utc.timestamp(1658448142, 0)),
);

source

pub fn from_dt(dt: &DateTime<Utc>) -> Self

Create a Dtg from a DateTime

use chrono::{TimeZone, Utc};
use dtg_lib::Dtg;

assert_eq!(
    Dtg::from_dt(&Utc.timestamp(1658448142, 0)),
    Dtg::from("1658448142").unwrap(),
);

source

pub fn rfc_3339(&self) -> String

Format as an RFC 3339 string

use dtg_lib::Dtg;

assert_eq!(
    Dtg::from("1658448142").unwrap().rfc_3339(),
    "2022-07-22T00:02:22Z",
);

source

pub fn format(&self, fmt: &Option<Format>, tz: &Option<Tz>) -> String

Format as a string with format and timezone

use dtg_lib::{tz, Dtg, Format};

let dtg = Dtg::from("1658448142").unwrap();

assert_eq!(
    dtg.format(&None, &None),
    "2022-07-22T00:02:22Z",
);
assert_eq!(
    dtg.format(&Some(Format::X), &None),
    "Xg6L02M",
);

let a_fmt = Some(Format::Custom(String::from("%A")));

assert_eq!(
    dtg.format(&a_fmt, &None),
    "Friday",
);
assert_eq!(
    dtg.format(&a_fmt, &tz("MST7MDT").ok()),
    "Thursday",
);