boundaries.week() function
boundaries.week() returns a record with start and stop boundary timestamps of the current week.
By default, weeks start on Monday.
Function type signature
(?start_sunday: bool, ?week_offset: int) => {stop: time, start: time}
For more information, see Function type signatures.
Parameters
start_sunday
Indicate if the week starts on Sunday. Default is false.
When set to false, the week starts on Monday.
week_offset
Number of weeks to offset from the current week. Default is 0.
Use a negative offset to return boundaries from previous weeks. Use a positive offset to return boundaries for future weeks.
Examples
- Return start and stop timestamps of the current week starting on Monday
- Return start and stop timestamps of the current week starting on Sunday
- Query data from the current week
- Query data from last week
Return start and stop timestamps of the current week starting on Monday
import "date/boundaries"
option now = () => 2022-05-10T00:00:00.00001Z
boundaries.week(
)// Returns {start: 2022-05-09T00:00:00.000000000Z, stop: 2022-05-16T00:00:00.000000000Z}
Return start and stop timestamps of the current week starting on Sunday
import "date/boundaries"
option now = () => 2022-05-10T10:10:00Z
boundaries.week(
start_sunday: true,
)// Returns {start: 2022-05-08T00:00:00.000000000Z, stop: 2022-05-14T00:00:00.000000000Z}
Query data from the current week
import "date/boundaries"
thisWeek = boundaries.week()
from(bucket: "example-bucket")
|> range(start: thisWeek.start, stop: thisWeek.stop)
Query data from last week
import "date/boundaries"
lastWeek = boundaries.week(week_offset: -1)
from(bucket: "example-bucket")
|> range(start: lastWeek.start, stop: lastWeek.stop)
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for Flux and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support. Customers using a trial license can email trial@influxdata.com for assistance.