From 1a1056099c597a38f00fe4931089137772461d0b Mon Sep 17 00:00:00 2001
From: "patchback[bot]" <45432694+patchback[bot]@users.noreply.github.com>
Date: Fri, 27 Mar 2026 12:45:03 +0100
Subject: [PATCH] [PR #11685/909458a6 backport][stable-12] docs: improve
 timezone module examples and add hwclock usage (#11696)

docs: improve timezone module examples and add hwclock usage (#11685)

* docs: add variable-based example for timezone module

### Summary
Added a variable-based example to the EXAMPLES section of the timezone module.

### Changes
- Added an example demonstrating how to set timezone dynamically using a variable

### Motivation
Using variables is a common practice in Ansible playbooks. This example helps users understand how to make the module usage more flexible and reusable.

* docs: improve timezone module examples with hwclock usage

### Summary
Improved the EXAMPLES section of the timezone module by adding a more meaningful, module-specific example.

### Changes
- Added an example demonstrating usage of the `hwclock` parameter
- Simplified examples to avoid redundancy
- Fixed formatting issues causing CI failures (invalid YAML, lint errors)

### Motivation
The previous examples were minimal and did not demonstrate module-specific features. This update adds a more practical use case and ensures the examples follow proper formatting and validation rules.

(cherry picked from commit 909458a66134428785202b068a40ccb28aae6ec6)

Co-authored-by: Anshjeet Mahir <anshjeetmahir123@gmail.com>
---
 plugins/modules/timezone.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/plugins/modules/timezone.py b/plugins/modules/timezone.py
index dd92cd5bca..65eae5a95b 100644
--- a/plugins/modules/timezone.py
+++ b/plugins/modules/timezone.py
@@ -60,6 +60,11 @@ EXAMPLES = r"""
   become: true
   community.general.timezone:
     name: Asia/Tokyo
+
+- name: Set timezone and hardware clock to UTC
+  community.general.timezone:
+    name: UTC
+    hwclock: UTC
 """
 
 import errno