Enum BucketWidth 

pub enum BucketWidth {
    Fixed(i64),
    Days(u32),
    Months(u32),
}

How wide a bucket is, and therefore whether it varies.

Variants

Fixed(i64)

A fixed span of nanoseconds. Never varies.

Days(u32)

A whole number of calendar days. Varies across a daylight-saving transition when the bucket is zoned.

Months(u32)

A whole number of calendar months. 3 is a quarter, 12 a year.

Implementations

impl BucketWidth

pub fn nominal_ns(self) -> i64

Roughly how long this bucket is, for a caller that needs one number.

An estimate for calendar widths, and only ever used where an estimate is correct — sizing a scan, ordering two tiers by coarseness. A month is 30.44 days here and never that in reality, so anything that must be right uses TimeBucket::next.

pub fn is_calendar(self) -> bool

Whether this width follows a calendar rather than a fixed span.

Trait Implementations

impl Clone for BucketWidth

fn clone(&self) -> BucketWidth

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for BucketWidth

impl Debug for BucketWidth

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BucketWidth

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for BucketWidth

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

The canonical spelling, which parses back to the same width.

Round-tripping matters: a rollup reports the width it was created with, and an operator has to be able to type that back in.

impl Eq for BucketWidth

impl FromStr for BucketWidth

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

Parse 15m, 1h, 1d, 1w, 1mo, 1y.

mo is the month, never M: a case-sensitive distinction between minute and month is the kind that is wrong once and then wrong for three years of stored data. InfluxDB spells it mo for the same reason.

type Err = BucketParseError

The associated error which can be returned from parsing.

impl Hash for BucketWidth

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 BucketWidth

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for BucketWidth

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for BucketWidth