jeans/developers.home-assistant
jeans/developers.home-assistant
1
0
Fork 0
mirror of https://github.com/home-assistant/developers.home-assistant.git synced 2025-04-19 10:57:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

Energy by distance units (#2553)

Browse Source 
* Energy by distance units

* Fix speling eror

* Update blog/2025-01-31-energy-distance-units.md

Co-authored-by: Abílio Costa <abmantis@users.noreply.github.com>

---------

Co-authored-by: Abílio Costa <abmantis@users.noreply.github.com>
This commit is contained in:
Jakob Schlyter 2025-02-03 00:28:11 +01:00 committed by GitHub
parent 7c8914fc8c
commit d80e4a1af9
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 23 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
blog/2025-01-31-energy-distance-units.md Normal file
View File

@ -0,0 +1,23 @@
---
author: jschlyter
authorURL: https://github.com/jschlyter
title: "Energy by distance units"
---
### Summary of changes
A new `ENERGY_DISTANCE` device class for representing energy per distance is now available for number and sensor entities, together with automatic unit conversion based on the unit system.
This new device class can be used, for example, on entities that show the amount of electric energy consumed by an electric car. A corresponding `UnitOfEnergyDistance` unit enumerator, and `EnergyDistanceConverter` converter class have been added to support the new device class.
The following units are available:
- kWh/100km
- mi/kWh
- km/kWh
More details can be found in the [Number documentation](/docs/core/entity/number#available-device-classes) and [Sensor documentation](/docs/core/entity/sensor#available-device-classes)
### Inverse Units
Implementing `EnergyDistanceConverter` has also resulted in support for inverse units in `BaseUnitConverter`. This simplifies adding new units that are inverses of one another, e.g., kWh/100km and km/kWh.