---
title: boundaries.week() function
description: boundaries.week() returns a record with start and stop boundary timestamps of the current week. By default, weeks start on Monday.
url: https://docs.influxdata.com/flux/v0/stdlib/experimental/date/boundaries/week/
estimated_tokens: 2078
product: Flux
version: v0
---

# boundaries.week() function

-   Flux 0.177.1+
-   View InfluxDB support

`boundaries.week()` is experimental and [subject to change at any time](/flux/v0/stdlib/experimental/#experimental-packages-are-subject-to-change).

`boundaries.week()` returns a record with `start` and `stop` boundary timestamps of the current week. By default, weeks start on Monday.

##### Function type signature

```js
(?start_sunday: bool, ?week_offset: int) => {stop: time, start: time}
```

For more information, see [Function type signatures](/flux/v0/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-monday)
-   [Return start and stop timestamps of the current week starting on Sunday](#return-start-and-stop-timestamps-of-the-current-week-starting-on-sunday)
-   [Query data from the current week](#query-data-from-the-current-week)
-   [Query data from last week](#query-data-from-last-week)

### Return start and stop timestamps of the current week starting on Monday

```js
import "experimental/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

```js
import "experimental/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

```js
import "experimental/date/boundaries"

thisWeek = boundaries.week()

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

### Query data from last week

```js
import "experimental/date/boundaries"

lastWeek = boundaries.week(week_offset: -1)

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

[date/time](/flux/v0/tags/date/time/)