Struct ZTime 

pub struct ZTime<B: DateBackend> { /* private fields */ }

Available on crate features chrono or jiff or time only.

Schema for a time of day: HH:MM:SS[.fraction] (no offset) into the backend’s time type (chrono::NaiveTime, jiff::civil::Time or time::Time).

Created via vld::chrono::time(), vld::jiff::time() or vld::time::time() (or vld::time_of_day() when exactly one backend is enabled). Malformed input fails with invalid_date (kind time); bounds with too_small / too_big (origin time). JSON Schema: a pattern for HH:MM:SS[.frac] (format: time would require an offset).

Implementations

impl<B: DateBackend> ZTime<B>

pub fn new() -> Self

Create the schema (the same as its vld:: constructor function).

pub fn type_error(self, msg: impl Into<String>) -> Self

Set a custom error message for type mismatch (non-string input).

pub fn min(self, time: &str) -> Self

Earliest time (inclusive). Accepts "HH:MM:SS[.frac]"; panics on an invalid literal.

pub fn min_time(self, time: B::Time) -> Self

Earliest time (inclusive) from a backend time value.

pub fn max(self, time: &str) -> Self

Latest time (inclusive). Accepts "HH:MM:SS[.frac]"; panics on an invalid literal.

pub fn max_time(self, time: B::Time) -> Self

Latest time (inclusive) from a backend time value.

Trait Implementations

impl<B: Clone + DateBackend> Clone for ZTime<B>

where B::Time: Clone,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<B: DateBackend> CollectNestedSchemas for ZTime<B>

fn collect_nested_schemas(&self, _out: &mut Vec<NestedSchemaEntry>)

Available on crate feature openapi only.

Add the named schemas this schema references to _out (for components.schemas).

impl<B: DateBackend> Default for ZTime<B>

fn default() -> Self

Returns the “default value” for a type.

impl<B: DateBackend> JsonSchema for ZTime<B>

{"type": "string", "format": "partial-time", "pattern": ...} — RFC 3339 partial-time (not format: time, which requires an offset; validators ignore the unknown format and use the pattern); min/max become formatMinimum/formatMaximum.

fn json_schema(&self) -> Value

Available on crate feature openapi only.

Generate a JSON Schema representation.

fn is_required(&self) -> bool

Available on crate feature openapi only.

Whether this schema should be included in an object’s required array.

impl<B: DateBackend> VldSchema for ZTime<B>

type Output = <B as DateBackend>::Time

The Rust type produced by this schema after successful parsing.

fn parse_value(&self, value: &Value) -> Result<B::Time, VldError>

Parse and validate a serde_json::Value.

fn parse_missing(&self) -> Result<Self::Output, VldError>

Parse an object field whose key is absent.

fn parse<I: VldInput + ?Sized>( &self, input: &I, ) -> Result<Self::Output, VldError>

Parse from any supported input (JSON string, file path, serde_json::Value, etc.)

fn validate<T: Serialize>(&self, value: &T) -> Result<Self::Output, VldError>

Validate an existing Rust value against this schema.

fn is_valid<T: Serialize>(&self, value: &T) -> bool

Check if an existing Rust value passes this schema’s validation.

fn optional(self) -> ZOptional<Self>

Make this field optional. Missing or null values become None.

fn nullable(self) -> ZNullable<Self>

Allow null values. Null becomes None.

fn with_default(self, value: Self::Output) -> ZDefault<Self>

where Self::Output: Clone,

Provide a default value when the field is missing or null.

fn blank_as(self, value: Self::Output) -> ZDefault<Self>

where Self::Output: Clone,

Like with_default, and a blank string (empty or whitespace only) also becomes value: legacy stores that write "" or null for “unset”.

fn refine<F>(self, check: F, message: &str) -> ZRefine<Self, F>

where F: Fn(&Self::Output) -> bool,

Add a custom refinement check without changing the output type.

fn rule<R>(self, rule: R) -> ZRule<Self, R>

where Self: Sized, R: Rule<Self::Output>,

Check the output with a reusable Rule (output type unchanged).

fn rule_msg<R>(self, rule: R, msg: impl Into<String>) -> ZRule<Self, R>

where Self: Sized, R: Rule<Self::Output>,

rule with a custom error message.

fn try_transform<F, U, E>(self, f: F) -> ZTryTransform<Self, F, U>

where F: Fn(Self::Output) -> Result<U, E>, E: Display,

Transform the output with a fallible function; an Err becomes a validation issue (Custom { code: "transform" }, message = the error).

fn transform<F, U>(self, f: F) -> ZTransform<Self, F, U>

where F: Fn(Self::Output) -> U,

Transform the output value after successful parsing.

fn nullish(self) -> ZNullish<Self>

Make this field nullish (both optional and nullable).

fn catch(self, fallback: Self::Output) -> ZCatch<Self>

where Self::Output: Clone,

Return a fallback value on ANY validation error.

fn pipe<S: VldSchema>(self, next: S) -> ZPipe<Self, S>

where Self::Output: Serialize,

Chain this schema’s output into another schema.

fn describe(self, description: &str) -> ZDescribe<Self>

Attach a human-readable description/label to this schema.

fn super_refine<F>(self, check: F) -> ZSuperRefine<Self, F>

where F: Fn(&Self::Output, &mut VldError),

Add a custom refinement that can produce multiple errors.

fn or<B: VldSchema>(self, other: B) -> ZUnion2<Self, B>

Create a union: this schema or another. Returns Either<Self::Output, B::Output>.

fn and<B: VldSchema>(self, other: B) -> ZIntersection<Self, B>

Create an intersection: input must satisfy both schemas.

fn message(self, msg: impl Into<String>) -> ZMessage<Self>

Override the error message for this schema.