Struct Fraction 

pub struct Fraction {
    pub(crate) digits: NonZeroU8,
    pub(crate) value: u64,
}

A fraction value in nanoseconds or lower value.

Precision note

ixdtf parses a fraction value to a precision of 18 digits of precision, but preserves the fraction’s digit length

Fields

digits: NonZeroU8

value: u64

Implementations

impl Fraction

pub fn to_nanoseconds(&self) -> Option<u32>

Returns Some(u32) representing the Fraction as it’s computed nanosecond value or None if the digits exceeds 9 digits.

use ixdtf::parsers::IxdtfParser;

// Fraction is below 9 digits.
let fraction_str = "2025-02-17T05:41:32.12345678";
let result = IxdtfParser::from_str(fraction_str).parse().unwrap();

let time = result.time.unwrap();
let fraction = time.fraction.unwrap();

assert_eq!(fraction.to_nanoseconds(), Some(123456780));

// Fraction is 10 digits.
let fraction_str = "2025-02-17T05:41:32.1234567898";
let result = IxdtfParser::from_str(fraction_str).parse().unwrap();
let time = result.time.unwrap();
let fraction = time.fraction.unwrap();

assert_eq!(fraction.to_nanoseconds(), None);

pub fn to_truncated_nanoseconds(&self) -> u32

Returns a u32 representing the Fraction as it’s computed nanosecond value, truncating any value beyond 9 digits to nanoseconds.

This method will return None if the value exceeds a represented range or the underlying Fraction is malformed.

use ixdtf::parsers::IxdtfParser;

// Fraction is 13 digits.
let fraction_str = "2025-02-17T05:41:32.1234567898765";
let result = IxdtfParser::from_str(fraction_str).parse().unwrap();

let time = result.time.unwrap();
let fraction = time.fraction.unwrap();

assert_eq!(fraction.to_truncated_nanoseconds(), 123456789);
assert_eq!(fraction.to_nanoseconds(), None);

Trait Implementations

impl Clone for Fraction

fn clone(&self) -> Fraction

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Fraction

impl Debug for Fraction

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

Formats the value using the given formatter.

impl PartialEq for Fraction

fn eq(&self, other: &Fraction) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Fraction