Struct UtcOffset 

pub struct UtcOffset {
    pub minutes: i16,
}

A UTC offset suitable for DateHourMin and DateTime precision tiers.

Stored as signed integer minutes from UTC in the range −1439..=+1439 (i.e. ±23:59). The maximum representable offset is ±23:59; offsets of ±24:00 or larger are rejected by UtcOffset::from_hhmm. None in the parent type represents a floating (offset-naive) time.

Examples

use marque_ism::date::UtcOffset;

let eastern = UtcOffset::from_hhmm(-1, 5, 0).unwrap(); // -05:00
assert_eq!(eastern.to_string(), "-05:00");

assert_eq!(UtcOffset::UTC.to_string(), "Z");

Fields

minutes: i16

Signed offset in minutes: +05:30 → 330, −07:00 → −420.

Implementations

impl UtcOffset

pub const UTC: Self

UTC (zero offset).

pub fn from_hhmm(sign: i8, hours: u8, minutes: u8) -> Option<Self>

Construct from a sign and hours/minutes.

sign must be 1 or -1. Returns None if components are out of range (hours > 23, minutes > 59). The maximum representable offset magnitude is 23:59 (1439 minutes).

pub fn to_seconds(self) -> i32

Total offset in seconds (for jiff tz::Offset::from_seconds).

Trait Implementations

impl Clone for UtcOffset

fn clone(&self) -> UtcOffset

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UtcOffset

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for UtcOffset

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromStr for UtcOffset

fn from_str(s: &str) -> Result<Self, Self::Err>

Parse a standalone ISO 8601 UTC offset string.

Accepted forms:

• "Z" → UTC (zero offset)
• "+HH:MM" → positive offset (e.g. "+05:30")
• "-HH:MM" → negative offset (e.g. "-05:00")

Returns Err for any other form (e.g. "EST", "UTC", "+0530").

type Err = ParseIsmDateError

The associated error which can be returned from parsing.

impl Hash for UtcOffset

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for UtcOffset

fn eq(&self, other: &UtcOffset) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for UtcOffset

impl Eq for UtcOffset

impl StructuralPartialEq for UtcOffset