Struct DateTime 

pub struct DateTime { /* private fields */ }

Date and time representation used across RTC drivers.

This type represents calendar date and time in a general-purpose way, independent of any specific RTC hardware.

• Validates that year >= 1970
• Other limits (e.g., 2000-2099) must be enforced by individual drivers

Implementations

impl DateTime

pub fn new( year: u16, month: u8, day_of_month: u8, hour: u8, minute: u8, second: u8, ) -> Result<Self, DateTimeError>

Create a new DateTime instance with validation.

Errors

Returns a DateTimeError if any component is out of valid range.

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

Validate all datetime components.

Errors

Returns the first DateTimeError encountered.

pub fn year(&self) -> u16

Get the year (e.g. 2025).

pub fn month(&self) -> u8

Get the month number (1-12).

pub fn day_of_month(&self) -> u8

Get the day of the month (1-31).

pub fn hour(&self) -> u8

Get the hour (0-23).

pub fn minute(&self) -> u8

Get the minute (0-59).

pub fn second(&self) -> u8

Get the second (0-59).

pub fn set_year(&mut self, year: u16) -> Result<(), DateTimeError>

Set year with validation.

Re-validates the day in case of leap-year or February issues.

pub fn set_month(&mut self, month: u8) -> Result<(), DateTimeError>

Set month with validation.

Re-validates the day in case month/day mismatch occurs.

pub fn set_day_of_month( &mut self, day_of_month: u8, ) -> Result<(), DateTimeError>

Set day with validation.

pub fn set_hour(&mut self, hour: u8) -> Result<(), DateTimeError>

Set hour with validation.

pub fn set_minute(&mut self, minute: u8) -> Result<(), DateTimeError>

Set minute with validation.

pub fn set_second(&mut self, second: u8) -> Result<(), DateTimeError>

Set second with validation.

pub fn calculate_weekday(&self) -> Result<Weekday, DateTimeError>

Calculate weekday for this DateTime

Trait Implementations

impl Clone for DateTime

fn clone(&self) -> DateTime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DateTime

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

Formats the value using the given formatter.

impl PartialEq for DateTime

fn eq(&self, other: &DateTime) -> 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 Copy for DateTime

impl Eq for DateTime

impl StructuralPartialEq for DateTime