Expand description
Public façade over tempoch-core.
The crate root exposes the redesigned scale-only time model:
Modules§
Structs§
- BDT
- BeiDou Navigation Satellite System Time.
BDT = TAI − 33 s(nominal, exact integer offset). EquivalentlyBDT = GPST − 14 s. - Data
Horizons - Documented validity horizons of the currently active time-data bundle, expressed in MJD UTC days.
- ET
- NAIF/SPICE Ephemeris Time — compatibility marker.
- Exact
Duration - Exact-precision signed duration.
- Format
Options - Format options for ISO 8601 / RFC 3339 output.
- GPS
- GPS seconds since 1980-01-06T00:00:00 TAI.
- GPST
- GPS System Time.
GPST = TAI − 19 s(nominal, exact integer offset). - GST
- Galileo System Time. Nominally
GST = TAI − 19 s(identical tick rate and integer offset toGPSTtoday; broadcast inter-system offset GGTO is not modeled here). - Gnss
Week - Decomposed GNSS week-number form.
- Interval
- Half-open time interval
[start, end). - J2000s
- SI seconds since J2000.0 TT (2000-01-01T12:00:00 TT).
- JD
- Julian Day (days since noon 1 January 4713 BC on the proleptic Julian calendar, TT axis by convention).
- MJD
- Modified Julian Day (
JD − 2 400 000.5). - QZSST
- Quasi-Zenith Satellite System Time. Nominally aligned with
GPST(QZSST = TAI − 19 s). The QZSS ICD defines QZSST as steered to GPST; observed inter-system offsets are not part of the scale. - TAI
- International Atomic Time. Continuous SI-second clock.
- TCB
- Barycentric Coordinate Time (IAU 2006 B3). Linear relation to TDB.
- TCG
- Geocentric Coordinate Time (IAU 2000 B1.9). Linear rate difference to TT.
- TDB
- Barycentric Dynamical Time.
- TT
- Terrestrial Time. The dynamical reference scale in this crate.
- Time
- A point in time on scale
S, tagged with external format phantomF. - Time
Context - Explicit, immutable context for conversions that need one.
- Time
Data Status - Active time-data status captured from the runtime store.
- Time
Series - Half-open iterator
[start, end)stepping by anExactDuration. - UT1
- Universal Time 1 — Earth-rotation time axis.
- UTC
- Coordinated Universal Time.
- Unix
- POSIX (Unix) seconds since 1970-01-01T00:00:00 UTC.
Enums§
- Active
Time Data Source - Source of the currently active time-data bundle.
- Conversion
Error - Conversion error surface.
- Duration
Error - Error type for fallible
ExactDurationoperations. - Format
Precision - Subsecond rounding policy used by the formatter.
- Freshness
Error - Errors raised by freshness checks.
- Invalid
Interval Error - Error constructing an
super::Intervalwith invalid bounds. - Period
List Error - Invariants on a period list.
- Time
Data Error - Error surface for runtime time-data operations.
- Time
Series Error - Error returned when a
TimeSeriescannot be constructed.
Constants§
- DELTA_
T_ PREDICTION_ HORIZON_ MJD - MJD of the last compiled ΔT prediction point, on the UT1 axis (
qtty::Day). - GPS_
EPOCH_ JD_ UTC_ DAY - GPS epoch JD value on the UTC axis:
1980-01-06T00:00:00 UTC. - GPS_
EPOCH_ TAI_ MINUS_ UTC - Exact
TAI - UTCoffset at the GPS epoch. - IAU_
TIME_ EPOCH_ T0_ JD_ DAY - IAU 2000 B1.9 reference epoch
T0as a JD value on the TT axis. - J2000_
JD_ TT_ DAY - J2000 epoch Julian Day value on the TT axis (
JD 2 451 545.0 TT). - MODERN_
DELTA_ T_ OBSERVED_ END_ MJD - NANOS_
PER_ SECOND - Nanoseconds per second; convenience constant for boundary code.
- TDB_
TT_ MODEL_ HIGH_ ACCURACY_ END_ JD_ DAY - End JD (TT axis) for the built-in TT↔TDB truncated-series accuracy band.
- TDB_
TT_ MODEL_ HIGH_ ACCURACY_ START_ JD_ DAY - Start JD (TT axis) for the built-in TT↔TDB truncated-series accuracy band.
- TT_
MINUS_ TAI - Exact
TT - TAIoffset (32.184 s). - UNIX_
EPOCH_ JD_ DAY - Unix epoch JD value on the UTC axis:
1970-01-01T00:00:00 UTC. - UTC_
DEFINED_ FROM_ MJD_ DAY - First MJD covered by the compiled UTC-TAI segment table, on the UTC axis.
Traits§
- Context
Conversion Target - Unified context-backed conversion target for
Time<S, F>::to_with::<T>(&ctx). - Continuous
Scale - Witness that a scale is both coordinate-bearing and physically continuous.
- Conversion
Target - Unified conversion target for
Time<S, F>::try_to::<T>(). - Coordinate
Scale - Witness that a scale is continuous and supports direct arithmetic.
UTCdeliberately does not implement this: it has raw-axis accessors throughCoordinateScale, but its civil interpretation remains leap-second-aware and table-driven. - Format
ForScale - Witness that format
Fcan encode and decode instants on scaleS. - Gnss
Week Scale - Sealed trait providing the J2000-second offset of each GNSS scale’s epoch.
- Infallible
Conversion Target - Unified infallible conversion target for
Time<S, F>::to::<T>(). - Infallible
Format ForScale - Witness that format
Fcan encode scaleSwithout aTimeContext. - Scale
- Marker trait for a scientifically distinct time scale.
- Time
Format - Marker trait for an external time encoding such as JD or Unix time.
- Time
Instant - Provides arithmetic on
Time<S>values via seconds duration.
Functions§
- assert_
time_ data_ fresh - Assert the active bundle is no older than
max_agerelative tonow. - complement_
within - Gaps inside
outerthat are not covered by any interval inperiods. - delta_
t_ seconds - ΔT = TT − UT1, in seconds, for a Julian Day on the UT1 axis.
- delta_
t_ seconds_ extrapolated - ΔT = TT − UT1, in seconds, with quadratic tail-fit extrapolation beyond the last published prediction point.
- gps_
epoch_ jd_ tai - GPS epoch as
Time<TAI, JD>. - gps_
epoch_ jd_ utc - GPS epoch as
Time<UTC, JD>. - gps_
epoch_ tai - GPS epoch as
Time<TAI, J2000s>. - iau_
time_ epoch_ t0_ jd - IAU time epoch
T0asTime<TT, JD>. - j2000_
jd_ tt - J2000 epoch as
Time<TT, JD>. - tdb_
tt_ model_ high_ accuracy_ end_ jd - End of the TT↔TDB model accuracy interval as
Time<TT, JD>. - tdb_
tt_ model_ high_ accuracy_ start_ jd - Start of the TT↔TDB model accuracy interval as
Time<TT, JD>. - time_
data_ status - Capture status for the currently active time-data bundle.
- unix_
epoch_ jd - Unix epoch as
Time<UTC, JD>. - unix_
epoch_ mjd - Unix epoch as
Time<UTC, MJD>. - utc_
defined_ from_ mjd - UTC definition boundary as
Time<UTC, MJD>.
Type Aliases§
- Encoded
Time - Historical name for
Time<S, F>after the format-parameter merge. - GpsTime
- GPS seconds on the TAI axis.
- J2000
Seconds - SI seconds since J2000.0 on scale
S. - Julian
Date - Julian day instant on scale
S(JDtag). - Modified
Julian Date - Modified Julian day instant on scale
S. - Period
- Typed time period on a given scale.
- Unix
Time - POSIX / Unix seconds on the UTC axis.