Enum Edtf 

pub enum Edtf {
    Date(Date),
    DateTime(DateTime),
    Interval(Interval),
    Set(Set),
}

Any parsed EDTF expression.

Variants

Date(Date)

A single date.

DateTime(DateTime)

A date with time of day (level 0 only).

Interval(Interval)

A time interval.

Set(Set)

A set of dates (level 2).

Implementations

impl Edtf

pub fn bounds(&self) -> Bounds

Compute the earliest/latest calendar-day bounds of this expression.

impl Edtf

pub fn relation(&self, other: &Edtf) -> Relations

The three-valued temporal relation between this expression and other, computed over the two Edtf::bounds regions (see the semantics note in this module’s documentation).

use edtf_core::{Edtf, Modality, Relation};

let a = Edtf::parse("1985~").unwrap();
let b = Edtf::parse("199X").unwrap();
assert_eq!(a.relation(&b).definite(), Some(Relation::Before));

let c = Edtf::parse("198X").unwrap();
let d = Edtf::parse("1985").unwrap();
// 198X may fall before, on, after or around 1985 — nothing asserted.
assert_eq!(c.relation(&d).definite(), None);
assert!(c.relation(&d).is_possible(Relation::Before));
assert!(c.relation(&d).is_possible(Relation::After));
assert!(c.relation(&d).is_possible(Relation::Contains));

impl Edtf

pub fn parse(input: &str) -> Result<Self, ParseError>

Parse an EDTF string (levels 0–2, ISO 8601-2:2019 Annex A).

pub fn level(&self) -> u8

The minimum EDTF conformance level (0, 1 or 2) able to express this value. Semantically equivalent spellings classify identically: e.g. ?1985-?04-?12 reports level 1 because 1985-04-12? means the same.

pub fn is_uncertain(&self) -> bool

True if any component anywhere is marked uncertain (? or %).

pub fn is_approximate(&self) -> bool

True if any component anywhere is marked approximate (~ or %).

pub fn has_unspecified(&self) -> bool

True if any component anywhere contains an unspecified digit (X).

Trait Implementations

impl Clone for Edtf

fn clone(&self) -> Edtf

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Edtf

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

Formats the value using the given formatter.

impl Display for Edtf

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

Formats the value using the given formatter.

impl Eq for Edtf

impl FromStr for Edtf

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq for Edtf

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Edtf