community.general.timezone 模块 – 配置时区设置

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install community.general。

要在剧本中使用它，请指定： community.general.timezone。

概要 

此模块配置系统时钟和硬件时钟的时区设置。如果您想设置 NTP，请使用 ansible.builtin.service 模块。
建议更改时区后重新启动 crond，否则作业可能在错误的时间运行。
根据所涉及的操作系统/发行版，将使用几种不同的工具。对于 Linux，它可以使用 timedatectl 或编辑 /etc/sysconfig/clock 或 /etc/timezone 和 hwclock。在 SmartOS 上，sm-set-timezone，在 macOS 上，systemsetup，在 BSD 上，修改 /etc/localtime。在 AIX 上，使用 chtz。
确保使用相应的操作系统包（例如 tzdata，通常在不使用最小安装（如 Alpine Linux）时总是安装）安装 zoneinfo 文件。
不支持 Windows 和 HPUX，如果您发现此模块在其他操作系统/发行版中失败，请告知我们。

参数	注释
hwclock 别名：rtc 字符串	硬件时钟是使用 UTC 还是本地时区。默认为保持当前设置。注意，不建议更改此选项，并且可能无法配置，尤其是在 AWS 等虚拟环境中。至少需要 name 或 hwclock 之一。仅在 Linux 上使用。选项 `"local"` `"UTC"`
name 字符串	系统时区的名称。默认为保持当前设置。至少需要 name 或 hwclock 之一。

属性	支持	描述
check_mode	支持：完全支持	可以在 `check_mode` 下运行并返回更改状态预测，而无需修改目标。
diff_mode	支持：完全支持	在差异模式下，将返回有关已更改内容（或可能需要在 `check_mode` 下更改的内容）的详细信息。

注意

在 Ubuntu 24.04 上，需要 util-linux-extra 包来提供 hwclock 命令。
在 SmartOS 上，需要 sm-set-timezone 实用程序（smtools 包的一部分）来设置时区。
在 AIX 上，只能使用 Olson/tz 数据库时区（不支持 POSIX）。新的时区设置生效也需要在 AIX 上重新启动操作系统。注意需要 AIX 6.1+(操作系统级别 61 或更高版本)。

- name: Set timezone to Asia/Tokyo
  become: true
  community.general.timezone:
    name: Asia/Tokyo

常见的返回值已在此处记录，以下是此模块特有的字段