Struct dicom_core::value::partial::DicomTime

source ·

pub struct DicomTime(_);

Expand description

Represents a Dicom Time value with a partial precision, where some time components may be missing.

Unlike chrono::NaiveTime, this implemenation has only 6 digit precision for fraction of a second.

DicomTime implements AsRange trait, enabling to retrieve specific time values.

Example

use chrono::NaiveTime;
use dicom_core::value::{DicomTime, AsRange};

let time = DicomTime::from_hm(12, 30)?;

assert_eq!(
    Some(time.latest()?),
    NaiveTime::from_hms_micro_opt(12, 30, 59, 999_999)
);

let milli = DicomTime::from_hms_milli(12, 30, 59, 123)?;

// value still not precise to microsecond
assert_eq!(milli.is_precise(), false);

assert_eq!(milli.to_string(), "12:30:59.123");

// for convenience, is precise enough to be retrieved as a NaiveTime
assert_eq!(
    Some(milli.to_naive_time()?),
    NaiveTime::from_hms_micro_opt(12, 30, 59, 123_000)
);

let time = DicomTime::try_from(&NaiveTime::from_hms_opt(12, 30, 59).unwrap())?;
// conversion from chrono value leads to a precise value
assert_eq!(time.is_precise(), true);

Implementations§

source §

impl DicomTime

source

pub fn from_h(hour: u8) -> Result<DicomTime, Error>

Constructs a new DicomTime with hour precision (HH).

source

pub fn from_hm(hour: u8, minute: u8) -> Result<DicomTime, Error>

Constructs a new DicomTime with hour and minute precision (HHMM).

source

pub fn from_hms(hour: u8, minute: u8, second: u8) -> Result<DicomTime, Error>

Constructs a new DicomTime with hour, minute and second precision (HHMMSS).

source

pub fn from_hms_milli(
 hour: u8,
 minute: u8,
 second: u8,
 millisecond: u32
) -> Result<DicomTime, Error>

Constructs a new DicomTime from an hour, minute, second and millisecond value, which leads to a (HHMMSS.FFF) precision. Millisecond cannot exceed 999.

source

pub fn from_hms_micro(
 hour: u8,
 minute: u8,
 second: u8,
 microsecond: u32
) -> Result<DicomTime, Error>

Constructs a new DicomTime from an hour, minute, second and microsecond value, which leads to full (HHMMSS.FFFFFF) precision. Microsecond cannot exceed 999_999.

source

pub fn hour(&self) -> &u8

Retrievies the hour from a time as a reference

source

pub fn minute(&self) -> Option<&u8>

Retrievies the minute from a time as a reference

source

pub fn second(&self) -> Option<&u8>

Retrievies the minute from a time as a reference

source

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

Retrievies the fraction of a second as a reference, if it has full (microsecond) precision.

source §

impl DicomTime

source

pub fn to_encoded(&self) -> String

Retrieves a dicom encoded string representation of the value.

source §

impl DicomTime

source

pub fn to_naive_time(self) -> Result<NaiveTime, Error>

Retrieves a chrono::NaiveTime if the value is precise up to the second.

Missing second fraction defaults to zero.

Trait Implementations§

source §

Returns the earliest possible chrono value from a partial precision structure. Missing components default to 1 (days, months) or 0 (hours, minutes, …) If structure contains invalid combination of DateComponents, it fails. Read more

source §

fn latest(&self) -> Result<NaiveTime, Error>

Returns the latest possible chrono value from a partial precision structure. If structure contains invalid combination of DateComponents, it fails. Read more

source §

fn range(&self) -> Result<TimeRange, Error>

Returns a tuple of the earliest and latest possible value from a partial precision structure.

source §

fn exact(&self) -> Result<Self::Item, Error>

Returns a corresponding chrono value, if the partial precision structure has full accuracy.

source §

fn is_precise(&self) -> bool

Returns true if partial precision structure has the maximum possible accuracy. For fraction of a second, the full 6 digits are required for the value to be precise. Read more

source §