Skip to main content

from_jd_f

Macro from_jd_f 

Source
macro_rules! from_jd_f {
    ($jd:expr, on=$scale:expr) => { ... };
    ($jd:expr) => { ... };
}
Expand description

Builds a TAI Dt from a floating-point Julian Date.

Equivalent to Dt::from_jd_f.

When an on arg is provided and it’s not Scale::TAI then a time scale conversion is performed equivalent to on -> Scale::TAI.

There is no target= on this macro — the returned Dt’s target is set from on (or TAI when omitted), as from_jd_f does. Chain .target(…) if needed.

§Defaults

OmittedDefault
onScale::TAI

§Forms

from_jd_f!(jd)
from_jd_f!(jd, on=s)

§Examples

use deep_time::{Dt, Scale, days_f, macros::from_jd_f};

// 2_460_782.25
let a = from_jd_f!(2_460_782.25);
let b = from_jd_f!(2_460_782.25, on=Scale::TAI);
let c = from_jd_f!(2_460_782.0, on=Scale::UTC);

assert_eq!(a, Dt::from_jd_f(2_460_782.25, Scale::TAI));
assert_eq!(b, a);
assert_eq!(c, Dt::from_jd_f(2_460_782.0, Scale::UTC));
assert_eq!(a.to_jd(), (2_460_782, days_f!(0.25)));

// -1_000.25 (signed remainder)
let neg = from_jd_f!(-1_000.25);
assert_eq!(neg, Dt::from_jd_f(-1_000.25, Scale::TAI));
assert_eq!(neg.to_jd(), (-1_000, -days_f!(0.25)));