Struct DateTimeField 

pub struct DateTimeField {
    pub raw: String,
    pub datetime: Option<DateTime>,
}

A frontmatter datetime field: the scalar exactly as written, plus its parse.

Keeping the raw text lets a consumer round-trip the value and lets the okf-validator crate report which scalar is malformed instead of silently dropping it: the spec’s permissiveness rule means an unparseable datetime must never make a document unreadable.

Fields

raw: String

The scalar as written in the frontmatter.

datetime: Option<DateTime>

The parsed datetime, or None if raw is not an ISO-8601 datetime. A date-only or offset-less value remains available through datetime so it can be diagnosed without losing the original scalar.

Implementations

impl DateTimeField

pub fn new(raw: impl Into<String>) -> Self

Wraps a raw scalar, parsing it if possible.

pub const fn is_valid(&self) -> bool

true if the raw scalar parsed as an ISO-8601 datetime with a time of day and an explicit UTC offset.

pub const fn has_time(&self) -> bool

true if the raw scalar parsed as a datetime with a time of day.

DateTime::parse intentionally also accepts date-only values for callers that need a generic ISO-8601 date/datetime parser. OKF frontmatter timestamp fields use DateTimeField::is_valid.

pub const fn has_offset(&self) -> bool

true if the raw scalar parsed with an explicit UTC offset.

Trait Implementations

impl Clone for DateTimeField

fn clone(&self) -> DateTimeField

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DateTimeField

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

Formats the value using the given formatter.

impl Display for DateTimeField

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

Formats the value using the given formatter.

impl Eq for DateTimeField

impl PartialEq for DateTimeField

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DateTimeField