Types
use record datetimeunstable: clocks-timezone
from wasi:clocks/wall-clock@0.2.8
A time and date in seconds plus nanoseconds.
seconds:u64nanoseconds:u32
record timezone-displayunstable: clocks-timezone
Information useful for displaying the timezone of a specific datetime.
This information may vary within a single timezone to reflect daylight
saving time adjustments.
utc-offset:s32The number of seconds difference between UTC time and the local time of the timezone.
The returned value will always be less than 86400 which is the number of seconds in a day (246060).
In implementations that do not expose an actual time zone, this should return 0.
name:stringThe abbreviated name of the timezone to display to a user. The name
UTCindicates Coordinated Universal Time. Otherwise, this should reference local standards for the name of the time zone.In implementations that do not expose an actual time zone, this should be the string
UTC.In time zones that do not have an applicable name, a formatted representation of the UTC offset may be returned, such as
-04:00.in-daylight-saving-time:boolWhether daylight saving time is active.
In implementations that do not expose an actual time zone, this should return false.
Functions
display: func(when: datetime) -> timezone-displayunstable: clocks-timezone
Return information needed to display the given datetime. This includes
the UTC offset, the time zone name, and a flag indicating whether
daylight saving time is active.
If the timezone cannot be determined for the given datetime, return a
timezone-display for UTC with a utc-offset of 0 and no daylight
saving time.
utc-offset: func(when: datetime) -> s32unstable: clocks-timezone
The same as display, but only return the UTC offset.
WIT
@unstable(feature = clocks-timezone)
interface timezone {
@unstable(feature = clocks-timezone)
use wall-clock.{datetime};
/// Information useful for displaying the timezone of a specific `datetime`.
///
/// This information may vary within a single `timezone` to reflect daylight
/// saving time adjustments.
@unstable(feature = clocks-timezone)
record timezone-display {
/// The number of seconds difference between UTC time and the local
/// time of the timezone.
///
/// The returned value will always be less than 86400 which is the
/// number of seconds in a day (24*60*60).
///
/// In implementations that do not expose an actual time zone, this
/// should return 0.
utc-offset: s32,
/// The abbreviated name of the timezone to display to a user. The name
/// `UTC` indicates Coordinated Universal Time. Otherwise, this should
/// reference local standards for the name of the time zone.
///
/// In implementations that do not expose an actual time zone, this
/// should be the string `UTC`.
///
/// In time zones that do not have an applicable name, a formatted
/// representation of the UTC offset may be returned, such as `-04:00`.
name: string,
/// Whether daylight saving time is active.
///
/// In implementations that do not expose an actual time zone, this
/// should return false.
in-daylight-saving-time: bool,
}
/// Return information needed to display the given `datetime`. This includes
/// the UTC offset, the time zone name, and a flag indicating whether
/// daylight saving time is active.
///
/// If the timezone cannot be determined for the given `datetime`, return a
/// `timezone-display` for `UTC` with a `utc-offset` of 0 and no daylight
/// saving time.
@unstable(feature = clocks-timezone)
display: func(when: datetime) -> timezone-display;
/// The same as `display`, but only return the UTC offset.
@unstable(feature = clocks-timezone)
utc-offset: func(when: datetime) -> s32;
}