mirror of https://github.com/home-assistant/core
38 lines
1.3 KiB
Python
38 lines
1.3 KiB
Python
"""Temperature helpers for Home Assistant."""
|
|
from numbers import Number
|
|
from typing import Optional
|
|
|
|
from homeassistant.const import PRECISION_HALVES, PRECISION_TENTHS
|
|
from homeassistant.core import HomeAssistant
|
|
from homeassistant.util.temperature import convert as convert_temperature
|
|
|
|
|
|
def display_temp(
|
|
hass: HomeAssistant, temperature: Optional[float], unit: str, precision: float
|
|
) -> Optional[float]:
|
|
"""Convert temperature into preferred units/precision for display."""
|
|
temperature_unit = unit
|
|
ha_unit = hass.config.units.temperature_unit
|
|
|
|
if temperature is None:
|
|
return temperature
|
|
|
|
# If the temperature is not a number this can cause issues
|
|
# with Polymer components, so bail early there.
|
|
if not isinstance(temperature, Number):
|
|
raise TypeError(f"Temperature is not a number: {temperature}")
|
|
|
|
if temperature_unit != ha_unit:
|
|
temperature = convert_temperature(temperature, temperature_unit, ha_unit)
|
|
|
|
# Round in the units appropriate
|
|
if precision == PRECISION_HALVES:
|
|
temperature = round(temperature * 2) / 2.0
|
|
elif precision == PRECISION_TENTHS:
|
|
temperature = round(temperature, 1)
|
|
# Integer as a fall back (PRECISION_WHOLE)
|
|
else:
|
|
temperature = round(temperature)
|
|
|
|
return temperature
|