2025.3.4
首页 ▸ Integrations ▸

太阳

太阳 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 将使用位置作为 在你的 Home Assistant 配置中配置的 来 追踪太阳是否在地平线之上或之下。太阳可以在 自动化中用作 带可选偏移量的触发器以模拟黎明/黄昏 或作为 条件，带可选偏移量测试太阳是否已经落下或升起。

默认配置

此 integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] 默认已配置和安装，你不需要 自己进行配置，除非你禁用或移除了 default_config: 行从你的 YAML 配置中。

如果是这种情况，可以按照接下来的段落中描述的进行配置。

配置

要将 太阳 integration 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

YAML 配置

或者，此集成也可以通过 YAML 手动配置和设置。如果要在你的安装中启用太阳集成，请在 configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件中添加以下内容。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。

# 示例 configuration.yaml 条目
sun:

自动化触发器

太阳的事件监听器将在太阳升起或落下时执行操作，并带有偏移量。

太阳触发器需要具有类型 ‘sun’，事件（落日或日出）和可选的偏移量。

triggers:
  - trigger: sun
    event: sunrise
    offset: "-01:00:01"
键名 描述
event 可能的值: sunset 或 sunrise
offset 太阳事件触发器的可选偏移量，以正数或负数秒表示，或以 HH:MM:SS（在太阳事件触发器之后）或 -HH:MM:SS（在太阳事件触发器之前）指定。

维护实体 sun.sun

可能的状态 描述
above_horizon 当太阳在地平线之上时。
below_horizon 当太阳在地平线之下时。

传感器

为了向后兼容，传感器也作为 sun.sun 实体的属性可用。

传感器 描述
下一次升起 下一次日出日期和时间（UTC）。
下一次落下 下一次日落日期和时间（UTC）。
下一次黎明 下一次黎明日期和时间（UTC）。
下一次黄昏 下一次黄昏日期和时间（UTC）。
下一次正午 下一次太阳正午日期和时间（UTC）。
下一次午夜 下一次太阳午夜日期和时间（UTC）。
高度 太阳高度。这是太阳和地平线之间的角度。负值表示太阳在地平线之下。
方位 太阳方位。从北开始顺时针显示的角度。
rising 如果太阳此时正在升起，且在太阳午夜之后和太阳正午之前则为真。

相关主题