Add TEMPERATURE_DELTA device class to Number and Sensor entities (home-assistant#147358)

krahabb · web-flow · commit afeaf2409fd2 · 2025-10-15T11:49:12.000+02:00
diff --git a/homeassistant/components/number/const.py b/homeassistant/components/number/const.py
@@ -50,6 +50,7 @@
     BaseUnitConverter,
     ReactiveEnergyConverter,
     TemperatureConverter,
+    TemperatureDeltaConverter,
     VolumeFlowRateConverter,
 )
 
@@ -381,6 +382,12 @@ class NumberDeviceClass(StrEnum):
     Unit of measurement: `°C`, `°F`, `K`
     """
 
+    TEMPERATURE_DELTA = "temperature_delta"
+    """Difference of temperatures - Temperature range.
+
+    Unit of measurement: `°C`, `°F`, `K`
+    """
+
     VOLATILE_ORGANIC_COMPOUNDS = "volatile_organic_compounds"
     """Amount of VOC.
 
@@ -540,6 +547,7 @@ class NumberDeviceClass(StrEnum):
     NumberDeviceClass.SPEED: {*UnitOfSpeed, *UnitOfVolumetricFlux},
     NumberDeviceClass.SULPHUR_DIOXIDE: {CONCENTRATION_MICROGRAMS_PER_CUBIC_METER},
     NumberDeviceClass.TEMPERATURE: set(UnitOfTemperature),
+    NumberDeviceClass.TEMPERATURE_DELTA: set(UnitOfTemperature),
     NumberDeviceClass.VOLATILE_ORGANIC_COMPOUNDS: {
         CONCENTRATION_MICROGRAMS_PER_CUBIC_METER,
         CONCENTRATION_MILLIGRAMS_PER_CUBIC_METER,
@@ -568,6 +576,7 @@ class NumberDeviceClass(StrEnum):
 UNIT_CONVERTERS: dict[NumberDeviceClass, type[BaseUnitConverter]] = {
     NumberDeviceClass.REACTIVE_ENERGY: ReactiveEnergyConverter,
     NumberDeviceClass.TEMPERATURE: TemperatureConverter,
+    NumberDeviceClass.TEMPERATURE_DELTA: TemperatureDeltaConverter,
     NumberDeviceClass.VOLUME_FLOW_RATE: VolumeFlowRateConverter,
 }
 
diff --git a/homeassistant/components/number/icons.json b/homeassistant/components/number/icons.json
@@ -135,6 +135,9 @@
     "temperature": {
       "default": "mdi:thermometer"
     },
+    "temperature_delta": {
+      "default": "mdi:thermometer"
+    },
     "volatile_organic_compounds": {
       "default": "mdi:molecule"
     },
diff --git a/homeassistant/components/number/significant_change.py b/homeassistant/components/number/significant_change.py
@@ -47,7 +47,10 @@ def async_check_significant_change(
     percentage_change: float | None = None
 
     # special for temperature
-    if device_class == NumberDeviceClass.TEMPERATURE:
+    if device_class in (
+        NumberDeviceClass.TEMPERATURE,
+        NumberDeviceClass.TEMPERATURE_DELTA,
+    ):
         if new_attrs.get(ATTR_UNIT_OF_MEASUREMENT) == UnitOfTemperature.FAHRENHEIT:
             absolute_change = 1.0
         else:
diff --git a/homeassistant/components/number/strings.json b/homeassistant/components/number/strings.json
@@ -157,6 +157,9 @@
     "temperature": {
       "name": "[%key:component::sensor::entity_component::temperature::name%]"
     },
+    "temperature_delta": {
+      "name": "[%key:component::sensor::entity_component::temperature_delta::name%]"
+    },
     "volatile_organic_compounds": {
       "name": "[%key:component::sensor::entity_component::volatile_organic_compounds::name%]"
     },
diff --git a/homeassistant/components/recorder/statistics.py b/homeassistant/components/recorder/statistics.py
@@ -65,6 +65,7 @@
     ReactivePowerConverter,
     SpeedConverter,
     TemperatureConverter,
+    TemperatureDeltaConverter,
     UnitlessRatioConverter,
     VolumeConverter,
     VolumeFlowRateConverter,
@@ -223,6 +224,7 @@ def query_circular_mean(table: type[StatisticsBase]) -> tuple[Label, Label]:
 
 _SECONDARY_UNIT_CONVERTERS: list[type[BaseUnitConverter]] = [
     CarbonMonoxideConcentrationConverter,
+    TemperatureDeltaConverter,
 ]
 
 STATISTIC_UNIT_TO_UNIT_CONVERTER: dict[str | None, type[BaseUnitConverter]] = {
diff --git a/homeassistant/components/recorder/websocket_api.py b/homeassistant/components/recorder/websocket_api.py
@@ -39,6 +39,7 @@
     ReactivePowerConverter,
     SpeedConverter,
     TemperatureConverter,
+    TemperatureDeltaConverter,
     UnitlessRatioConverter,
     VolumeConverter,
     VolumeFlowRateConverter,
@@ -94,6 +95,9 @@
         vol.Optional("reactive_power"): vol.In(ReactivePowerConverter.VALID_UNITS),
         vol.Optional("speed"): vol.In(SpeedConverter.VALID_UNITS),
         vol.Optional("temperature"): vol.In(TemperatureConverter.VALID_UNITS),
+        vol.Optional("temperature_delta"): vol.In(
+            TemperatureDeltaConverter.VALID_UNITS
+        ),
         vol.Optional("unitless"): vol.In(UnitlessRatioConverter.VALID_UNITS),
         vol.Optional("volume"): vol.In(VolumeConverter.VALID_UNITS),
         vol.Optional("volume_flow_rate"): vol.In(VolumeFlowRateConverter.VALID_UNITS),
diff --git a/homeassistant/components/sensor/const.py b/homeassistant/components/sensor/const.py
@@ -69,6 +69,7 @@
     ReactivePowerConverter,
     SpeedConverter,
     TemperatureConverter,
+    TemperatureDeltaConverter,
     UnitlessRatioConverter,
     VolumeConverter,
     VolumeFlowRateConverter,
@@ -417,6 +418,12 @@ class SensorDeviceClass(StrEnum):
     Unit of measurement: `°C`, `°F`, `K`
     """
 
+    TEMPERATURE_DELTA = "temperature_delta"
+    """Difference of temperatures - Temperature range.
+
+    Unit of measurement: `°C`, `°F`, `K`
+    """
+
     VOLATILE_ORGANIC_COMPOUNDS = "volatile_organic_compounds"
     """Amount of VOC.
 
@@ -564,6 +571,7 @@ class SensorStateClass(StrEnum):
     SensorDeviceClass.REACTIVE_POWER: ReactivePowerConverter,
     SensorDeviceClass.SPEED: SpeedConverter,
     SensorDeviceClass.TEMPERATURE: TemperatureConverter,
+    SensorDeviceClass.TEMPERATURE_DELTA: TemperatureDeltaConverter,
     SensorDeviceClass.VOLATILE_ORGANIC_COMPOUNDS: MassVolumeConcentrationConverter,
     SensorDeviceClass.VOLATILE_ORGANIC_COMPOUNDS_PARTS: UnitlessRatioConverter,
     SensorDeviceClass.VOLTAGE: ElectricPotentialConverter,
@@ -651,6 +659,7 @@ class SensorStateClass(StrEnum):
     SensorDeviceClass.SPEED: {*UnitOfSpeed, *UnitOfVolumetricFlux},
     SensorDeviceClass.SULPHUR_DIOXIDE: {CONCENTRATION_MICROGRAMS_PER_CUBIC_METER},
     SensorDeviceClass.TEMPERATURE: set(UnitOfTemperature),
+    SensorDeviceClass.TEMPERATURE_DELTA: set(UnitOfTemperature),
     SensorDeviceClass.VOLATILE_ORGANIC_COMPOUNDS: {
         CONCENTRATION_MICROGRAMS_PER_CUBIC_METER,
         CONCENTRATION_MILLIGRAMS_PER_CUBIC_METER,
@@ -715,6 +724,7 @@ class SensorStateClass(StrEnum):
     SensorDeviceClass.SOUND_PRESSURE: (UnitOfSoundPressure.DECIBEL, 0),
     SensorDeviceClass.SPEED: (UnitOfSpeed.MILLIMETERS_PER_SECOND, 0),
     SensorDeviceClass.TEMPERATURE: (UnitOfTemperature.KELVIN, 1),
+    SensorDeviceClass.TEMPERATURE_DELTA: (UnitOfTemperature.KELVIN, 1),
     SensorDeviceClass.VOLTAGE: (UnitOfElectricPotential.VOLT, 0),
     SensorDeviceClass.VOLUME: (UnitOfVolume.MILLILITERS, 0),
     SensorDeviceClass.VOLUME_FLOW_RATE: (UnitOfVolumeFlowRate.LITERS_PER_SECOND, 0),
@@ -779,6 +789,7 @@ class SensorStateClass(StrEnum):
     SensorDeviceClass.SPEED: {SensorStateClass.MEASUREMENT},
     SensorDeviceClass.SULPHUR_DIOXIDE: {SensorStateClass.MEASUREMENT},
     SensorDeviceClass.TEMPERATURE: {SensorStateClass.MEASUREMENT},
+    SensorDeviceClass.TEMPERATURE_DELTA: {SensorStateClass.MEASUREMENT},
     SensorDeviceClass.TIMESTAMP: set(),
     SensorDeviceClass.VOLATILE_ORGANIC_COMPOUNDS: {SensorStateClass.MEASUREMENT},
     SensorDeviceClass.VOLATILE_ORGANIC_COMPOUNDS_PARTS: {SensorStateClass.MEASUREMENT},
diff --git a/homeassistant/components/sensor/device_condition.py b/homeassistant/components/sensor/device_condition.py
@@ -78,6 +78,7 @@
 CONF_IS_SOUND_PRESSURE = "is_sound_pressure"
 CONF_IS_SULPHUR_DIOXIDE = "is_sulphur_dioxide"
 CONF_IS_TEMPERATURE = "is_temperature"
+CONF_IS_TEMPERATURE_DELTA = "is_temperature_delta"
 CONF_IS_VALUE = "is_value"
 CONF_IS_VOLATILE_ORGANIC_COMPOUNDS = "is_volatile_organic_compounds"
 CONF_IS_VOLATILE_ORGANIC_COMPOUNDS_PARTS = "is_volatile_organic_compounds_parts"
@@ -140,6 +141,7 @@
     SensorDeviceClass.SPEED: [{CONF_TYPE: CONF_IS_SPEED}],
     SensorDeviceClass.SULPHUR_DIOXIDE: [{CONF_TYPE: CONF_IS_SULPHUR_DIOXIDE}],
     SensorDeviceClass.TEMPERATURE: [{CONF_TYPE: CONF_IS_TEMPERATURE}],
+    SensorDeviceClass.TEMPERATURE_DELTA: [{CONF_TYPE: CONF_IS_TEMPERATURE_DELTA}],
     SensorDeviceClass.VOLATILE_ORGANIC_COMPOUNDS: [
         {CONF_TYPE: CONF_IS_VOLATILE_ORGANIC_COMPOUNDS}
     ],
@@ -208,6 +210,7 @@
                     CONF_IS_SPEED,
                     CONF_IS_SULPHUR_DIOXIDE,
                     CONF_IS_TEMPERATURE,
+                    CONF_IS_TEMPERATURE_DELTA,
                     CONF_IS_VOLATILE_ORGANIC_COMPOUNDS,
                     CONF_IS_VOLATILE_ORGANIC_COMPOUNDS_PARTS,
                     CONF_IS_VOLTAGE,
diff --git a/homeassistant/components/sensor/device_trigger.py b/homeassistant/components/sensor/device_trigger.py
@@ -77,6 +77,7 @@
 CONF_SPEED = "speed"
 CONF_SULPHUR_DIOXIDE = "sulphur_dioxide"
 CONF_TEMPERATURE = "temperature"
+CONF_TEMPERATURE_DELTA = "temperature_delta"
 CONF_VALUE = "value"
 CONF_VOLATILE_ORGANIC_COMPOUNDS = "volatile_organic_compounds"
 CONF_VOLATILE_ORGANIC_COMPOUNDS_PARTS = "volatile_organic_compounds_parts"
@@ -139,6 +140,7 @@
     SensorDeviceClass.SPEED: [{CONF_TYPE: CONF_SPEED}],
     SensorDeviceClass.SULPHUR_DIOXIDE: [{CONF_TYPE: CONF_SULPHUR_DIOXIDE}],
     SensorDeviceClass.TEMPERATURE: [{CONF_TYPE: CONF_TEMPERATURE}],
+    SensorDeviceClass.TEMPERATURE_DELTA: [{CONF_TYPE: CONF_TEMPERATURE_DELTA}],
     SensorDeviceClass.VOLATILE_ORGANIC_COMPOUNDS: [
         {CONF_TYPE: CONF_VOLATILE_ORGANIC_COMPOUNDS}
     ],
@@ -208,6 +210,7 @@
                     CONF_SPEED,
                     CONF_SULPHUR_DIOXIDE,
                     CONF_TEMPERATURE,
+                    CONF_TEMPERATURE_DELTA,
                     CONF_VOLATILE_ORGANIC_COMPOUNDS,
                     CONF_VOLATILE_ORGANIC_COMPOUNDS_PARTS,
                     CONF_VOLTAGE,
diff --git a/homeassistant/components/sensor/icons.json b/homeassistant/components/sensor/icons.json
@@ -154,6 +154,9 @@
     "temperature": {
       "default": "mdi:thermometer"
     },
+    "temperature_delta": {
+      "default": "mdi:thermometer"
+    },
     "timestamp": {
       "default": "mdi:clock"
     },
diff --git a/homeassistant/components/sensor/significant_change.py b/homeassistant/components/sensor/significant_change.py
@@ -45,16 +45,19 @@ def async_check_significant_change(
 
     absolute_change: float | None = None
     percentage_change: float | None = None
-    if device_class == SensorDeviceClass.TEMPERATURE:
+    if device_class in (
+        SensorDeviceClass.TEMPERATURE,
+        SensorDeviceClass.TEMPERATURE_DELTA,
+    ):
         if new_attrs.get(ATTR_UNIT_OF_MEASUREMENT) == UnitOfTemperature.FAHRENHEIT:
             absolute_change = 1.0
         else:
             absolute_change = 0.5
 
-    if device_class in (SensorDeviceClass.BATTERY, SensorDeviceClass.HUMIDITY):
+    elif device_class in (SensorDeviceClass.BATTERY, SensorDeviceClass.HUMIDITY):
         absolute_change = 1.0
 
-    if device_class in (
+    elif device_class in (
         SensorDeviceClass.AQI,
         SensorDeviceClass.CO,
         SensorDeviceClass.CO2,
diff --git a/homeassistant/components/sensor/strings.json b/homeassistant/components/sensor/strings.json
@@ -47,6 +47,7 @@
       "is_speed": "Current {entity_name} speed",
       "is_sulphur_dioxide": "Current {entity_name} sulphur dioxide concentration level",
       "is_temperature": "Current {entity_name} temperature",
+      "is_temperature_delta": "Current {entity_name} temperature interval",
       "is_value": "Current {entity_name} value",
       "is_volatile_organic_compounds": "Current {entity_name} volatile organic compounds concentration level",
       "is_volatile_organic_compounds_parts": "[%key:component::sensor::device_automation::condition_type::is_volatile_organic_compounds%]",
@@ -104,6 +105,7 @@
       "speed": "{entity_name} speed changes",
       "sulphur_dioxide": "{entity_name} sulphur dioxide concentration changes",
       "temperature": "{entity_name} temperature changes",
+      "temperature_delta": "{entity_name} temperature interval changes",
       "value": "{entity_name} value changes",
       "volatile_organic_compounds": "{entity_name} volatile organic compounds concentration changes",
       "volatile_organic_compounds_parts": "[%key:component::sensor::device_automation::trigger_type::volatile_organic_compounds%]",
@@ -290,6 +292,9 @@
     "temperature": {
       "name": "Temperature"
     },
+    "temperature_delta": {
+      "name": "Temperature delta"
+    },
     "timestamp": {
       "name": "Timestamp"
     },
diff --git a/homeassistant/util/unit_conversion.py b/homeassistant/util/unit_conversion.py
@@ -750,6 +750,25 @@ def _celsius_to_kelvin(cls, celsius: float) -> float:
         return celsius + 273.15
 
 
+class TemperatureDeltaConverter(BaseUnitConverter):
+    """Utility to convert temperature intervals.
+
+    eg. a 10°C interval (10°C to 20°C) will return a 18°F (50°F to 68°F) interval
+    """
+
+    UNIT_CLASS = "temperature_delta"
+    VALID_UNITS = {
+        UnitOfTemperature.CELSIUS,
+        UnitOfTemperature.FAHRENHEIT,
+        UnitOfTemperature.KELVIN,
+    }
+    _UNIT_CONVERSION = {
+        UnitOfTemperature.CELSIUS: 1.0,
+        UnitOfTemperature.FAHRENHEIT: 1.8,
+        UnitOfTemperature.KELVIN: 1.0,
+    }
+
+
 class UnitlessRatioConverter(BaseUnitConverter):
     """Utility to convert unitless ratios."""
 
diff --git a/tests/components/number/test_significant_change.py b/tests/components/number/test_significant_change.py
@@ -37,6 +37,14 @@
     ATTR_DEVICE_CLASS: NumberDeviceClass.TEMPERATURE,
     ATTR_UNIT_OF_MEASUREMENT: UnitOfTemperature.FAHRENHEIT,
 }
+TEMP_DELTA_CELSIUS_ATTRS = {
+    ATTR_DEVICE_CLASS: NumberDeviceClass.TEMPERATURE_DELTA,
+    ATTR_UNIT_OF_MEASUREMENT: UnitOfTemperature.CELSIUS,
+}
+TEMP_DELTA_FAHRENHEIT_ATTRS = {
+    ATTR_DEVICE_CLASS: NumberDeviceClass.TEMPERATURE_DELTA,
+    ATTR_UNIT_OF_MEASUREMENT: UnitOfTemperature.FAHRENHEIT,
+}
 VOLATILE_ORGANIC_COMPOUNDS_ATTRS = {
     ATTR_DEVICE_CLASS: NumberDeviceClass.VOLATILE_ORGANIC_COMPOUNDS
 }
@@ -81,6 +89,13 @@
         ("70", "70.5", TEMP_FREEDOM_ATTRS, False),
         ("fail", "70", TEMP_FREEDOM_ATTRS, True),
         ("70", "fail", TEMP_FREEDOM_ATTRS, False),
+        ("1", "1", TEMP_DELTA_CELSIUS_ATTRS, False),
+        ("12", "13", TEMP_DELTA_CELSIUS_ATTRS, True),
+        ("12.1", "12.2", TEMP_DELTA_CELSIUS_ATTRS, False),
+        ("10", "11", TEMP_DELTA_FAHRENHEIT_ATTRS, True),
+        ("10", "10.5", TEMP_DELTA_FAHRENHEIT_ATTRS, False),
+        ("fail", "0", TEMP_DELTA_FAHRENHEIT_ATTRS, True),
+        ("10", "fail", TEMP_DELTA_FAHRENHEIT_ATTRS, False),
         ("0", "1", VOLATILE_ORGANIC_COMPOUNDS_ATTRS, True),
         ("0.1", "0.5", VOLATILE_ORGANIC_COMPOUNDS_ATTRS, False),
     ],
diff --git a/tests/components/number/test_websocket_api.py b/tests/components/number/test_websocket_api.py
@@ -26,6 +26,17 @@ async def test_device_class_units(
     assert msg["success"]
     assert msg["result"] == {"units": ["K", "°C", "°F"]}
 
+    # Check also TEMPERATURE_DELTA
+    await client.send_json_auto_id(
+        {
+            "type": "number/device_class_convertible_units",
+            "device_class": "temperature_delta",
+        }
+    )
+    msg = await client.receive_json()
+    assert msg["success"]
+    assert msg["result"] == {"units": ["K", "°C", "°F"]}
+
     # Device class with units which number doesn't allow customizing & converting
     await client.send_json_auto_id(
         {
diff --git a/tests/components/sensor/common.py b/tests/components/sensor/common.py
@@ -93,6 +93,7 @@
     SensorDeviceClass.SPEED: UnitOfSpeed.METERS_PER_SECOND,
     SensorDeviceClass.SULPHUR_DIOXIDE: CONCENTRATION_MICROGRAMS_PER_CUBIC_METER,
     SensorDeviceClass.TEMPERATURE: UnitOfTemperature.CELSIUS,
+    SensorDeviceClass.TEMPERATURE_DELTA: UnitOfTemperature.CELSIUS,
     SensorDeviceClass.TIMESTAMP: None,
     SensorDeviceClass.VOLATILE_ORGANIC_COMPOUNDS: CONCENTRATION_MICROGRAMS_PER_CUBIC_METER,
     SensorDeviceClass.VOLATILE_ORGANIC_COMPOUNDS_PARTS: CONCENTRATION_PARTS_PER_MILLION,
diff --git a/tests/components/sensor/test_device_condition.py b/tests/components/sensor/test_device_condition.py
@@ -125,7 +125,7 @@ async def test_get_conditions(
     conditions = await async_get_device_automations(
         hass, DeviceAutomationType.CONDITION, device_entry.id
     )
-    assert len(conditions) == 56
+    assert len(conditions) == 57
     assert conditions == unordered(expected_conditions)
 
 
diff --git a/tests/components/sensor/test_device_trigger.py b/tests/components/sensor/test_device_trigger.py
@@ -126,7 +126,7 @@ async def test_get_triggers(
     triggers = await async_get_device_automations(
         hass, DeviceAutomationType.TRIGGER, device_entry.id
     )
-    assert len(triggers) == 56
+    assert len(triggers) == 57
     assert triggers == unordered(expected_triggers)
 
 
diff --git a/tests/components/sensor/test_init.py b/tests/components/sensor/test_init.py
diff --git a/tests/components/sensor/test_recorder.py b/tests/components/sensor/test_recorder.py
diff --git a/tests/components/sensor/test_significant_change.py b/tests/components/sensor/test_significant_change.py
diff --git a/tests/util/test_unit_conversion.py b/tests/util/test_unit_conversion.py
