From c578abb9985e73b167e55d9f8041feb0a2ccc727 Mon Sep 17 00:00:00 2001 From: Ben Tasker <88340935+btasker@users.noreply.github.com> Date: Thu, 5 Dec 2024 17:27:33 +0000 Subject: [PATCH] docs: note that `option location` does not change the timezone used in `_time` (#5702) * docs: note that `option location` does not change the timezone used in results * Update content/flux/v0/spec/options.md Co-authored-by: Scott Anderson * Update content/flux/v0/stdlib/timezone/location.md Co-authored-by: Scott Anderson * Update content/flux/v0/stdlib/timezone/fixed.md Co-authored-by: Scott Anderson * Apply suggestions from code review --------- Co-authored-by: Scott Anderson --- content/flux/v0/spec/options.md | 5 +++++ content/flux/v0/stdlib/timezone/fixed.md | 4 ++++ content/flux/v0/stdlib/timezone/location.md | 3 +++ 3 files changed, 12 insertions(+) diff --git a/content/flux/v0/spec/options.md b/content/flux/v0/spec/options.md index ad243699e..93e4d7073 100644 --- a/content/flux/v0/spec/options.md +++ b/content/flux/v0/spec/options.md @@ -62,4 +62,9 @@ option location = timezone.fixed(offset: -5h) option location = timezone.location(name: "America/Denver") ``` +> [!Note] +> The `location` option only affects boundaries used for windowing, specifically around time shifts +> like daylight savings. It does not change timestamps in the `_time` column, which are always UTC. + + {{< page-nav prev="/flux/v0/spec/variables/" next="/flux/v0/spec/types/" >}} diff --git a/content/flux/v0/stdlib/timezone/fixed.md b/content/flux/v0/stdlib/timezone/fixed.md index 458420782..2343a2167 100644 --- a/content/flux/v0/stdlib/timezone/fixed.md +++ b/content/flux/v0/stdlib/timezone/fixed.md @@ -77,3 +77,7 @@ option location = timezone.fixed(offset: -8h) ``` +> [!Note] +> The `location` option only affects boundaries used for windowing, specifically around time shifts +> like daylight savings. It does not change timestamps in the `_time` column, which are always UTC. + diff --git a/content/flux/v0/stdlib/timezone/location.md b/content/flux/v0/stdlib/timezone/location.md index 4fcaf06e4..f6dec797e 100644 --- a/content/flux/v0/stdlib/timezone/location.md +++ b/content/flux/v0/stdlib/timezone/location.md @@ -75,3 +75,6 @@ option location = timezone.location(name: "America/Los_Angeles") ``` +> [!Note] +> The `location` option only affects boundaries used for windowing, specifically around time shifts +> like daylight savings. It does not change timestamps in the `_time` column, which are always UTC.