Struct TimezoneField 

pub struct TimezoneField { /* private fields */ }

A timezone selection field for WiFi provisioning.

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

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_in_memory( timezone_field_static: &'static TimezoneFieldStatic, ) -> &'static Self

Initialize a timezone field backed by in-memory state.

See the wifi_auto::fields module example for usage.

pub fn new_with_flash( timezone_field_static: &'static TimezoneFieldStatic, timezone_flash_block: FlashBlockEsp, ) -> &'static Self

Initialize a timezone field backed by a flash block.

See the wifi_auto::fields module example for usage.

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

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_minutes: i32) -> Result<(), Error>

Save a timezone offset in minutes from UTC.

This allows programmatic updates to timezone settings.

For flash-backed fields, this only writes when the value changes to reduce unnecessary flash wear.

See the wifi_auto::fields module example for usage.

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

Clear the stored timezone offset.

See the wifi_auto::fields module example for usage.

impl TimezoneField

pub fn new( timezone_field_static: &'static TimezoneFieldStatic, timezone_flash_block: FlashBlockEsp, ) -> &'static Self

Initialize a timezone field backed by a flash block.

See the WifiAutoEsp struct example for usage.

Trait Implementations

impl WifiAutoField for TimezoneField

type Error = Error

Platform crate error type used by field implementations.

fn render(&self, page: &mut HtmlBuffer) -> Result<(), Error>

Render form HTML elements.

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

Parse submitted form data and typically persist the field value.

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

Whether this field currently has valid configured data.

impl Sync for TimezoneField