Struct HgTime

pub struct HgTime {
    pub unixtime: i64,
    pub offset: i32,
}

A simple time structure that matches hg’s time representation.

Internally it’s unixtime (in GMT), and offset (GMT -1 = +3600).

Fields

unixtime: i64

offset: i32

Implementations

impl HgTime

pub const RANGE: RangeInclusive<HgTime>

Supported Range. This is to be compatible with Python stdlib.

The Python datetime library can only express a limited range of dates (0001-01-01 to 9999-12-31). Its strftime requires year >= 1900.

pub fn now() -> Option<Self>

Return the current time with local timezone, or None if the timestamp is outside HgTime::RANGE.

The local timezone can be affected by set_default_offset.

pub fn to_utc(self) -> DateTime<Utc>

pub fn set_as_now_for_testing(self)

Set as the faked “now”. Useful for testing.

This should only be used for testing.

pub fn clear_now_for_testing()

Remove faked “now”. Reverts “set_as_now_for_testing” effect.

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

Parse a date string.

Return None if it cannot be parsed.

This function matches mercurial.util.parsedate, and can parse some additional forms like 2 days ago.

pub fn parse_range(date: &str) -> Option<Range<Self>>

Parse a date string as a range.

For example, Apr 2000 covers range Apr 1, 2000 to Apr 30, 2000. Also support more explicit ranges:

• START to END

• START

• < END

pub fn parse_hg_internal_format(date: &str) -> Option<Option<Self>>

Parse a date from a Sapling-internal format. Tolerates floating point timestamps for compatibility reasons.

Return None if cannot be parsed, Option<None> if the parsed date is invalid

pub const fn min_value() -> Self

See HgTime::RANGE for details.

pub const fn max_value() -> Self

See HgTime::RANGE for details.

pub fn bounded(self) -> Option<Self>

Return None if timestamp is out of HgTime::RANGE.

Trait Implementations

impl Add<u64> for HgTime

type Output = Option<HgTime>

The resulting type after applying the + operator.

fn add(self, seconds: u64) -> Option<Self>

Performs the + operation.

impl Clone for HgTime

fn clone(&self) -> HgTime

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HgTime

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

Formats the value using the given formatter.

impl Default for HgTime

fn default() -> HgTime

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HgTime

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl From<HgTime> for DateTime<Utc>

fn from(time: HgTime) -> Self

Converts to this type from the input type.

impl From<HgTime> for NaiveDateTime

fn from(time: HgTime) -> Self

Converts to this type from the input type.

impl PartialEq for HgTime

fn eq(&self, other: &HgTime) -> 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 HgTime

fn partial_cmp(&self, other: &HgTime) -> 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 HgTime

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Sub<u64> for HgTime

type Output = Option<HgTime>

The resulting type after applying the - operator.

fn sub(self, seconds: u64) -> Option<Self>

Performs the - operation.

impl<Tz: TimeZone> TryFrom<DateTime<Tz>> for HgTime

type Error = ()

The type returned in the event of a conversion error.

fn try_from(time: DateTime<Tz>) -> Result<Self, ()>

Performs the conversion.

impl<Tz: TimeZone> TryFrom<LocalResult<DateTime<Tz>>> for HgTime

type Error = ()

The type returned in the event of a conversion error.

fn try_from(time: LocalResult<DateTime<Tz>>) -> Result<Self, ()>

Performs the conversion.

impl TryFrom<NaiveDateTime> for HgTime

type Error = ()

The type returned in the event of a conversion error.

fn try_from(time: NaiveDateTime) -> Result<Self, ()>

Performs the conversion.

impl Copy for HgTime

impl StructuralPartialEq for HgTime