Struct bson::datetime::DateTimeBuilder

pub struct DateTimeBuilder<Y = NoYear, M = NoMonth, D = NoDay> { /* private fields */ }

Builder for constructing a BSON DateTime

Implementations

impl<M, D> DateTimeBuilder<NoYear, M, D>

pub fn year(self, y: i32) -> DateTimeBuilder<Year, M, D>

Sets the year for the builder instance. Years between ±9999 inclusive are valid. If the specified value is out of range, calling the build() method will return an error.

Note: This is a required method. You will not be able to call build() before calling this method.

impl<Y, D> DateTimeBuilder<Y, NoMonth, D>

pub fn month(self, m: u8) -> DateTimeBuilder<Y, Month, D>

Sets the month for the builder instance. Maps months as 1-January to 12-December. If the specified value is out of range, calling the build() method will return an error.

Note: This is a required method. You will not be able to call build() before calling this method.

impl<Y, M> DateTimeBuilder<Y, M, NoDay>

pub fn day(self, d: u8) -> DateTimeBuilder<Y, M, Day>

Sets the day for the builder instance. Values in the range 1..=31 are valid. If the specified value does not exist for the provided month/year or is out of range, calling the build() method will return an error.

Note: This is a required method. You will not be able to call build() before calling this method.

impl<Y, M, D> DateTimeBuilder<Y, M, D>

pub fn hour(self, hour: u8) -> DateTimeBuilder<Y, M, D>

Sets the hour (24-hour format) for the builder instance. Values must be in the range 0..=23. If the specified value is out of range, calling the build() method will return an error.

Note: This is an optional method. The hour will default to 0 if not explicitly set.

pub fn minute(self, minute: u8) -> DateTimeBuilder<Y, M, D>

Sets the minute for the builder instance. Values must be in the range 0..=59. If the specified value is out of range, calling the build() method will return an error.

Note: This is an optional method. The minute will default to 0 if not explicitly set.

pub fn second(self, second: u8) -> DateTimeBuilder<Y, M, D>

Sets the second for the builder instance. Values must be in range 0..=59. If the specified value is out of range, calling the build() method will return an error.

Note: This is an optional method. The second will default to 0 if not explicitly set.

pub fn millisecond(self, millisecond: u16) -> DateTimeBuilder<Y, M, D>

Sets the millisecond for the builder instance. Values must be in the range 0..=999. If the specified value is out of range, calling the build() method will return an error.

Note: This is an optional method. The millisecond will default to 0 if not explicitly set.

impl DateTimeBuilder<Year, Month, Day>

pub fn build(self) -> Result<DateTime>

Convert a builder with a specified year, month, day, and optionally, an hour, minute, second and millisecond to a DateTime.

Note: You cannot call build() before setting at least the year, month and day.

Trait Implementations

impl Default for DateTimeBuilder

fn default() -> Self

Returns the “default value” for a type.