developers.home-assistant/docs/core/entity/weather.md

2.7 KiB

title sidebar_label
Weather Entity Weather

Derive entity platforms from homeassistant.components.weather.WeatherEntity

Properties

:::tip Properties should always only return information from memory and not do I/O (like network requests). Implement update() or async_update() to fetch data. :::

Name Type Default Description
condition string Required The current weather condition.
temperature float Required The current temperature in °C or °F.
temperature_unit string Required The temperature unit, °C or °F.
pressure float None The current air pressure in hPa or inHg.
humidity float None The current humidity in %.
ozone float None The current ozone level.
visibility float None The current visibility in km or mi.
wind_speed float None The current wind speed in km/h or mi/h.
wind_bearing float or string None The current wind bearing in azimuth angle (degrees) or 1-3 letter cardinal direction.
forecast array None Daily or Hourly forecast data.

Properties have to follow the units defined in the unit_system.

Forecast

Forecast data should either be daily or hourly.

Name Type Default Description
datetime string Required UTC Date time in RFC 3339 format.
temperature float Required The higher temperature in °C or °F
condition string None The weather condition at this point.
templow float None The lower daily Temperature in °C or °F
precipitation float None The precipitation amount in mm or inch.
precipitation_probability int None The probability of precipitation in %.
pressure float None The air pressure in hPa or inHg.
wind_bearing float or string None The wind bearing in azimuth angle (degrees) or 1-3 letter cardinal direction.
wind_speed int None The wind speed in km/h or mi/h.

These weather conditions are included in our translation files and also show the corresponding icon.

Condition Description
clear-night Clear night
cloudy Many clouds
exceptional Exceptional
fog Fog
hail Hail
lightning Lightning/ thunderstorms
lightning-rainy Lightning/ thunderstorms and rain
partlycloudy A few clouds
pouring Pouring rain
rainy Rain
snowy Snow
snowy-rainy Snow and Rain
sunny Sunshine
windy Wind
windy-variant Wind and clouds

This means that the weather platforms don't need to support languages.