Struct TimezoneField 

pub struct TimezoneField { /* private fields */ }

Available on crate feature wifi and target_os=none only.

A timezone selection field for WiFi provisioning.

Allows users to select their timezone from a dropdown during the captive portal setup. The selected offset (in minutes from UTC) is persisted to flash and can be retrieved later.

See the wifi_auto::fields module example for usage.

Implementations

impl TimezoneField

pub const fn new_static() -> TimezoneFieldStatic

Create static resources for TimezoneField.

See the wifi_auto::fields module example for usage.

pub fn new( timezone_field_static: &'static TimezoneFieldStatic, flash: FlashBlock, ) -> &'static Self

Initialize a new timezone field.

See the wifi_auto::fields module example for usage.

pub fn offset_minutes(&self) -> Result<Option<i32>>

Load the stored timezone offset in minutes from UTC.

Returns None if no timezone has been configured yet.

See the wifi_auto::fields module example for usage.

pub fn set_offset_minutes(&self, offset: i32) -> Result<()>

Save a new timezone offset in minutes from UTC to flash.

This method allows programmatic updates to the timezone, such as when the user adjusts the timezone via button presses or other UI interactions.

Only writes to flash if the value has changed, avoiding unnecessary flash wear.

Alternatively, you can access the underlying flash block directly for more control over flash operations.

pub fn clear(&self) -> Result<()>

Clear the stored timezone offset, returning the field to an unconfigured state.

Trait Implementations

impl WifiAutoField for TimezoneField

fn render(&self, page: &mut String<16384>) -> Result<()>

Render HTML form elements for this field.

fn parse(&self, form: &FormData<'_>) -> Result<()>

Parse and save form data submitted by the user.

fn is_satisfied(&self) -> Result<bool>

Check if this field has valid configuration.

impl Sync for TimezoneField