Skip to main content

from_sec

Macro from_sec 

Source
macro_rules! from_sec {
    ($sec:expr, $frac:expr, on=$scale:expr, target=$target:expr) => { ... };
    ($sec:expr, $frac:expr, target=$target:expr, on=$scale:expr) => { ... };
    ($sec:expr, on=$scale:expr, target=$target:expr) => { ... };
    ($sec:expr, target=$target:expr, on=$scale:expr) => { ... };
    ($sec:expr, $frac:expr, on=$scale:expr) => { ... };
    ($sec:expr, $frac:expr, target=$target:expr) => { ... };
    ($sec:expr, on=$scale:expr) => { ... };
    ($sec:expr, target=$target:expr) => { ... };
    ($sec:expr, $frac:expr) => { ... };
    ($sec:expr) => { ... };
}
Expand description

Builds a Dt from whole seconds and an optional signed sub-second remainder (attoseconds).

Sugar for Dt::from_sec_and_frac. Does not perform time-scale conversion.

The fractional remainder is in attoseconds — use ms! (or another *_to_attos helper) instead of writing the attosecond literal by hand.

§Defaults

OmittedDefault
fraction0
on and targetboth Scale::TAI
only on=starget=s
only target=ton=TAI

§Forms

from_sec!(sec)
from_sec!(sec, frac)
from_sec!(sec, on=s)
from_sec!(sec, target=t)
from_sec!(sec, on=s, target=t)
from_sec!(sec, target=t, on=s)
from_sec!(sec, frac, on=s)
from_sec!(sec, frac, target=t)
from_sec!(sec, frac, on=s, target=t)
from_sec!(sec, frac, target=t, on=s)

§Examples

use deep_time::{Dt, Scale, from_sec, ms};

// 1.3 s → whole seconds + 300 ms remainder
let a = from_sec!(1);
let b = from_sec!(1, ms!(300));
let c = from_sec!(-1, ms!(-300), on=Scale::TAI);
let d = from_sec!(0, on=Scale::UTC);
let e = from_sec!(1, on=Scale::TAI, target=Scale::UTC);
let f = from_sec!(1, target=Scale::UTC, on=Scale::TAI);

assert_eq!(a, Dt::from_sec_and_frac(1, 0, Scale::TAI, Scale::TAI));
assert_eq!(b, Dt::from_sec_and_frac(1, ms!(300), Scale::TAI, Scale::TAI));
assert_eq!(c, Dt::from_sec_and_frac(-1, ms!(-300), Scale::TAI, Scale::TAI));
assert_eq!(d, Dt::from_sec_and_frac(0, 0, Scale::UTC, Scale::UTC));
assert_eq!(e, Dt::from_sec_and_frac(1, 0, Scale::TAI, Scale::UTC));
assert_eq!(f, e);

let signed = from_sec!(-1, ms!(-300));
let floor = from_sec!(-2, ms!(700));
assert_eq!(signed, floor);
assert_eq!(signed, Dt::from_sec_and_frac(-1, ms!(-300), Scale::TAI, Scale::TAI));