From d3ef019217218841e5c034ea10a7aa273c3b3bb5 Mon Sep 17 00:00:00 2001 From: Scott Colby Date: Sun, 24 Sep 2023 10:23:47 -0400 Subject: [PATCH] Document workday integration with no country specified. (#28641) * Update workday binary_sensor documentation for usage with no specified country. The first documentation example was incorrect and its described functionality was impossible until the below PR was implemented. See: - https://github.com/home-assistant/core/issues/85996 - https://github.com/home-assistant/core/pull/87222 * Modify language for the `None` country option to be less colloquial. --------- Co-authored-by: G Johansson --- source/_integrations/workday.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_integrations/workday.markdown b/source/_integrations/workday.markdown index 84113a6be04..7a7785048b5 100644 --- a/source/_integrations/workday.markdown +++ b/source/_integrations/workday.markdown @@ -19,7 +19,7 @@ ha_integration_type: integration The `workday` binary sensor indicates whether the current day is a workday or not. -It allows specifying which days of the week will count as workdays and also uses the Python module [holidays](https://pypi.org/project/holidays/) to incorporate information about region-specific public holidays. +It allows specifying which days of the week will count as workdays and also uses the Python module [holidays](https://pypi.org/project/holidays/) to incorporate information about region-specific public holidays. This can be used to make daily automations that act differently on workdays than non-workdays. For example, you could make your bedroom lights turn on (gently) at 7 in the morning if it is a workday but wait until 11 if it is a non-working day. @@ -30,7 +30,7 @@ Check the [country list](https://github.com/dr-prodigy/python-holidays#available {% include integrations/config_flow.md %} Days are specified as follows: `mon`, `tue`, `wed`, `thu`, `fri`, `sat`, `sun`. -The keyword `holiday` is used for public holidays identified by the holidays module. +The keyword `holiday` is used for public holidays identified by the holidays module and holidays added by the `add_holidays` configuration option.
@@ -40,7 +40,7 @@ Take note of the `holiday` keyword. Your first instinct might be to add it to th ## Specific field information -Country code must be given according to [holidays](https://pypi.org/project/holidays/) notation. +Country code must be given according to [holidays](https://pypi.org/project/holidays/) notation. The country can also be set to `None` to start with an empty set of holidays. This is useful in conjunction with the add holidays field. Subdivision code must be given according to [holidays](https://pypi.org/project/holidays/) notation.