Skip to content

Add template weather forecast documentation #42524

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
c0ffeeca7 merged 3 commits into from
Dec 12, 2025
Merged

Add template weather forecast documentation #42524

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
cef2139
Add template migration examples
Petro31 Dec 4, 2025
4dbfa09
Merge remote-tracking branch 'upstream' into current
Petro31 Dec 11, 2025
8bf458f
Add details about weather forecast
Petro31 Dec 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions source/_integrations/template.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2552,6 +2552,22 @@ weather:

{% endconfiguration %}

### Weather Forecast data
Copy link

Copilot AI Dec 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The heading uses title-style capitalization ("Weather Forecast data") but should use sentence-style capitalization according to the documentation standards. It should be "Weather forecast data".

Suggested change
### Weather Forecast data
### Weather forecast data

Copilot uses AI. Check for mistakes.

The weather forecast options should return a list of dictionaries, where each dictionary contains [forecast information](https://www.home-assistant.io/integrations/weather/#action-weatherget_forecasts) for the current timeframe. The data is slightly different for each forecast type: `hourly`, `daily`, and `twice_daily`.
Comment thread
c0ffeeca7 marked this conversation as resolved.

#### Hourly Weather Forecast
Copy link

Copilot AI Dec 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The heading uses title-style capitalization ("Hourly Weather Forecast") but should use sentence-style capitalization according to the documentation standards. It should be "Hourly weather forecast".

Suggested change
#### Hourly Weather Forecast
#### Hourly weather forecast

Copilot uses AI. Check for mistakes.

The `hourly` forecast should contain 24 dictionaries, where each dictionary represents a specific hour within the next 24 hour period. The `hourly` data should start at the current hour and end 24 hours from that point. The `datetime` in each dictionary should represent the start of the hour in your local timezone.
Copy link

Copilot AI Dec 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The phrase "24 hour period" should be hyphenated when used as a compound adjective. It should be "24-hour period".

Suggested change
The `hourly` forecast should contain 24 dictionaries, where each dictionary represents a specific hour within the next 24 hour period. The `hourly` data should start at the current hour and end 24 hours from that point. The `datetime` in each dictionary should represent the start of the hour in your local timezone.
The `hourly` forecast should contain 24 dictionaries, where each dictionary represents a specific hour within the next 24-hour period. The `hourly` data should start at the current hour and end 24 hours from that point. The `datetime` in each dictionary should represent the start of the hour in your local timezone.

Copilot uses AI. Check for mistakes.

#### Daily Weather Forecast
Copy link

Copilot AI Dec 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The heading uses title-style capitalization ("Daily Weather Forecast") but should use sentence-style capitalization according to the documentation standards. It should be "Daily weather forecast".

Suggested change
#### Daily Weather Forecast
#### Daily weather forecast

Copilot uses AI. Check for mistakes.

The `daily` forecast should contain dictionaries, where each dictionary represents a specific day within any desired timeframe. The `daily` data should start at midnight tonight and end on the last day of your desired timeframe, incrementing 1 day at a time. The `datetime` in each dictionary should represent midnight for each night in your local timezone.

#### Twice Daily Weather Forecast
Copy link

Copilot AI Dec 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The heading uses title-style capitalization ("Twice Daily Weather Forecast") but should use sentence-style capitalization according to the documentation standards. It should be "Twice daily weather forecast".

Suggested change
#### Twice Daily Weather Forecast
#### Twice daily weather forecast

Copilot uses AI. Check for mistakes.

The `twice_daily` forecast should contain dictionaries, where each dictionary represents a specific 12 hour period within any desired timeframe. The `twice_daily` should start at the closest 12 hour period and end on the last 12 hour period of your desired timeframe. The `datetime` in each dictionary should represent midnight or noon for each day in your local timezone. Keep in mind, `is_daytime` is mandatory in every dictionary output to `twice_daily` forecasts.
Copy link

Copilot AI Dec 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The phrase "12 hour period" should be hyphenated when used as a compound adjective. It should be "12-hour period".

Suggested change
The `twice_daily` forecast should contain dictionaries, where each dictionary represents a specific 12 hour period within any desired timeframe. The `twice_daily` should start at the closest 12 hour period and end on the last 12 hour period of your desired timeframe. The `datetime` in each dictionary should represent midnight or noon for each day in your local timezone. Keep in mind, `is_daytime` is mandatory in every dictionary output to `twice_daily` forecasts.
The `twice_daily` forecast should contain dictionaries, where each dictionary represents a specific 12-hour period within any desired timeframe. The `twice_daily` should start at the closest 12-hour period and end on the last 12-hour period of your desired timeframe. The `datetime` in each dictionary should represent midnight or noon for each day in your local timezone. Keep in mind, `is_daytime` is mandatory in every dictionary output to `twice_daily` forecasts.

Copilot uses AI. Check for mistakes.
Copy link

Copilot AI Dec 12, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are two spaces between sentences in this line. According to the style guide, only one space should be used after periods. The double space appears after "desired timeframe." and before "The datetime".

Suggested change
The `twice_daily` forecast should contain dictionaries, where each dictionary represents a specific 12 hour period within any desired timeframe. The `twice_daily` should start at the closest 12 hour period and end on the last 12 hour period of your desired timeframe. The `datetime` in each dictionary should represent midnight or noon for each day in your local timezone. Keep in mind, `is_daytime` is mandatory in every dictionary output to `twice_daily` forecasts.
The `twice_daily` forecast should contain dictionaries, where each dictionary represents a specific 12 hour period within any desired timeframe. The `twice_daily` should start at the closest 12 hour period and end on the last 12 hour period of your desired timeframe. The `datetime` in each dictionary should represent midnight or noon for each day in your local timezone. Keep in mind, `is_daytime` is mandatory in every dictionary output to `twice_daily` forecasts.

Copilot uses AI. Check for mistakes.

### Trigger based weather - Weather Forecast from response data

This example demonstrates how to use an `action` to call a [action with response data](/docs/scripts/perform-actions/#use-templates-to-handle-response-data)
Expand Down