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.