docs-v2/content/flux/v0/stdlib/timezone/fixed.md

2.0 KiB

title description menu weight flux/v0/tags
timezone.fixed() function `timezone.fixed()` returns a location record with a fixed offset.
flux_v0_ref
name parent identifier
timezone.fixed timezone timezone/fixed
101
date/time
location

timezone.fixed() returns a location record with a fixed offset.

Function type signature
(offset: A) => {zone: string, offset: A}

{{% caption %}} For more information, see Function type signatures. {{% /caption %}}

Parameters

offset

({{< req >}}) Fixed duration for the location offset. This duration is the offset from UTC.

Examples

Return a fixed location record

import "timezone"

timezone.fixed(offset: -8h)// Returns {offset: -8h, zone: "UTC"}


Set the location option using a fixed location

import "timezone"

// This results in midnight at 00:00:00-08:00 on any day.
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.