Home Assistant Jewish Calendar「Count the Omer」动作完整指南自动化倒数 Omer 计数【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇指南系统讲解 Home Assistant 中犹太日历Jewish Calendar集成的Count the Omer动作jewish_calendar.count_omer它根据指定日期返回对应的 Omer 计数短语适用于晚间例行自动化中通过语音或屏幕播报每日 Omer 天数。读完本文你将掌握该动作在 UI 与 YAML 两种模式下的完整配置方式、全部参数Nusach、日期、日落边界、语言、响应数据结构以及如何把结果接入通知与实体状态。动作是什么Count the Omer是 Home Assistant 犹太日历集成提供的一个服务动作其作用是返回给定日期对应的 Omer 计数短语。Omer 是指从逾越节Pesach到五旬节Shavuot之间的 49 天计数周期犹太传统要求每晚进行一次计数Sefirat HaOmer。该动作的典型使用场景是在 Omer 周期内作为晚间例行自动化evening routine的一部分通过 TTS 语音播报、仪表盘文本或通知向家庭成员播报/展示当天的 Omer 计数。例如在第 37 天动作会返回 Today is the thirty-seventh day, which are five weeks and two days of the Omer 这样的完整短语。本动作是 source/_integrations/jewish_calendar.markdown 所描述的 Jewish Calendar 集成的动作之一。该集成自 Home Assistant 0.79 起提供通过配置流config flow接入并额外提供day_of_the_omer传感器整数 1–49非 Omer 期间为 0与本文动作互为补充。动作特性返回数据型动作该动作不是简单触发某个设备而是返回一段文本与结构化数字因此调用时必须使用response_variable捕获结果。不支持 targets在 UI 中不会提示选择区域、设备、实体或标签。你只需提供日期、Nusach礼俗传统等参数即可。日期灵活性默认统计今天也可显式指定任意日期还可控制是否以日落作为新一天的边界犹太历一天从日落开始。从用户界面UI使用该动作如果你倾向以可视化方式构建自动化与脚本Home Assistant 会引导你逐步完成配置无需编写 YAML。操作步骤如下进入设置Settings自动化与场景Automations scenes。打开一个现有的自动化或脚本或选择创建自动化Create automation创建新自动化Create new automation。若在新建自动化在When何时触发部分添加一个触发器脚本不需要触发器它们由其他内容调用时运行。在Then do然后执行部分选择添加动作Add action。在搜索框中搜索并选择Jewish Calendar: Count the Omer。选择Nusach并可选设置Date日期、After sunset日落后与Language语言。选择保存Save。UI 选项说明UI 中的每个选项如下表所示。这些字段由文档站点的options_uiLiquid 块渲染对应实现见 plugins/options_ui.rb会为每个选项标注 Required必填或 Optional可选徽标选项必填说明Date日期可选要统计 Omer 的日期默认为今天。After sunset日落后可选针对给定日期使用下一个希伯来日犹太历一天自日落开始。若日期留空此选项会被忽略。默认开启。Nusach礼俗必填计数 Omer 所用的礼俗传统可选Sfarad、Ashkenaz、Adot Mizrah、Italian。Language语言可选计数使用的语言支持 English、Hebrew、French默认为 Hebrew。在 YAML 中使用该动作如果你直接编写 YAML或想了解 Home Assistant 底层究竟做了什么请参考本节的技术参考——它列出 YAML 字段名、类型与必填性。在 YAML 中该动作被引用为jewish_calendar.count_omer。由于该动作返回数据必须使用response_variable捕获结果。基础示例如下action: jewish_calendar.count_omer data: nusach: sfarad date: 2025-05-20 language: en response_variable: omer上述配置会统计指定日期的 Omer 计数并将结果存入omer变量中供后续动作如notify、模板渲染读取。YAML 选项完整参考字段必填类型默认值说明date否date今天要统计 Omer 的日期。after_sunset否booleantrue针对给定日期使用下一个希伯来日自日落开始。若date为空则忽略此选项。nusach是stringsfarad计数 Omer 的礼俗传统取值之一sfarad、ashkenaz、adot_mizrah、italian。language否stringhe计数使用的语言支持en、he、fr默认为希伯来语。这些字段在文档站点由options_yaml块渲染实现见 plugins/options_yaml.rb其渲染逻辑复用共享的ConfigurationBlock为每个字段展示类型与 Required/Optional 徽标与 UI 板块保持一致的信息结构。字段细节解读nusach必填决定计数短语采用哪种祈祷/计数传统。文档同时给出了 UI 名Sfarad、Ashkenaz、Adot Mizrah、Italian与 YAML 值sfarad、ashkenaz、adot_mizrah、italian注意 UI 展示名称与 YAML 值之间的下划线/空格差异。after_sunset犹太历的一天从日落到次日日落。开启此选项后动作会依据指定时刻相对于日落的先后使用下一个希伯来日来计算计数日。若未提供date动作会结合当前时间与日落边界自动判定当前希伯来日此时该选项自然被忽略文档明确说明 ignored if the date is empty。date支持任意日期字符串便于为历史日期或计划日期生成计数短语。language返回的message文本语言与集成配置中的语言English/Hebrew见 source/_integrations/jewish_calendar.markdown相互独立可按动作粒度单独指定。响应数据结构该动作返回以下字段message用于计数 Omer 的短语。当给定日期不属于 Omer 期间时该字段为空字符串。weeks已完整计数的周数。days在完整周数之外额外计数的天数。total_days已计数的总天数。以本文前面的 YAML 示例date: 2025-05-20为例响应大致如下message: - Today is the thirty-seventh day, which are five weeks and two days of the Omer weeks: 5 days: 2 total_days: 37即第 37 天 5 个完整周 2 天。total_days是绝对值weeks与days是其分解形式方便你在自动化中按周/天分别处理例如拼接自定义播报文本。实战示例用默认希伯来语统计今天最小化调用只需提供必填的nusach。不传date时动作会统计当前希伯来日自动考虑当前时间与日落的相对关系并默认以希伯来语返回文本action: jewish_calendar.count_omer data: nusach: sfarad response_variable: omer响应大致如下message: היום ארבעה עשר יום שהם שני שבועות לעומר weeks: 2 days: 0 total_days: 14即第 14 天 2 个完整周希伯来语短语为 היום ארבעה עשר יום שהם שני שבועות לעומר。结合集成传感器与通知的完整自动化Jewish Calendar 集成本身提供了day_of_the_omer数据传感器Omer 期间的整数 1–49非 Omer 期间为 0可作为触发器或条件与本文动作协同使用。例如晚间例行自动化可以这样组织用时间触发器如每晚日落后的固定时间启动以day_of_the_omer传感器为条件仅在值大于 0 时继续调用jewish_calendar.count_omer并将结果存入response_variable用notify或 TTS 服务读取omer.message进行播报。由于动作返回的是完整短语含 Today is the thirty-seventh day... 之类的整句你可以直接将其作为播报文本无需在自动化中自行拼接周数与天数。常见问题与使用提示非 Omer 期间返回空字符串message在无计数日为空。若你的自动化需要区分有计数/无计数可同时检查total_days是否为 0或预先用day_of_the_omer传感器过滤。日落边界after_sunset默认开启意味着今晚的计数实际归属于下一个希伯来日。若你的自动化在日落后运行且不希望跨日请结合你的使用场景判断是否需要显式传date或调整该选项。语言与 Nusach 可组合四种 Nusachsfarad、ashkenaz、adot_mizrah、italian与三种语言en、he、fr可自由组合满足不同礼俗传统与受众语言的需求。响应变量命名response_variable的名称可自由选择如omer后续动作中通过该名称访问message、weeks、days、total_days四个字段。延伸阅读集成整体能力与全部实体source/_integrations/jewish_calendar.markdownUI 选项渲染机制plugins/options_ui.rbYAML 选项渲染机制plugins/options_yaml.rb动作文档通用 YAML 章节说明source/_includes/actions/yaml_header.md【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Home Assistant Jewish Calendar「Count the Omer」动作完整指南：自动化倒数 Omer 计数
Home Assistant Jewish Calendar「Count the Omer」动作完整指南自动化倒数 Omer 计数【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io本篇指南系统讲解 Home Assistant 中犹太日历Jewish Calendar集成的Count the Omer动作jewish_calendar.count_omer它根据指定日期返回对应的 Omer 计数短语适用于晚间例行自动化中通过语音或屏幕播报每日 Omer 天数。读完本文你将掌握该动作在 UI 与 YAML 两种模式下的完整配置方式、全部参数Nusach、日期、日落边界、语言、响应数据结构以及如何把结果接入通知与实体状态。动作是什么Count the Omer是 Home Assistant 犹太日历集成提供的一个服务动作其作用是返回给定日期对应的 Omer 计数短语。Omer 是指从逾越节Pesach到五旬节Shavuot之间的 49 天计数周期犹太传统要求每晚进行一次计数Sefirat HaOmer。该动作的典型使用场景是在 Omer 周期内作为晚间例行自动化evening routine的一部分通过 TTS 语音播报、仪表盘文本或通知向家庭成员播报/展示当天的 Omer 计数。例如在第 37 天动作会返回 Today is the thirty-seventh day, which are five weeks and two days of the Omer 这样的完整短语。本动作是 source/_integrations/jewish_calendar.markdown 所描述的 Jewish Calendar 集成的动作之一。该集成自 Home Assistant 0.79 起提供通过配置流config flow接入并额外提供day_of_the_omer传感器整数 1–49非 Omer 期间为 0与本文动作互为补充。动作特性返回数据型动作该动作不是简单触发某个设备而是返回一段文本与结构化数字因此调用时必须使用response_variable捕获结果。不支持 targets在 UI 中不会提示选择区域、设备、实体或标签。你只需提供日期、Nusach礼俗传统等参数即可。日期灵活性默认统计今天也可显式指定任意日期还可控制是否以日落作为新一天的边界犹太历一天从日落开始。从用户界面UI使用该动作如果你倾向以可视化方式构建自动化与脚本Home Assistant 会引导你逐步完成配置无需编写 YAML。操作步骤如下进入设置Settings自动化与场景Automations scenes。打开一个现有的自动化或脚本或选择创建自动化Create automation创建新自动化Create new automation。若在新建自动化在When何时触发部分添加一个触发器脚本不需要触发器它们由其他内容调用时运行。在Then do然后执行部分选择添加动作Add action。在搜索框中搜索并选择Jewish Calendar: Count the Omer。选择Nusach并可选设置Date日期、After sunset日落后与Language语言。选择保存Save。UI 选项说明UI 中的每个选项如下表所示。这些字段由文档站点的options_uiLiquid 块渲染对应实现见 plugins/options_ui.rb会为每个选项标注 Required必填或 Optional可选徽标选项必填说明Date日期可选要统计 Omer 的日期默认为今天。After sunset日落后可选针对给定日期使用下一个希伯来日犹太历一天自日落开始。若日期留空此选项会被忽略。默认开启。Nusach礼俗必填计数 Omer 所用的礼俗传统可选Sfarad、Ashkenaz、Adot Mizrah、Italian。Language语言可选计数使用的语言支持 English、Hebrew、French默认为 Hebrew。在 YAML 中使用该动作如果你直接编写 YAML或想了解 Home Assistant 底层究竟做了什么请参考本节的技术参考——它列出 YAML 字段名、类型与必填性。在 YAML 中该动作被引用为jewish_calendar.count_omer。由于该动作返回数据必须使用response_variable捕获结果。基础示例如下action: jewish_calendar.count_omer data: nusach: sfarad date: 2025-05-20 language: en response_variable: omer上述配置会统计指定日期的 Omer 计数并将结果存入omer变量中供后续动作如notify、模板渲染读取。YAML 选项完整参考字段必填类型默认值说明date否date今天要统计 Omer 的日期。after_sunset否booleantrue针对给定日期使用下一个希伯来日自日落开始。若date为空则忽略此选项。nusach是stringsfarad计数 Omer 的礼俗传统取值之一sfarad、ashkenaz、adot_mizrah、italian。language否stringhe计数使用的语言支持en、he、fr默认为希伯来语。这些字段在文档站点由options_yaml块渲染实现见 plugins/options_yaml.rb其渲染逻辑复用共享的ConfigurationBlock为每个字段展示类型与 Required/Optional 徽标与 UI 板块保持一致的信息结构。字段细节解读nusach必填决定计数短语采用哪种祈祷/计数传统。文档同时给出了 UI 名Sfarad、Ashkenaz、Adot Mizrah、Italian与 YAML 值sfarad、ashkenaz、adot_mizrah、italian注意 UI 展示名称与 YAML 值之间的下划线/空格差异。after_sunset犹太历的一天从日落到次日日落。开启此选项后动作会依据指定时刻相对于日落的先后使用下一个希伯来日来计算计数日。若未提供date动作会结合当前时间与日落边界自动判定当前希伯来日此时该选项自然被忽略文档明确说明 ignored if the date is empty。date支持任意日期字符串便于为历史日期或计划日期生成计数短语。language返回的message文本语言与集成配置中的语言English/Hebrew见 source/_integrations/jewish_calendar.markdown相互独立可按动作粒度单独指定。响应数据结构该动作返回以下字段message用于计数 Omer 的短语。当给定日期不属于 Omer 期间时该字段为空字符串。weeks已完整计数的周数。days在完整周数之外额外计数的天数。total_days已计数的总天数。以本文前面的 YAML 示例date: 2025-05-20为例响应大致如下message: - Today is the thirty-seventh day, which are five weeks and two days of the Omer weeks: 5 days: 2 total_days: 37即第 37 天 5 个完整周 2 天。total_days是绝对值weeks与days是其分解形式方便你在自动化中按周/天分别处理例如拼接自定义播报文本。实战示例用默认希伯来语统计今天最小化调用只需提供必填的nusach。不传date时动作会统计当前希伯来日自动考虑当前时间与日落的相对关系并默认以希伯来语返回文本action: jewish_calendar.count_omer data: nusach: sfarad response_variable: omer响应大致如下message: היום ארבעה עשר יום שהם שני שבועות לעומר weeks: 2 days: 0 total_days: 14即第 14 天 2 个完整周希伯来语短语为 היום ארבעה עשר יום שהם שני שבועות לעומר。结合集成传感器与通知的完整自动化Jewish Calendar 集成本身提供了day_of_the_omer数据传感器Omer 期间的整数 1–49非 Omer 期间为 0可作为触发器或条件与本文动作协同使用。例如晚间例行自动化可以这样组织用时间触发器如每晚日落后的固定时间启动以day_of_the_omer传感器为条件仅在值大于 0 时继续调用jewish_calendar.count_omer并将结果存入response_variable用notify或 TTS 服务读取omer.message进行播报。由于动作返回的是完整短语含 Today is the thirty-seventh day... 之类的整句你可以直接将其作为播报文本无需在自动化中自行拼接周数与天数。常见问题与使用提示非 Omer 期间返回空字符串message在无计数日为空。若你的自动化需要区分有计数/无计数可同时检查total_days是否为 0或预先用day_of_the_omer传感器过滤。日落边界after_sunset默认开启意味着今晚的计数实际归属于下一个希伯来日。若你的自动化在日落后运行且不希望跨日请结合你的使用场景判断是否需要显式传date或调整该选项。语言与 Nusach 可组合四种 Nusachsfarad、ashkenaz、adot_mizrah、italian与三种语言en、he、fr可自由组合满足不同礼俗传统与受众语言的需求。响应变量命名response_variable的名称可自由选择如omer后续动作中通过该名称访问message、weeks、days、total_days四个字段。延伸阅读集成整体能力与全部实体source/_integrations/jewish_calendar.markdownUI 选项渲染机制plugins/options_ui.rbYAML 选项渲染机制plugins/options_yaml.rb动作文档通用 YAML 章节说明source/_includes/actions/yaml_header.md【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考