embassy-rp 0.10.0

Embassy Hardware Abstraction Layer (HAL) for the Raspberry Pi RP2040 or RP235x microcontroller
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

/// Alias for [`chrono::NaiveDateTime`]
pub type DateTime = chrono::NaiveDateTime;
/// Alias for [`chrono::Weekday`]
pub type DayOfWeek = chrono::Weekday;

/// Errors regarding the [`DateTime`] struct.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
#[cfg_attr(feature = "defmt", derive(defmt::Format))]
pub enum Error {
    /// The [DateTime] has an invalid year. The year must be between 0 and 4095.
    InvalidYear,
    /// The [DateTime] contains an invalid date.
    InvalidDate,
    /// The [DateTime] contains an invalid time.
    InvalidTime,
    /// Outside valid range for Unix timestamp conversion
    OutOfRange,
    /// Invalid timestamp or cannot be converted to valid DateTime
    InvalidTimestamp,
}

/// Convert to Unix timestamp (milliseconds since 1970-01-01 00:00:00 UTC)
///
/// # Errors
/// Returns error if DateTime is before 1970-01-01.
#[cfg(feature = "_rp235x")]
pub fn timestamp_millis(dt: &DateTime) -> Result<u64, Error> {
    crate::datetime::epoch::datetime_to_millis(dt)
}

/// Create from Unix timestamp (milliseconds since 1970-01-01 00:00:00 UTC)
///
/// # Errors
/// Returns error if timestamp cannot be represented as valid DateTime.
#[cfg(feature = "_rp235x")]
pub fn from_timestamp_millis(millis: u64) -> Result<DateTime, Error> {
    crate::datetime::epoch::millis_to_datetime(millis)
}