Struct sqlx::types::time::UtcOffset [−]
pub struct UtcOffset { /* fields omitted */ }
Expand description
An offset from UTC.
Guaranteed to store values up to ±23:59:59. Any values outside this range may have incidental support that can change at any time without notice. If you need support outside this range, please file an issue with your use case.
Implementations
impl UtcOffset
impl UtcOffset
pub const fn east_hours(hours: u8) -> UtcOffset
pub const fn east_hours(hours: u8) -> UtcOffset
Create a UtcOffset
representing an easterly offset by the number of
hours provided.
assert_eq!(UtcOffset::east_hours(1).as_hours(), 1);
assert_eq!(UtcOffset::east_hours(2).as_minutes(), 120);
pub const fn west_hours(hours: u8) -> UtcOffset
pub const fn west_hours(hours: u8) -> UtcOffset
Create a UtcOffset
representing a westerly offset by the number of
hours provided.
assert_eq!(UtcOffset::west_hours(1).as_hours(), -1);
assert_eq!(UtcOffset::west_hours(2).as_minutes(), -120);
Create a UtcOffset
representing an offset by the number of hours
provided.
assert_eq!(UtcOffset::hours(2).as_minutes(), 120);
assert_eq!(UtcOffset::hours(-2).as_minutes(), -120);
pub const fn east_minutes(minutes: u16) -> UtcOffset
pub const fn east_minutes(minutes: u16) -> UtcOffset
Create a UtcOffset
representing an easterly offset by the number of
minutes provided.
assert_eq!(UtcOffset::east_minutes(60).as_hours(), 1);
pub const fn west_minutes(minutes: u16) -> UtcOffset
pub const fn west_minutes(minutes: u16) -> UtcOffset
Create a UtcOffset
representing a westerly offset by the number of
minutes provided.
assert_eq!(UtcOffset::west_minutes(60).as_hours(), -1);
Create a UtcOffset
representing a offset by the number of minutes
provided.
assert_eq!(UtcOffset::minutes(60).as_hours(), 1);
assert_eq!(UtcOffset::minutes(-60).as_hours(), -1);
pub const fn east_seconds(seconds: u32) -> UtcOffset
pub const fn east_seconds(seconds: u32) -> UtcOffset
Create a UtcOffset
representing an easterly offset by the number of
seconds provided.
assert_eq!(UtcOffset::east_seconds(3_600).as_hours(), 1);
assert_eq!(UtcOffset::east_seconds(1_800).as_minutes(), 30);
pub const fn west_seconds(seconds: u32) -> UtcOffset
pub const fn west_seconds(seconds: u32) -> UtcOffset
Create a UtcOffset
representing a westerly offset by the number of
seconds provided.
assert_eq!(UtcOffset::west_seconds(3_600).as_hours(), -1);
assert_eq!(UtcOffset::west_seconds(1_800).as_minutes(), -30);
Create a UtcOffset
representing an offset by the number of seconds
provided.
assert_eq!(UtcOffset::seconds(3_600).as_hours(), 1);
assert_eq!(UtcOffset::seconds(-3_600).as_hours(), -1);
pub const fn as_seconds(self) -> i32
pub const fn as_seconds(self) -> i32
Get the number of seconds from UTC the value is. Positive is east, negative is west.
assert_eq!(UtcOffset::UTC.as_seconds(), 0);
assert_eq!(UtcOffset::hours(12).as_seconds(), 43_200);
assert_eq!(UtcOffset::hours(-12).as_seconds(), -43_200);
pub const fn as_minutes(self) -> i16
pub const fn as_minutes(self) -> i16
Get the number of minutes from UTC the value is. Positive is east, negative is west.
assert_eq!(UtcOffset::UTC.as_minutes(), 0);
assert_eq!(UtcOffset::hours(12).as_minutes(), 720);
assert_eq!(UtcOffset::hours(-12).as_minutes(), -720);
Get the number of hours from UTC the value is. Positive is east, negative is west.
assert_eq!(UtcOffset::UTC.as_hours(), 0);
assert_eq!(UtcOffset::hours(12).as_hours(), 12);
assert_eq!(UtcOffset::hours(-12).as_hours(), -12);
pub fn local_offset_at(datetime: OffsetDateTime) -> UtcOffset
👎 Deprecated since 0.2.23: UTC is returned if the local offset cannot be determined
pub fn local_offset_at(datetime: OffsetDateTime) -> UtcOffset
UTC is returned if the local offset cannot be determined
Obtain the system’s UTC offset at a known moment in time. If the offset cannot be determined, UTC is returned.
let unix_epoch = OffsetDateTime::unix_epoch();
let local_offset = UtcOffset::local_offset_at(unix_epoch);
println!("{}", local_offset.format("%z"));
pub fn try_local_offset_at(
datetime: OffsetDateTime
) -> Result<UtcOffset, IndeterminateOffset>
pub fn try_local_offset_at(
datetime: OffsetDateTime
) -> Result<UtcOffset, IndeterminateOffset>
Attempt to obtain the system’s UTC offset at a known moment in time. If the offset cannot be determined, an error is returned.
let unix_epoch = OffsetDateTime::unix_epoch();
let local_offset = UtcOffset::try_local_offset_at(unix_epoch);
assert!(local_offset.is_ok());
pub fn current_local_offset() -> UtcOffset
👎 Deprecated since 0.2.23: UTC is returned if the local offset cannot be determined
pub fn current_local_offset() -> UtcOffset
UTC is returned if the local offset cannot be determined
Obtain the system’s current UTC offset. If the offset cannot be determined, UTC is returned.
let local_offset = UtcOffset::current_local_offset();
println!("{}", local_offset.format("%z"));
pub fn try_current_local_offset() -> Result<UtcOffset, IndeterminateOffset>
pub fn try_current_local_offset() -> Result<UtcOffset, IndeterminateOffset>
Attempt to obtain the system’s current UTC offset. If the offset cannot be determined, an error is returned.
let local_offset = UtcOffset::try_current_local_offset();
assert!(local_offset.is_ok());
impl UtcOffset
impl UtcOffset
Methods that allow parsing and formatting the UtcOffset
.
Format the UtcOffset
using the provided string.
assert_eq!(UtcOffset::hours(2).format("%z"), "+0200");
assert_eq!(UtcOffset::hours(-2).format("%z"), "-0200");
pub fn lazy_format(self, format: impl AsRef<str>) -> impl Display
pub fn lazy_format(self, format: impl AsRef<str>) -> impl Display
Format the UtcOffset
using the provided string.
assert_eq!(UtcOffset::hours(2).lazy_format("%z").to_string(), "+0200");
assert_eq!(UtcOffset::hours(-2).lazy_format("%z").to_string(), "-0200");
Trait Implementations
impl PartialOrd<UtcOffset> for UtcOffset
impl PartialOrd<UtcOffset> for UtcOffset
pub fn partial_cmp(&self, other: &UtcOffset) -> Option<Ordering>
pub fn partial_cmp(&self, other: &UtcOffset) -> Option<Ordering>
This method returns an ordering between self
and other
values if one exists. Read more
This method tests less than (for self
and other
) and is used by the <
operator. Read more
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
This method tests greater than (for self
and other
) and is used by the >
operator. Read more
impl StructuralEq for UtcOffset
impl StructuralPartialEq for UtcOffset
Auto Trait Implementations
impl RefUnwindSafe for UtcOffset
impl UnwindSafe for UtcOffset
Blanket Implementations
Mutably borrows from an owned value. Read more
Compare self to key
and return true
if they are equal.