Home Assistant OMIE 集成:用 omie.get_prices_for_date 动作获取任意日期日前电价

发布时间:2026/9/16 18:33:36
Home Assistant OMIE 集成:用 omie.get_prices_for_date 动作获取任意日期日前电价 Home Assistant OMIE 集成用 omie.get_prices_for_date 动作获取任意日期日前电价【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读omie.get_prices_for_date是 Home Assistant 官方OMIE伊比利亚半岛电力市场运营商集成提供的动作action用于按需获取西班牙、葡萄牙或两国在任意已发布日期的日前市场day-ahead market15 分钟电价。它解决了 OMIE 传感器只能反映当前时刻价格的局限让你可以在自动化或脚本中向前看对比明天的电价、把洗衣机或电动汽车充电安排在一天中电价最低的时段。阅读完本文你将掌握该动作在 UI 与 YAML 两种方式下的完整用法、响应数据结构以及如何通过response_variable在后续步骤中消费返回的电价数据。动作背景OMIE 集成与历史/未来价格缺口omie.get_prices_for_date隶属于 OMIE 集成。OMIEOperador del Mercado Ibérico de Energía是西班牙与葡萄牙日前及日内电力市场的运营方该集成ha_domain: omie2026.5 版本引入质量等级 silver云轮询型集成通过官方 API 拉取日前市场价格并以两个传感器对外暴露Portugal spot price葡萄牙当前 15 分钟现货电价€/kWhSpain spot price西班牙当前 15 分钟现货电价€/kWh这两个传感器在每个刻钟按中欧时间开始时轮询更新始终反映当前价格。而 本动作文档 明确指出了它的价值定位传感器只反映当前价格该动作则让你获取任意已发布日期的价格用于向前规划例如比较明天的电价或调度电器在电价最低的时段运行。发布节奏与可用日期边界理解该动作的返回行为需要先知道 OMIE 的价格发布节奏次日价格每天约 13:30 CET/CEST 发布。如果请求的日期尚未发布动作会报告价格不可用。向前回溯存在下限如果请求的日期早于15 分钟粒度价格开始可用的日期动作会报告该日期不存在价格并告知你可请求的最早日期。这一边界信息对编写健壮的自动化很重要——例如在调度任务中应先捕获并处理价格未发布的返回结果而不是直接假设响应中一定包含价格数据。从用户界面UI使用该动作在自动化或脚本中调用该动作的 UI 步骤如下对应 actions/ui_header.md 的可视化操作方式进入SettingsAutomations scenes自动化与场景。打开现有自动化或脚本或选择Create automationCreate new automation。新建自动化时在When触发条件部分添加一个触发器脚本不需要触发器它们在被其他内容调用时运行。在Then do执行部分选择Add action添加动作。在搜索框中搜索并选择OMIE - Spain and Portugal electricity prices: Get prices for date。选择要查询的Date日期并选择要获取价格的Countries国家。在Response variable响应变量字段中输入一个用于存储数据的名称例如prices。选择Save保存。UI 选项一览选项是否必填说明Date日期必填要获取价格的日期Countries国家必填要获取价格的国家西班牙、葡萄牙或两者。默认同时选择两者在 YAML 中使用该动作在 YAML 中该动作的完整动作名称为omie.get_prices_for_date数据通过data传递返回值通过response_variable存入变量供同一自动化或脚本的后续步骤使用对应 actions/yaml_header.md 的底层字段参考。原文档给出的完整示例action: omie.get_prices_for_date data: date: 2026-07-08 countries: - es - pt response_variable: prices该示例获取指定日期西班牙es和葡萄牙pt两国的价格并将结果存入prices变量。需要注意action:一行后紧跟的data:与response_variable:是同级字段共同组成一次完整的动作调用。YAML 选项参考字段类型必填说明datedate是要获取价格的日期格式为YYYY-MM-DDcountrieslist是要获取价格的国家列表包含es、pt或两者默认两者响应数据结构与字段说明该动作的响应以国家代码为键es对应西班牙pt对应葡萄牙。请求两个国家时两个键都会出现。每个键的值是一个15 分钟间隔quarter-hourly intervals的列表每个间隔包含以下字段start间隔的开始时间时区为 CET/CESTend间隔的结束时间时区为 CET/CESTprice该间隔的电力现货价格单位为€/kWh原文档给出的缩短版响应示例es: - start: 2026-07-08T00:00:0002:00 end: 2026-07-08T00:15:0002:00 price: 0.03415 - start: 2026-07-08T00:15:0002:00 end: 2026-07-08T00:30:0002:00 price: 0.03521 pt: - start: 2026-07-08T00:00:0002:00 end: 2026-07-08T00:15:0002:00 price: 0.0361 - start: 2026-07-08T00:15:0002:00 end: 2026-07-08T00:30:0002:00 price: 0.0372从示例可以看到时间戳带02:00时区偏移CEST中欧夏令时价格以欧元/千瓦时为单位的十进制浮点数表示一天 24 小时共 96 个 15 分钟间隔。进阶在后续步骤中消费响应数据该动作的结果必须通过response_variable保存才能在后续步骤中使用。Home Assistant 文档 perform-actions.markdown 对response_variable机制有通用说明它是包含响应数据的变量名称可自定义这类数据通常是动态或体量较大、不适合放进实体状态的动作响应数据。同文档还演示了如何在后续动作中结合模板消费响应数据。一个实用的落地方案是在动作之后追加一条notify通知用模板遍历prices中的间隔找出当天最低价时段并推送。例如action: notify.mobile_app_phone data: title: 明日最低电价 message: - {% set min_interval prices.es | min(attributeprice) %} 最低价 {{ %.4f % min_interval.price }} €/kWh 时段 {{ min_interval.start }} 至 {{ min_interval.end }}核心思想是response_variable中的内容在同一脚本/自动化的后续步骤中可直接用模板访问这使omie.get_prices_for_date不只是查一下价格而是可以作为电价感知型自动化的数据源。典型应用场景与注意事项结合 OMIE 集成文档 与 2026.5 发布说明该动作的典型应用包括电价敏感型调度基于次日的 15 分钟电价决定何时运行洗碗机、给电动汽车充电或加热热水。账单预估与自发自用决策结合批发价评估可变电价套餐下的电费或判断是否将光伏等本地发电盈余卖给电网。向前比较由于传感器只反映当前刻钟价格用该动作查询未来已发布日期的价格可以在自动化中做明天比今天便宜/贵的跨日比较。注意事项查询未发布日期的价格会得到价格不可用的返回查询早于 15 分钟粒度可用起始日的日期会得到该日期无价格并附带最早可请求日期自动化应妥善处理这两类返回。价格以 €/kWh 计、时间戳以 CET/CEST 表达做跨时区比较或与当地分时电价叠加时要注意时区与单位换算。该动作是查询型动作不修改任何实体状态其结果必须显式存入response_variable才能复用。手动验证开发者工具中试运行如需在不编写 YAML 的情况下快速验证可以前往SettingsToolsActions开发者工具中的动作/服务搜索该动作填写日期与国家字段后选择Perform action执行直接观察返回的响应数据对应 actions/try_it.md 的操作指引。这是熟悉响应结构、验证日期边界行为最直接的方式。相关动作与延伸阅读OMIE 集成总览了解两个现货价格传感器的数据来源、轮询节奏每刻钟按中欧时间轮询与配置方式。响应变量与动作响应数据response_variable的通用机制与模板消费示例。2026.5 发布说明该集成首次引入时的功能定位介绍当前价格与次小时价格传感器、智能化自动化场景。【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考