Struct ZonedDatetime 

pub struct ZonedDatetime { /* private fields */ }

A datetime with a fixed UTC offset.

Internally stores the instant as microseconds since the Unix epoch (same as Timestamp) plus an offset in seconds from UTC. Two ZonedDatetime values are equal when they refer to the same instant, even if their offsets differ.

Examples

use grafeo_common::types::ZonedDatetime;

let zdt = ZonedDatetime::parse("2024-06-15T10:30:00+05:30").unwrap();
assert_eq!(zdt.offset_seconds(), 19800);
assert_eq!(zdt.to_string(), "2024-06-15T10:30:00+05:30");

Implementations

impl ZonedDatetime

pub const fn from_timestamp_offset(ts: Timestamp, offset_seconds: i32) -> Self

Creates a ZonedDatetime from a UTC timestamp and an offset in seconds.

pub fn from_date_time(date: Date, time: Time) -> Option<Self>

Creates a ZonedDatetime from a date and a time with a required offset.

Returns None if the time has no offset.

pub const fn as_timestamp(&self) -> Timestamp

Returns the underlying UTC timestamp.

pub const fn offset_seconds(&self) -> i32

Returns the UTC offset in seconds.

pub fn to_local_date(&self) -> Date

Returns the date in the local (offset-adjusted) timezone.

pub fn to_local_time(&self) -> Time

Returns the time-of-day in the local (offset-adjusted) timezone, carrying the offset.

pub fn truncate(&self, unit: &str) -> Option<Self>

Truncates this zoned datetime to the given unit, preserving the offset.

Truncation is performed on the local (offset-adjusted) time, then converted back to UTC. This ensures that truncating to “day” gives midnight in the local timezone, not midnight UTC.

pub fn parse(s: &str) -> Option<Self>

Parses an ISO 8601 datetime string with a mandatory UTC offset.

Accepted formats:

• YYYY-MM-DDTHH:MM:SS+HH:MM
• YYYY-MM-DDTHH:MM:SS.fff+HH:MM
• YYYY-MM-DDTHH:MM:SSZ

Returns None if the string is not valid or has no offset.

Trait Implementations

impl Clone for ZonedDatetime

fn clone(&self) -> ZonedDatetime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ZonedDatetime

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ZonedDatetime

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ZonedDatetime

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

Formats the value using the given formatter.

impl From<ZonedDatetime> for Value

fn from(zdt: ZonedDatetime) -> Self

Converts to this type from the input type.

impl Hash for ZonedDatetime

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 Ord for ZonedDatetime

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ZonedDatetime

fn eq(&self, other: &Self) -> 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 PartialOrd for ZonedDatetime

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for ZonedDatetime

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for ZonedDatetime

impl Eq for ZonedDatetime