Struct FuelPrice 

pub struct FuelPrice {
    pub fuel_type: Option<FuelType>,
    pub price: Money,
    pub update_time: Timestamp,
}

Fuel price information for a given type of fuel at a gas station.

Fuel prices provide current pricing information for specific fuel types, helping drivers compare costs across different stations and fuel grades.

Prices include timestamp information to indicate freshness and reliability of the pricing data. This information is updated regularly to reflect current market conditions.

Fields

fuel_type: Option<FuelType>

The type of fuel this price represents.

Specifies the exact fuel grade or type (regular, premium, diesel, etc.) that this pricing information applies to. Different fuel types at the same station will have separate FuelPrice entries.

price: Money

The price of the fuel.

Current price per unit (typically per gallon or liter depending on region) for this specific fuel type. Includes currency information for international compatibility and precise monetary representation.

update_time: Timestamp

The time when this fuel price was last updated.

Timestamp indicating when this price information was last verified or updated. More recent timestamps indicate more reliable pricing data, which is crucial for fuel price comparisons and decision-making.

Implementations

impl FuelPrice

pub fn price(&self) -> &Money

The price of the fuel.

Current price per unit (typically per gallon or liter depending on region) for this specific fuel type. Includes currency information for international compatibility and precise monetary representation.

impl FuelPrice

pub fn fuel_type(&self) -> Option<FuelType>

The type of fuel this price represents.

Specifies the exact fuel grade or type (regular, premium, diesel, etc.) that this pricing information applies to. Different fuel types at the same station will have separate FuelPrice entries.

pub fn update_time(&self) -> Timestamp

The time when this fuel price was last updated.

Timestamp indicating when this price information was last verified or updated. More recent timestamps indicate more reliable pricing data, which is crucial for fuel price comparisons and decision-making.

impl FuelPrice

pub const fn new( fuel_type: Option<FuelType>, price: Money, update_time: Timestamp, ) -> Self

Creates a new FuelPrice with the specified fuel type, price, and update time.

Used to construct fuel price information with all essential components. The update time should reflect when the price was last verified to ensure data freshness and reliability for users.

pub fn with_current_time(fuel_type: Option<FuelType>, price: Money) -> Self

Creates a FuelPrice with current timestamp.

Convenience constructor that automatically sets the update time to now, useful when recording fresh price data from gas station APIs or manual input.

pub fn age(&self) -> Result<Span, Error>

Returns the age of this price information.

Calculates how long ago this price was last updated, useful for determining data freshness and reliability. Older prices may be less accurate due to market fluctuations and should be used with caution.

pub fn is_very_recent(&self) -> Result<bool, Error>

Returns whether this price information is very recent.

Used to identify the most current and reliable price data, typically updated within the last few hours for optimal accuracy.

pub fn is_fresh(&self) -> Result<bool, Error>

Returns whether this price information is considered fresh.

Used to determine if the price data is recent enough to be reliable for user decision-making. Fuel prices can change frequently, so freshness is important for accurate comparisons.

pub fn is_stale(&self) -> Result<bool, Error>

Returns whether this price information is stale.

Used to identify outdated price data that may not reflect current market conditions. Stale prices should be updated or marked as potentially inaccurate in user interfaces.

pub fn update_time_description(&self) -> Result<String, Error>

Gets a user-friendly description of when this price was last updated.

Provides relative time descriptions like “2 hours ago” or “yesterday” that help users understand the freshness of price information.

pub fn freshness_indicator(&self) -> Result<FreshnessIndicator, Error>

Returns a freshness indicator for display purposes.

Provides a simple classification of price data freshness that can be used for color coding, badges, or user interface indicators.

pub fn formatted_price(&self) -> String

Gets the price per unit with currency formatting.

Returns a formatted price string suitable for display in gas station listings, price comparison interfaces, and mobile applications.

pub fn compact_price(&self) -> String

Gets a compact price representation for mobile displays.

Provides space-efficient price formatting suitable for mobile interfaces, map overlays, or anywhere screen real estate is limited.

pub fn is_competitive(&self, average_price: Option<&Money>) -> bool

Returns whether this fuel price represents a competitive rate.

Used to identify notably good prices for highlighting in user interfaces. This is a placeholder implementation that could be enhanced with market data for more accurate competitive analysis.

pub fn fuel_type_name(&self) -> String

Gets a display-friendly fuel type name.

Returns the human-readable name of the fuel type for user interfaces. If the fuel type is unknown, returns a generic description.

pub fn full_description(&self) -> String

Creates a full description combining fuel type and price.

Provides complete information suitable for detailed listings, tooltips, or comprehensive price displays that include both fuel type and cost.

pub fn has_valid_price(&self) -> bool

Returns whether this price has valid monetary information.

Used to validate price data before displaying or using it for comparisons, ensuring the price contains meaningful and properly formatted monetary values.

pub fn compare_price(&self, other: &Self) -> Option<Ordering>

Compares this price with another for the same fuel type.

Provides price comparison functionality for sorting and filtering operations. Only meaningful when comparing prices for the same fuel type and currency.

pub fn fuel_emoji(&self) -> &'static str

Returns an emoji representation for the fuel type.

Provides visual indicators suitable for maps, mobile interfaces, and quick identification of fuel types in user interfaces. Returns generic fuel emoji if type is unknown.

pub fn update_time_in_timezone(&self, tz: &TimeZone) -> Zoned

Gets the update time in a specific timezone.

Converts the update timestamp to a specified timezone for display in local time contexts or international applications.

Trait Implementations

impl Clone for FuelPrice

fn clone(&self) -> FuelPrice

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FuelPrice

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FuelPrice

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for FuelPrice

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 FuelPrice

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for FuelPrice

impl StructuralPartialEq for FuelPrice