New in version 2.2.
crond
after changing the timezone, otherwise the jobs may run at the wrong time.timedatectl
or edit /etc/sysconfig/clock
or /etc/timezone
and hwclock
. On SmartOS, sm-set-timezone
, for macOS, systemsetup
, for BSD, /etc/localtime
is modified.Parameter | Choices/Defaults | Comments |
---|---|---|
hwclock |
| 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. At least one of name and hwclock are required. Only used on Linux.
aliases: rtc |
name | Name of the timezone for the system clock. Default is to keep current setting. At least one of name and hwclock are required.
|
Note
sm-set-timezone
utility (part of the smtools package) is required to set the zone timezone- name: set timezone to Asia/Tokyo timezone: name: Asia/Tokyo
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description | |
---|---|---|---|
diff complex | success | The differences about the given arguments. | |
after dict | The values after change | ||
before dict | The values before change |
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/timezone_module.html