Struct BrightDate 

pub struct BrightDate {
    pub value: f64,
    pub precision: Precision,
    pub is_tai: bool,
}

Immutable BrightDate value — decimal days since J2000.0 epoch.

This is the primary type for nearly all time operations. Wrap a raw f64 value to get the full BrightDate API including formatting, arithmetic, and conversion methods.

Fields

value: f64

Raw decimal-day value since J2000.0

precision: Precision

Display precision (decimal places)

is_tai: bool

Whether this value is on the TAI timescale

Implementations

impl BrightDate

pub fn from_value(value: f64) -> Self

Create from a raw f64 value (decimal days since J2000.0).

pub fn from_value_with_options(value: f64, options: BrightDateOptions) -> Self

Create from a raw value with full options.

pub fn now() -> Self

Current time as a BrightDate (UTC).

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

Create from a chrono::DateTime<Utc>.

pub fn from_unix_ms(ms: f64) -> Result<Self, BrightDateError>

Create from a Unix timestamp in milliseconds.

pub fn from_unix_seconds(s: f64) -> Result<Self, BrightDateError>

Create from a Unix timestamp in seconds.

pub fn from_julian_date(jd: f64) -> Self

Create from a Julian Date.

pub fn from_modified_julian_date(mjd: f64) -> Self

Create from a Modified Julian Date.

pub fn from_iso(s: &str) -> Result<Self, BrightDateError>

Create from an ISO 8601 string.

pub fn from_gps_time(gps_week: u32, gps_seconds: f64) -> Self

Create from GPS week number and seconds within that week.

pub fn epoch() -> Self

The J2000.0 epoch itself (value = 0.0).

pub fn to_date_time(&self) -> DateTime<Utc>

Convert to a chrono::DateTime<Utc>.

pub fn to_unix_ms(&self) -> f64

Convert to Unix milliseconds.

pub fn to_unix_seconds(&self) -> f64

Convert to Unix seconds.

pub fn to_julian_date(&self) -> f64

Convert to Julian Date.

pub fn to_modified_julian_date(&self) -> f64

Convert to Modified Julian Date.

pub fn to_iso(&self) -> String

Convert to ISO 8601 string.

pub fn to_gps_time(&self) -> (u32, f64)

Convert to GPS time (gps_week, gps_seconds).

pub fn to_tai(&self) -> Self

Mark this BrightDate as TAI-flagged. In v1.0 the underlying value is always TAI-coherent, so this only toggles the display flag.

pub fn to_utc(&self) -> Self

Mark this BrightDate as UTC-flagged. In v1.0 the underlying value is always TAI-coherent, so this only toggles the display flag.

pub fn tai_utc_offset_seconds(&self) -> i32

Current TAI − UTC offset in whole seconds at this instant.

pub fn add_days(&self, days: f64) -> Self

Add days (decimal days) to this BrightDate.

pub fn sub_days(&self, days: f64) -> Self

Subtract days (decimal days) from this BrightDate.

pub fn add_millidays(&self, md: f64) -> Self

Add millidays.

pub fn add_microdays(&self, ud: f64) -> Self

Add microdays.

pub fn difference(&self, other: &Self) -> f64

Signed difference self − other in decimal days.

pub fn absolute_difference(&self, other: &Self) -> f64

Absolute difference from other in decimal days.

pub fn compare(&self, other: &Self) -> Ordering

Compare ordering to other.

pub fn approx_eq(&self, other: &Self, tolerance: Option<f64>) -> bool

Test equality within tolerance decimal days (default: 1 microday).

pub fn is_before(&self, other: &Self) -> bool

True if self < other.

pub fn is_after(&self, other: &Self) -> bool

True if self > other.

pub fn is_in_range(&self, start: &Self, end: &Self) -> bool

True if self falls in [start, end].

pub fn lerp(&self, other: &Self, t: f64) -> Self

Linear interpolation between self and other at parameter t ∈ [0,1].

pub fn midpoint(&self, other: &Self) -> Self

Midpoint between self and other.

pub fn floor_to_day(&self) -> Self

Floor to the nearest whole day boundary.

pub fn ceil_to_day(&self) -> Self

Ceiling to the nearest whole day boundary.

pub fn round_to_milliday(&self) -> Self

Round to nearest milliday.

pub fn round_to_microday(&self) -> Self

Round to nearest microday.

pub fn format(&self) -> String

Format as decimal-day string with this instance’s precision, e.g. "9622.50417".

pub fn decompose(&self) -> BrightDateComponents

Full decomposed struct.

pub fn format_full(&self) -> FormattedBrightDate

Full formatted breakdown.

pub fn to_log_string(&self) -> String

Compact log string, e.g. "[9622.50417]".

pub fn to_prefixed_string(&self, prefix: Option<&str>) -> String

Prefixed string, e.g. "BD:9622.50417".

pub fn format_duration_to(&self, other: &Self) -> String

Format duration from self to other.

pub fn duration_to(&self, other: &Self) -> BrightDuration

Duration breakdown.

pub fn format_range_to(&self, other: &Self) -> String

Range string for self..=other.

Trait Implementations

impl Add<f64> for BrightDate

type Output = BrightDate

The resulting type after applying the + operator.

fn add(self, rhs: f64) -> Self

Performs the + operation.

impl Clone for BrightDate

fn clone(&self) -> BrightDate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BrightDate

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BrightDate

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for BrightDate

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

Formats the value using the given formatter.

impl PartialEq for BrightDate

fn eq(&self, other: &BrightDate) -> 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 BrightDate

fn partial_cmp(&self, other: &BrightDate) -> 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 BrightDate

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Sub<f64> for BrightDate

type Output = BrightDate

The resulting type after applying the - operator.

fn sub(self, rhs: f64) -> Self

Performs the - operation.

impl Sub for BrightDate

type Output = f64

The resulting type after applying the - operator.

fn sub(self, rhs: BrightDate) -> f64

Performs the - operation.

impl Copy for BrightDate

impl StructuralPartialEq for BrightDate