Enum Resolution 

pub enum Resolution {
    Minutes(MinuteStep),
    Hour,
    Day,
    Month,
    Year,
}

The length of one interval of a metered series.

The string form is an ISO 8601 duration (PT15M, PT1H, P1D, P1M, P1Y), written by Display, read by FromStr and used on the serde wire.

Variants

Minutes(MinuteStep)

A fixed step of whole minutes dividing the hour.

Hour

One hour (3 600 s) — the gas settlement slot.

Day

One Berlin calendar day (or Gastag) — 23 h, 24 h or 25 h.

Month

One Berlin calendar month.

Year

One Berlin calendar year.

Implementations

impl Resolution

pub const QUARTER_HOUR: Self

15 minutes — the German electricity settlement slot (RLM, iMSys).

pub const HALF_HOUR: Self

30 minutes.

pub const fn minutes(minutes: u8) -> Option<Self>

A minute resolution; Some(Hour) for 60, None unless minutes divides 60.

pub const fn fixed_seconds(self) -> Option<u32>

The interval length in seconds, when it is the same on every date; None for Day, Month and Year, whose lengths depend on the calendar and on DST.

pub const fn nominal_seconds(self) -> u32

A nominal length in seconds, for ordering and sizing only — Day is 24 h, Month 30 days, Year 365 days. Not for counts or billing.

pub const fn is_fixed(self) -> bool

true for the fixed-length group: Minutes and Hour.

pub const fn is_calendar(self) -> bool

true for the calendar group: Day, Month, Year.

pub const fn is_subhourly(self) -> bool

true for every step shorter than an hour.

pub const fn label(self) -> &'static str

Human-readable German label.

pub const fn from_seconds(secs: u32) -> Option<Self>

The fixed resolution of exactly secs seconds, if one exists; never Day, Month or Year.

pub fn from_observed_seconds(secs: i64) -> Option<Self>

The resolution an observed spacing of secs seconds indicates.

A fixed step matches within ±5 %; a day matches 23–25 h, a month 28 days − 1 h to 31 days + 1 h, a year 365 days − 1 h to 366 days + 1 h.

use metering::Resolution;

assert_eq!(Resolution::from_observed_seconds(898), Some(Resolution::QUARTER_HOUR));
assert_eq!(Resolution::from_observed_seconds(90_000), Some(Resolution::Day));
// March: 31 days minus the spring-forward hour.
assert_eq!(Resolution::from_observed_seconds(31 * 86_400 - 3_600), Some(Resolution::Month));
assert_eq!(Resolution::from_observed_seconds(366 * 86_400), Some(Resolution::Year));
assert_eq!(Resolution::from_observed_seconds(7_200), None);
assert_eq!(Resolution::from_observed_seconds(0), None);

Trait Implementations

impl Clone for Resolution

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Resolution

impl Debug for Resolution

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Resolution

Available on crate feature serde only.

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

Deserialize this value from the given Serde deserializer.

impl Display for Resolution

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

Writes the ISO 8601 duration form, which FromStr reads back.

impl Eq for Resolution

impl FromStr for Resolution

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

Parses PT{n}S, PT{n}M, PT{n}H, P1D, P1M and P1Y, case-insensitively and trimmed; fixed forms are normalised (PT900S and PT60M read as PT15M/PT1H).

Errors

Charset for a malformed string, Range for a well-formed duration outside the set.

type Err = ParseError

The associated error which can be returned from parsing.

impl Hash for Resolution

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 Resolution

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Resolution

Available on crate feature serde only.

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

Writes the Display string.

impl StructuralPartialEq for Resolution