Struct glean_core::metrics::DatetimeMetric

pub struct DatetimeMetric { /* fields omitted */ }

A datetime metric.

Used to record an absolute date and time, such as the time the user first ran the application.

Implementations

impl DatetimeMetric

pub fn new(meta: CommonMetricData, time_unit: TimeUnit) -> Self

Create a new datetime metric.

pub fn set_with_details(
    &self,
    glean: &Glean,
    year: i32,
    month: u32,
    day: u32,
    hour: u32,
    minute: u32,
    second: u32,
    nano: u32,
    offset_seconds: i32
)

Public facing API for setting the metric to a date/time which includes the timezone offset.

Arguments:

• glean - the Glean instance this metric belongs to.
• year - the year to set the metric to.
• month - the month to set the metric to (1-12).
• day - the day to set the metric to (1-based).
• hour - the hour to set the metric to.
• minute - the minute to set the metric to.
• second - the second to set the metric to.
• nano - the nanosecond fraction to the last whole second.
• offset_seconds - the timezone difference, in seconds, for the Eastern Hemisphere. Negative seconds mean Western Hemisphere.

pub fn set(&self, glean: &Glean, value: Option<Datetime>)

Public facing API for setting the metric to a date/time which includes the timezone offset.

Arguments:

• glean - the Glean instance this metric belongs to.
• value - Some date/time value, with offset, to set the metric to. If none, the current local time is used.

pub fn test_get_value_as_string(
    &self,
    glean: &Glean,
    storage_name: &str
) -> Option<String>

Test-only API (exported for FFI purposes).

Get the currently stored value as a String. The precision of this value is truncated to the time_unit precision.

This doesn't clear the stored value.

Trait Implementations

impl Debug for DatetimeMetric

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

Formats the value using the given formatter.

impl MetricType for DatetimeMetric

fn meta(&self) -> &CommonMetricData

Access the stored metadata

fn meta_mut(&mut self) -> &mut CommonMetricData

Access the stored metadata mutable

fn should_record(&self, glean: &Glean) -> bool

Whether this metric should currently be recorded