Merge pull request #8001 from Icinga/feature/documentation-time-zones…

…-7069 Doc: clarify TimePeriod/ScheduledDowntime time zone handling
Icinga · Jan 14, 2021 · 3ebd44c · 3ebd44c
2 parents 5efe3e6 + 28bd238
commit 3ebd44c
Show file tree

Hide file tree

Showing 2 changed files with 17 additions and 0 deletions.
diff --git a/doc/08-advanced-topics.md b/doc/08-advanced-topics.md
@@ -376,6 +376,19 @@ object TimePeriod "prod-notification" {
 }
 ```
 
+### Time zone handling <a id="timeperiods-timezones"></a>
+
+Icinga 2 takes the OS' time zone including DST changes into account.
+
+Times inside DST changes are interpreted as before the DST changes.
+I.e. for the time zone Europe/Berlin:
+
+* On 2020-10-25 03:00 CEST the time jumps back to 02:00 CET.
+  For Icinga 02:30 means 02:30 CEST.
+* On 2021-02-28 02:00 CET the time jumps forward to 03:00 CEST.
+  For Icinga (the actually not existing) 02:30 refers to CET
+  and effectively means 03:30 CEST.
+
 ## External Passive Check Results <a id="external-check-results"></a>
 
 Hosts or services which do not actively execute a check plugin to receive

diff --git a/doc/09-object-types.md b/doc/09-object-types.md
@@ -667,6 +667,8 @@ name you specified. This means you can define more than one object
 with the same (short) name as long as one of the `host_name` and
 `service_name` attributes has a different value.
 
+See also [time zone handling](08-advanced-topics.md#timeperiods-timezones).
+
 
 ### Service <a id="objecttype-service"></a>
 
@@ -860,6 +862,8 @@ Runtime Attributes:
   --------------------------|-----------------------|----------------------------------
   is\_inside                | Boolean               | Whether we're currently inside this timeperiod.
 
+See also [time zone handling](08-advanced-topics.md#timeperiods-timezones).
+
 
 ### User <a id="objecttype-user"></a>