Struct DateTimeBuilder

pub struct DateTimeBuilder { /* private fields */ }

A builder for DateTime objects, allowing more ergonomic creation of datetimes with customized year, month, day, hour, minute, second, and offset.

Examples

use dtt::datetime::{DateTime, DateTimeBuilder};
use time::UtcOffset;

let builder = DateTimeBuilder::new()
    .year(2024)
    .month(1)
    .day(1)
    .hour(12)
    .minute(30)
    .second(45)
    .offset(UtcOffset::UTC);

let dt = builder.build();
assert!(dt.is_ok());

let dt_unwrapped = dt.unwrap();
assert_eq!(dt_unwrapped.year(), 2024);
assert_eq!(dt_unwrapped.month().to_string(), "January");
assert_eq!(dt_unwrapped.day(), 1);
assert_eq!(dt_unwrapped.hour(), 12);
assert_eq!(dt_unwrapped.minute(), 30);
assert_eq!(dt_unwrapped.second(), 45);
assert_eq!(dt_unwrapped.offset(), UtcOffset::UTC);

Implementations

impl DateTimeBuilder

pub const fn new() -> Self

Creates a new DateTimeBuilder with default values set to midnight, January 1, 1970 (UTC).

pub const fn year(self, year: i32) -> Self

Sets the year component.

pub const fn month(self, month: u8) -> Self

Sets the month component.

pub const fn day(self, day: u8) -> Self

Sets the day component.

pub const fn hour(self, hour: u8) -> Self

Sets the hour component.

pub const fn minute(self, minute: u8) -> Self

Sets the minute component.

pub const fn second(self, second: u8) -> Self

Sets the second component.

pub const fn offset(self, offset: UtcOffset) -> Self

Sets the time zone offset component.

pub fn build(&self) -> Result<DateTime, DateTimeError>

Builds the final DateTime from the builder state.

Errors

Returns a DateTimeError if any of the date components are invalid (e.g., month = 13 or day = 32).

Trait Implementations

impl Clone for DateTimeBuilder

fn clone(&self) -> DateTimeBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DateTimeBuilder

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

Formats the value using the given formatter.

impl Default for DateTimeBuilder

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DateTimeBuilder

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for DateTimeBuilder

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for DateTimeBuilder

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for DateTimeBuilder

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for DateTimeBuilder

impl Eq for DateTimeBuilder

impl StructuralPartialEq for DateTimeBuilder