Struct dicom_core::value::partial::DicomTime

pub struct DicomTime(_);

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

impl DicomTime

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

Constructs a new DicomTime with hour precision (HH).

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

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

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

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

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.

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.

pub fn hour(&self) -> &u8

Retrievies the hour from a time as a reference

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

Retrievies the minute from a time as a reference

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

Retrievies the minute from a time as a reference

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

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

impl DicomTime

pub fn to_encoded(&self) -> String

Retrieves a dicom encoded string representation of the value.

impl DicomTime

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

impl AsRange for DicomTime

type Item = NaiveTime

type Range = TimeRange

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

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.

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.

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

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

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

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

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.

impl Clone for DicomTime

fn clone(&self) -> DicomTime

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DicomTime

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

Formats the value using the given formatter.

impl Display for DicomTime

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

Formats the value using the given formatter.

impl From<DicomTime> for PrimitiveValue

fn from(value: DicomTime) -> Self

Converts to this type from the input type.

impl PartialEq<DicomTime> for DicomTime

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Precision for DicomTime

fn precision(&self) -> DateComponent

impl TryFrom<&NaiveTime> for DicomTime

type Error = Error

The type returned in the event of a conversion error.

fn try_from(time: &NaiveTime) -> Result<Self, Error>

Performs the conversion.

impl Copy for DicomTime

impl StructuralPartialEq for DicomTime