docs-v2/content/flux/v0/stdlib/experimental/date/boundaries/saturday.md

2.2 KiB

title description menu weight flux/v0/tags introduced
boundaries.saturday() function `boundaries.saturday()` returns a record with `start` and `stop` boundary timestamps for last Saturday.
flux_v0_ref
name parent identifier
boundaries.saturday experimental/date/boundaries experimental/date/boundaries/saturday
301
date/time
0.177.1

boundaries.saturday() returns a record with start and stop boundary timestamps for last Saturday.

Last Saturday is relative to now(). If today is Saturday, the function returns boundaries for the previous Saturday.

Function type signature
() => {stop: time, start: time}

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

Examples

Return start and stop timestamps of last Saturday

import "experimental/date/boundaries"

option location = timezone.fixed(offset: -8h)
option now = () => 2021-12-30T00:40:44Z

boundaries.saturday()// Returns {start: 2022-12-25T08:00:00Z, stop:2022-12-26T08:00:00Z }


Query data collected last Saturday

import "experimental/date/boundaries"

day = boundaries.saturday()

from(bucket: "example-bucket")
    |> range(start: day.start, stop: day.stop)