flipperzero 0.16.0

Rust for Flipper Zero
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52

//! Time and Date library.

use core::mem::MaybeUninit;

use flipperzero_sys as sys;

pub type DateTime = sys::DateTime;

/// Check if this is a valid datetime.
pub fn datetime_is_valid(datetime: &DateTime) -> bool {
    unsafe {
        // SAFETY: C function only reads from pointer
        sys::datetime_validate_datetime(datetime as *const _ as *mut _)
    }
}

/// Convert to UNIX timestamp (seconds since UNIX epoch).
///
/// [`DateTime`] is assumed to be UTC.
pub fn datetime_to_timestamp(datetime: &DateTime) -> u32 {
    unsafe {
        // SAFETY: C function only reads from pointer
        sys::datetime_datetime_to_timestamp(datetime as *const _ as *mut _)
    }
}

/// Convert from UNIX timestamp (seconds since UNIX epoch).
///
/// Returned [`DateTime`] is UTC.
pub fn datetime_from_timestamp(timestamp: u32) -> DateTime {
    let mut datetime = MaybeUninit::uninit();
    unsafe {
        sys::datetime_timestamp_to_datetime(timestamp, datetime.as_mut_ptr());
    }

    unsafe { datetime.assume_init() }
}

/// Gets the number of days in the year according to the Gregorian calendar.
pub fn days_per_year(year: u16) -> u16 {
    unsafe { sys::datetime_get_days_per_year(year) }
}

/// Check if a year a leap year in the Gregorian calendar.
pub fn is_leap_year(year: u16) -> bool {
    unsafe { sys::datetime_is_leap_year(year) }
}

/// Get the number of days in the month.
pub fn days_per_month(leap_year: bool, month: u8) -> u8 {
    unsafe { sys::datetime_get_days_per_month(leap_year, month) }
}