Enum Error 

pub enum Error {
    OutOfRange {
        requested: i64,
        valid_start: i64,
        valid_end: i64,
    },
    TableExpired {
        expires_at: i64,
    },
    InvalidTable {
        detail: &'static str,
    },
}

Errors that can occur during leap-second conversions or table construction.

All conversion methods on LeapSeconds return Result<T, Error>. Pattern-match to handle specific cases:

Example

use leap_sec::prelude::*;

let leaps = LeapSeconds::known();

match leaps.utc_to_tai(UtcUnixSeconds(0)) {
    Ok(tai) => println!("TAI: {tai}"),
    Err(Error::OutOfRange { requested, valid_start, .. }) => {
        println!("{requested} is before {valid_start}");
    }
    Err(e) => println!("other error: {e}"),
}

Variants

OutOfRange

The requested timestamp is before the first entry in the leap-second table.

Returned by LeapSeconds::utc_to_tai, LeapSeconds::tai_to_utc, and all other conversion and offset methods when the input is outside the table’s valid range.

Fields

requested: i64

The timestamp that was requested.

valid_start: i64

The earliest valid timestamp in the table.

valid_end: i64

The latest entry timestamp in the table.

TableExpired

The leap-second table has expired.

Reserved for future use when tables parsed from IERS files carry expiration timestamps. The built-in LeapSeconds::known() table never produces this error.

Fields

expires_at: i64

When the table expires, as a UTC Unix timestamp.

InvalidTable

The table data is invalid (used during builder validation).

Returned by LeapSecondsBuilder::build() when the table is empty or timestamps are not monotonically increasing.

Fields

detail: &'static str

A description of what is wrong with the table.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

Formats the error with a human-readable message.

• OutOfRange: "timestamp {requested} is outside the leap-second table range [{start}, {end}]"
• TableExpired: "leap-second table expired at {expires_at}; load a newer table or update the crate"
• InvalidTable: "invalid leap-second table: {detail}"

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

Formats the value using the given formatter.

impl Error for Error

Available on crate feature std only.

Enables use as Box<dyn std::error::Error> and in error-handling chains.

Available only with the std feature (enabled by default).

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for Error

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

impl StructuralPartialEq for Error