ansible / ansible.builtin / v2.9.27 / module / timezone Configure timezone setting | "added in version" 2.2 of ansible.builtin" Authors: Shinichi TAMURA (@tmshn), Jasper Lievisse Adriaanse (@jasperla), Indrajit Raychaudhuri (@indrajitr) preview | supported by communityansible.builtin.timezone (v2.9.27) — module
pip
Install with pip install ansible==2.9.27
This module configures the timezone setting, both of the system clock and of the hardware clock. If you want to set up the NTP, use M(service) module.
It is recommended to restart C(crond) after changing the timezone, otherwise the jobs may run at the wrong time.
Several different tools are used depending on the OS/Distribution involved. For Linux it can use C(timedatectl) or edit C(/etc/sysconfig/clock) or C(/etc/timezone) and C(hwclock). On SmartOS, C(sm-set-timezone), for macOS, C(systemsetup), for BSD, C(/etc/localtime) is modified. On AIX, C(chtz) is used.
As of Ansible 2.3 support was added for SmartOS and BSDs.
As of Ansible 2.4 support was added for macOS.
As of Ansible 2.9 support was added for AIX 6.1+
Windows and HPUX are not supported, please let us know if you find any other OS/distro in which this fails.
- name: Set timezone to Asia/Tokyo timezone: name: Asia/Tokyo
name: description: - Name of the timezone for the system clock. - Default is to keep current setting. - B(At least one of name and hwclock are required.) type: str hwclock: aliases: - rtc choices: - local - UTC description: - Whether the hardware clock is in UTC or in local timezone. - Default is to keep current setting. - Note that this option is recommended not to change and may fail to configure, especially on virtual environments such as AWS. - B(At least one of name and hwclock are required.) - I(Only used on Linux.) type: str
diff: contains: after: description: The values after change type: dict before: description: The values before change type: dict description: The differences about the given arguments. returned: success type: complex