Namespaces
namespace	constants

namespace	detail

namespace	format

namespace	scale

Classes
struct	CivilTime
	UTC date-time breakdown. More...

class	ConversionFailedError
	A generic scale/format conversion failed. More...

struct	DataHorizons

class	EncodedTime
	A typed external encoding of a time instant on scale `S`. More...

struct	EopValues
	Interpolated IERS Earth Orientation Parameter values. More...

struct	FormatTraits

struct	FormatTraits< format::GPS >

struct	FormatTraits< format::J2000s >

struct	FormatTraits< format::JD >

struct	FormatTraits< format::MJD >

struct	FormatTraits< format::Unix >

struct	GnssWeek

class	InternalPanicError
	Rust caught a panic before unwinding across the FFI boundary. More...

class	InvalidDurationUnitError
	The supplied quantity does not represent a time duration. More...

class	InvalidFormatIdError
	The supplied raw format identifier is invalid. More...

class	InvalidPeriodError
	The period is invalid (start > end). More...

class	InvalidScaleIdError
	The supplied raw scale identifier is invalid. More...

struct	is_format

struct	is_format< format::GPS >

struct	is_format< format::J2000s >

struct	is_format< format::JD >

struct	is_format< format::MJD >

struct	is_format< format::Unix >

struct	is_gnss_scale
	Trait marking the GNSS coordinate scales that support week decomposition. More...

struct	is_gnss_scale< scale::BDT >

struct	is_gnss_scale< scale::GPST >

struct	is_gnss_scale< scale::GST >

struct	is_gnss_scale< scale::QZSST >

struct	is_scale

struct	is_scale< scale::BDT >

struct	is_scale< scale::ET >

struct	is_scale< scale::GPST >

struct	is_scale< scale::GST >

struct	is_scale< scale::QZSST >

struct	is_scale< scale::TAI >

struct	is_scale< scale::TCB >

struct	is_scale< scale::TCG >

struct	is_scale< scale::TDB >

struct	is_scale< scale::TT >

struct	is_scale< scale::UT1 >

struct	is_scale< scale::UTC >

class	NoIntersectionError
	The two periods do not intersect. More...

class	NullPointerError
	A required output pointer was null. More...

class	Period

class	PeriodListOverlappingError
	The period list contains overlapping intervals. More...

class	PeriodListUnsortedError
	The period list is not sorted by start time. More...

struct	ScaleTraits

struct	ScaleTraits< scale::BDT >

struct	ScaleTraits< scale::ET >

struct	ScaleTraits< scale::GPST >

struct	ScaleTraits< scale::GST >

struct	ScaleTraits< scale::QZSST >

struct	ScaleTraits< scale::TAI >

struct	ScaleTraits< scale::TCB >

struct	ScaleTraits< scale::TCG >

struct	ScaleTraits< scale::TDB >

struct	ScaleTraits< scale::TT >

struct	ScaleTraits< scale::UT1 >

struct	ScaleTraits< scale::UTC >

class	TempochException
	Base exception for all tempoch errors. More...

class	Time
	A point in time on scale `S`, stored as a split J2000-second pair. More...

class	TimeContext
	Immutable conversion context for UT1 and historical UTC routes. More...

struct	TimeDataStatus

struct	TimeTraits

struct	TimeTraits< CivilTime >

struct	TimeTraits< EncodedTime< S, F > >

struct	TimeTraits< Time< S > >

class	Ut1HorizonExceededError
	A UT1 conversion requested data beyond the compiled ΔT/EOP horizon. More...

class	UtcConversionError
	UTC conversion failed (date out of range or invalid). More...

Typedefs
using	TTMjdPeriod = Period< ModifiedJulianDate< scale::TT > >

using	UTCPeriod = Period< CivilTime >

template<typename S >
using	JulianDate = EncodedTime< S, format::JD >

template<typename S >
using	ModifiedJulianDate = EncodedTime< S, format::MJD >

template<typename S >
using	J2000Seconds = EncodedTime< S, format::J2000s >

using	UnixTime = EncodedTime< scale::UTC, format::Unix >

using	GpsTime = EncodedTime< scale::TAI, format::GPS >

Enumerations
enum class	TimeDataSource : int { Bundled = 0 , RuntimeCache = 1 , Override = 2 }

Functions
std::ostream &	operator<< (std::ostream &os, const CivilTime &u)
	Stream CivilTime as YYYY-MM-DD HH:MM:SS[.nnnnnnnnn].

double	delta_t_seconds (double jd_ut1) noexcept

double	delta_t_seconds_extrapolated (double jd_ut1) noexcept

TimeDataStatus	time_data_status ()

bool	eop_covers (double mjd_utc) noexcept
	Check whether EOP data is available for `mjd_utc`.

std::optional< EopValues >	eop_at (double mjd_utc)
	Interpolate IERS EOP values at `mjd_utc`.

void	check_status (tempoch_status_t status, const char *operation)
	Check a tempoch_status_t and throw the appropriate exception on error.

template<typename S , std::enable_if_t< is_gnss_scale_v< S >, int > = 0>
GnssWeek	to_gnss_week (const Time< S > &time)
	Decompose a GNSS-scale instant into its week-number form.

template<typename S , std::enable_if_t< is_gnss_scale_v< S >, int > = 0>
Time< S >	from_gnss_week (const GnssWeek &gw)
	Build a GNSS-scale instant from a week-number decomposition.

template<typename T >
	Period (T, T) -> Period< T >

template<typename T >
void	validate_periods (const std::vector< Period< T > > &periods)

template<typename T >
std::vector< Period< T > >	intersect_periods (const std::vector< Period< T > > &a, const std::vector< Period< T > > &b)

template<typename T >
std::vector< Period< T > >	union_periods (const std::vector< Period< T > > &a, const std::vector< Period< T > > &b)

template<typename T >
std::vector< Period< T > >	normalize_periods (const std::vector< Period< T > > &periods)

template<typename T >
std::ostream &	operator<< (std::ostream &os, const Period< T > &period)

template<typename S >
std::ostream &	operator<< (std::ostream &os, const Time< S > &time)

template<typename S , typename F >
std::ostream &	operator<< (std::ostream &os, const EncodedTime< S, F > &time)

Variables
template<typename T >
constexpr bool	is_format_v = is_format<T>::value

template<typename F >
constexpr tempoch_format_tag_t	format_tag_v = FormatTraits<F>::ffi_tag

template<typename S >
constexpr bool	is_gnss_scale_v = is_gnss_scale<S>::value

template<typename T >
constexpr bool	is_scale_v = is_scale<T>::value

template<typename S >
constexpr tempoch_scale_tag_t	scale_tag_v = ScaleTraits<S>::ffi_tag

Typedef Documentation

◆ GpsTime

using tempoch::GpsTime = typedef EncodedTime<scale::TAI, format::GPS>

Definition at line 17 of file time.hpp.

◆ J2000Seconds

template<typename S >

using tempoch::J2000Seconds = typedef EncodedTime<S, format::J2000s>

Definition at line 14 of file time.hpp.

◆ JulianDate

template<typename S >

using tempoch::JulianDate = typedef EncodedTime<S, format::JD>

Definition at line 12 of file time.hpp.

◆ ModifiedJulianDate

template<typename S >

using tempoch::ModifiedJulianDate = typedef EncodedTime<S, format::MJD>

Definition at line 13 of file time.hpp.

◆ TTMjdPeriod

using tempoch::TTMjdPeriod = typedef Period<ModifiedJulianDate<scale::TT> >

Definition at line 131 of file period.hpp.

◆ UnixTime

using tempoch::UnixTime = typedef EncodedTime<scale::UTC, format::Unix>

Definition at line 16 of file time.hpp.

◆ UTCPeriod

using tempoch::UTCPeriod = typedef Period<CivilTime>

Definition at line 132 of file period.hpp.

Enumeration Type Documentation

◆ TimeDataSource

enum class tempoch::TimeDataSource : int

strong

Origin of the currently active time-data bundle.

Mirrors tempoch::ActiveTimeDataSource.

Enumerator
Bundled	Compiled archive snapshot bundled at build time.
RuntimeCache	Bundle loaded through the runtime fetch/cache path.
Override	Test or caller-provided override is active.

Definition at line 23 of file data_status.hpp.

Function Documentation

◆ check_status()

void tempoch::check_status	(	tempoch_status_t	status,
		const char *	operation
	)

inline

Check a tempoch_status_t and throw the appropriate exception on error.

Definition at line 139 of file ffi_core.hpp.

Referenced by tempoch::detail::add_seconds(), tempoch::Period< T >::complement_of(), tempoch::detail::decode_time(), tempoch::detail::difference_seconds(), tempoch::detail::encode_time(), eop_at(), from_gnss_week(), intersect_periods(), tempoch::Period< T >::intersection(), tempoch::detail::make_builtin_eop_context(), tempoch::detail::make_default_context(), tempoch::detail::make_pre_definition_context(), tempoch::detail::make_time(), normalize_periods(), tempoch::Period< T >::Period(), tempoch::detail::scale_convert(), time_data_status(), tempoch::detail::time_from_civil(), tempoch::detail::time_to_civil(), to_gnss_week(), union_periods(), tempoch::Period< T >::union_with(), and validate_periods().

◆ delta_t_seconds()

double tempoch::delta_t_seconds ( double jd_ut1 )

inlinenoexcept

ΔT = TT − UT1 in seconds for a UT1 Julian Day, using the compiled USNO model. Returns NaN when the requested epoch is outside the model domain.

Definition at line 87 of file constants.hpp.

◆ delta_t_seconds_extrapolated()

double tempoch::delta_t_seconds_extrapolated ( double jd_ut1 )

inlinenoexcept

ΔT = TT − UT1 in seconds for a UT1 Julian Day, extrapolating beyond the tabulated range with the long-term parabola (always finite).

Definition at line 91 of file constants.hpp.

◆ eop_at()

std::optional< EopValues > tempoch::eop_at ( double mjd_utc )

inline

Interpolate IERS EOP values at mjd_utc.

Parameters

mjd_utc UTC Modified Julian Date of the desired epoch.

Returns: std::optional<EopValues> containing the result, or std::nullopt when the epoch is outside the compiled data range.

if (auto eop = tempoch::eop_at(51544.5)) {
    std::cout << "DUT1 = " << eop->ut1_minus_utc << " s\n";
}

Definition at line 81 of file eop.hpp.

References check_status(), and tempoch::EopValues::mjd_utc.

◆ eop_covers()

bool tempoch::eop_covers ( double mjd_utc )

inlinenoexcept

Check whether EOP data is available for mjd_utc.

Parameters

mjd_utc UTC Modified Julian Date to query.

Returns: true if eop_at(mjd_utc) would succeed.

Definition at line 66 of file eop.hpp.

◆ from_gnss_week()

template<typename S , std::enable_if_t< is_gnss_scale_v< S >, int > = 0>

Time< S > tempoch::from_gnss_week ( const GnssWeek & gw )

inline

Build a GNSS-scale instant from a week-number decomposition.

Definition at line 56 of file gnss_week.hpp.

References check_status(), tempoch::Time< S >::from_split_seconds(), and scale_tag_v.

◆ intersect_periods()

template<typename T >

std::vector< Period< T > > tempoch::intersect_periods	(	const std::vector< Period< T > > &	a,
		const std::vector< Period< T > > &	b
	)

inline

Definition at line 163 of file period.hpp.

References check_status(), scale_tag_v, and tempoch::detail::to_raw().

◆ normalize_periods()

template<typename T >

std::vector< Period< T > > tempoch::normalize_periods ( const std::vector< Period< T > > & periods )

inline

Definition at line 185 of file period.hpp.

References check_status(), scale_tag_v, and tempoch::detail::to_raw().

◆ operator<<() [1/4]

std::ostream & tempoch::operator<<	(	std::ostream &	os,
		const CivilTime &	u
	)

inline

Stream CivilTime as YYYY-MM-DD HH:MM:SS[.nnnnnnnnn].

Definition at line 57 of file civil_time.hpp.

References tempoch::CivilTime::day, tempoch::CivilTime::hour, tempoch::CivilTime::minute, tempoch::CivilTime::month, tempoch::CivilTime::nanosecond, tempoch::CivilTime::second, and tempoch::CivilTime::year.

◆ operator<<() [2/4]

template<typename S , typename F >

std::ostream & tempoch::operator<<	(	std::ostream &	os,
		const EncodedTime< S, F > &	time
	)

inline

Definition at line 506 of file time_base.hpp.

References scale_tag_v.

◆ operator<<() [3/4]

template<typename T >

std::ostream & tempoch::operator<<	(	std::ostream &	os,
		const Period< T > &	period
	)

inline

Definition at line 194 of file period.hpp.

References scale_tag_v.

◆ operator<<() [4/4]

template<typename S >

std::ostream & tempoch::operator<<	(	std::ostream &	os,
		const Time< S > &	time
	)

inline

Definition at line 305 of file time_base.hpp.

References scale_tag_v.

◆ Period()

template<typename T >

tempoch::Period	(	T	,
		T
	)		-> Period< T >

◆ time_data_status()

TimeDataStatus tempoch::time_data_status ( )

inline

Capture the status of the currently active time-data bundle.

Mirrors tempoch::time_data_status().

Definition at line 63 of file data_status.hpp.

References check_status(), tempoch::DataHorizons::delta_t_prediction_horizon_mjd, tempoch::DataHorizons::eop_end_mjd, tempoch::DataHorizons::eop_observed_end_mjd, tempoch::DataHorizons::eop_start_mjd, tempoch::TimeDataStatus::horizons, tempoch::DataHorizons::modern_delta_t_observed_end_mjd, and tempoch::TimeDataStatus::source.

◆ to_gnss_week()

template<typename S , std::enable_if_t< is_gnss_scale_v< S >, int > = 0>

GnssWeek tempoch::to_gnss_week ( const Time< S > & time )

inline

Decompose a GNSS-scale instant into its week-number form.

Definition at line 46 of file gnss_week.hpp.

References tempoch::Time< S >::c_inner(), check_status(), scale_tag_v, and tempoch::GnssWeek::week.

◆ union_periods()

template<typename T >

std::vector< Period< T > > tempoch::union_periods	(	const std::vector< Period< T > > &	a,
		const std::vector< Period< T > > &	b
	)

inline

Definition at line 174 of file period.hpp.

References check_status(), scale_tag_v, and tempoch::detail::to_raw().

◆ validate_periods()

template<typename T >

void tempoch::validate_periods ( const std::vector< Period< T > > & periods )

inline

Definition at line 157 of file period.hpp.

References check_status(), scale_tag_v, and tempoch::detail::to_raw().

Variable Documentation

◆ format_tag_v

template<typename F >

constexpr tempoch_format_tag_t tempoch::format_tag_v = FormatTraits<F>::ffi_tag

inlineconstexpr

Definition at line 13 of file formats/base.hpp.

◆ is_format_v

template<typename T >

constexpr bool tempoch::is_format_v = is_format<T>::value

inlineconstexpr

Definition at line 10 of file formats/base.hpp.

◆ is_gnss_scale_v

template<typename S >

constexpr bool tempoch::is_gnss_scale_v = is_gnss_scale<S>::value

inlineconstexpr

Definition at line 28 of file gnss_week.hpp.

◆ is_scale_v

template<typename T >

constexpr bool tempoch::is_scale_v = is_scale<T>::value

inlineconstexpr

Definition at line 9 of file scales/base.hpp.

◆ scale_tag_v

template<typename S >

constexpr tempoch_scale_tag_t tempoch::scale_tag_v = ScaleTraits<S>::ffi_tag

inlineconstexpr

Definition at line 12 of file scales/base.hpp.

Namespaces

Classes

Typedefs

Enumerations

Functions

Variables

Typedef Documentation

◆ GpsTime

◆ J2000Seconds

◆ JulianDate

◆ ModifiedJulianDate

◆ TTMjdPeriod

◆ UnixTime

◆ UTCPeriod

Enumeration Type Documentation

◆ TimeDataSource

Function Documentation

◆ check_status()

◆ delta_t_seconds()

◆ delta_t_seconds_extrapolated()

◆ eop_at()

◆ eop_covers()

◆ from_gnss_week()

◆ intersect_periods()

◆ normalize_periods()

◆ operator<<() [1/4]

◆ operator<<() [2/4]

◆ operator<<() [3/4]

◆ operator<<() [4/4]

◆ Period()

◆ time_data_status()

◆ to_gnss_week()

◆ union_periods()

◆ validate_periods()

Variable Documentation

◆ format_tag_v

◆ is_format_v

◆ is_gnss_scale_v

◆ is_scale_v

◆ scale_tag_v