Struct dicom_core::value::partial::DicomDate

pub struct DicomDate(_);

Represents a Dicom Date value with a partial precision, where some date components may be missing.

Unlike Rust’s chrono::NaiveDate, it does not allow for negative years.

DicomDate implements AsRange trait, enabling to retrieve specific chrono::NaiveDate values.

Example

use chrono::NaiveDate;
use dicom_core::value::{DicomDate, AsRange};

let date = DicomDate::from_y(1492)?;

assert_eq!(
    date.latest()?,
    NaiveDate::from_ymd(1492,12,31)
);

let date = DicomDate::try_from(&NaiveDate::from_ymd(1900, 5, 3))?;
// conversion from chrono value leads to a precise value
assert_eq!(date.is_precise(), true);

assert_eq!(date.to_string(), "1900-05-03");

Implementations

impl DicomDate

pub fn from_y(year: u16) -> Result<DicomDate, Error>

Constructs a new DicomDate with year precision (YYYY)

pub fn from_ym(year: u16, month: u8) -> Result<DicomDate, Error>

Constructs a new DicomDate with year and month precision (YYYYMM)

pub fn from_ymd(year: u16, month: u8, day: u8) -> Result<DicomDate, Error>

Constructs a new DicomDate with a year, month and day precision (YYYYMMDD)

pub fn year(&self) -> &u16

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

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

impl DicomDate

pub fn to_encoded(&self) -> String

Retrieves a dicom encoded string representation of the value.

impl DicomDate

pub fn to_naive_date(self) -> Result<NaiveDate, Error>

Retrieves a chrono::NaiveDate if the value is precise up to the day of the month.

Trait Implementations

impl AsRange for DicomDate

type Item = NaiveDate

type Range = DateRange

fn earliest(&self) -> Result<NaiveDate, 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<NaiveDate, 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<DateRange, 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 DicomDate

fn clone(&self) -> DicomDate

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DicomDate

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

Formats the value using the given formatter.

impl Display for DicomDate

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

Formats the value using the given formatter.

impl From<DicomDate> for PrimitiveValue

fn from(value: DicomDate) -> Self

Converts to this type from the input type.

impl PartialEq<DicomDate> for DicomDate

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

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

const 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 DicomDate

fn precision(&self) -> DateComponent

impl TryFrom<&NaiveDate> for DicomDate

type Error = Error

The type returned in the event of a conversion error.

fn try_from(date: &NaiveDate) -> Result<Self, Error>

Performs the conversion.

impl Copy for DicomDate

impl StructuralPartialEq for DicomDate