tempoch-cpp is a C++17 library for astronomical time primitives. It provides a header-only C++ API backed by the Rust tempoch-ffi engine (via a C FFI), with explicit time scales, explicit encodings, UTC civil conversion, and generic period operations.

• Split scale/format model: Time<scale::TT>, JulianDate<scale::TT>, JulianDate<scale::UTC>, ModifiedJulianDate<scale::UT1>, UnixTime, and GpsTime
• Civil UTC representation with nanosecond precision via tempoch::CivilTime
• Explicit conversion flow: CivilTime -> Time<scale::UTC> -> Time<scale::TT> -> to<format::JD>()
• TimeContext for UT1 and historical UTC routes
• Time arithmetic using qtty-cpp duration quantities such as qtty::Day, qtty::Hour, and qtty::Minute
• Period<T> intervals with typed start/end access, intersection, and duration conversion
• CMake target (tempoch_cpp) for straightforward integration

The C++ wrapper intentionally mirrors the current tempoch-ffi surface. Rust-only features such as serde, tagged wrappers, and runtime-bundle refresh/context management are not exposed in tempoch-cpp yet.

• CMake 3.15+
• C++17 compiler (GCC 8+, Clang 7+, MSVC 2019+)
• Rust/Cargo (builds tempoch-ffi)
• Installed qtty-cpp >= 0.4.5 package, or a local staged install passed through CMAKE_PREFIX_PATH

git clone <repo-url>
cd tempoch-cpp
git submodule update --init tempoch

# Debian/RPM systems can install the official qtty-cpp package with:
./scripts/install-official-cpp-deps.sh

cmake -S . -B build
cmake --build build --parallel
ctest --test-dir build --output-on-failure
./build/01_quickstart

For local qtty-cpp development, install qtty-cpp to a staging prefix and pass it to CMake:

cmake -S . -B build -DCMAKE_PREFIX_PATH=/path/to/qtty-stage

#include <iostream>
#include <qtty/qtty.hpp>
#include <tempoch/tempoch.hpp>
#include <tempoch/formats/jd.hpp>
#include <tempoch/formats/mjd.hpp>
#include <tempoch/scales/utc.hpp>

int main() {
    using namespace tempoch;

    CivilTime civil{2026, 7, 15, 22, 0, 0};
    auto jd_tt = JulianDate<scale::TT>::from_utc(civil);
    auto mjd_tt = ModifiedJulianDate<scale::TT>::from_jd(jd_tt);
    auto utc = Time<scale::TT>::from_encoded(jd_tt).to<scale::UTC>();
    auto jd_utc = utc.to<format::JD>();

    std::cout << "Civil UTC : " << civil << "\n";
    std::cout << "JD(TT)    : " << jd_tt << "\n";
    std::cout << "JD(UTC)   : " << jd_utc << "\n";
    std::cout << "MJD(TT)   : " << mjd_tt << "\n";

    Period observing_window(mjd_tt, mjd_tt + qtty::Hour(12.0));
    std::cout << "Duration: " << observing_window.duration<qtty::Hour>() << "\n";
}

Typed periods can be converted directly between scales and formats by applying the same conversion to both endpoints:

using namespace tempoch;

Period<EncodedTime<scale::UTC, format::JD>> window(
    EncodedTime<scale::UTC, format::JD>(2460000.0),
    EncodedTime<scale::UTC, format::JD>(2460001.0)
);

auto tt_mjd_window = window.to<scale::TT, format::MJD>();

UTCPeriod civil_window(
    CivilTime(2026, 1, 1),
    CivilTime(2026, 1, 2)
);

auto civil_tt_mjd_window = civil_window.to<scale::TT, format::MJD>();

The public headers are now split by concept:

• tempoch/scales/*.hpp for physical/civil time-axis tags and scale traits
• tempoch/formats/*.hpp for encoding tags and format traits
• tempoch/tempoch.hpp as the full umbrella include

Time arithmetic uses qtty-cpp quantities. Subtracting two times returns a typed duration, and adding or subtracting a quantity shifts the time value.

auto jd0 = tempoch::JulianDate<tempoch::scale::TT>::J2000();
auto jd1 = jd0 + qtty::Hour(12.0);
auto dt = jd1 - jd0;

std::cout << dt.to<qtty::Hour>() << "\n";

• Default astronomy-facing code should use TT-based JulianDate, MJD, and Period.
• Civil construction is available directly through JulianDate<scale::TT>::from_utc(...) and ModifiedJulianDate<scale::TT>::from_utc(...).
• The explicit typed core remains available through Time<scale::S> and EncodedTime<S, F> for mixed-scale work.

• docs/mainpage.md (API overview)
• examples/01_quickstart.cpp (civil UTC -> canonical time -> explicit encodings)
• examples/02_scales.cpp (all supported scale conversions)
• examples/10_transformations.cpp (scale-only, format-only, and combined conversions)
• include/tempoch/tempoch.hpp (umbrella public header)

find_package(qtty_cpp 0.4.5 REQUIRED)
add_subdirectory(path/to/tempoch-cpp)
target_link_libraries(your_target PRIVATE tempoch_cpp)

cmake --install build

find_package(tempoch_cpp REQUIRED)
target_link_libraries(your_target PRIVATE tempoch::tempoch_cpp)

This repository wraps the upstream tempoch project (git submodule in tempoch/). See tempoch/LICENSE for licensing details.