---
title: boundaries.month() function
description: boundaries.month() returns a record with start and stop boundary timestamps for the current month.
url: https://docs.influxdata.com/flux/v0/stdlib/date/boundaries/month/
estimated_tokens: 1508
product: Flux
version: v0
---

# boundaries.month() function

-   Flux 0.172.0 – 0.177.1
-   View InfluxDB support

`boundaries.month()` returns a record with `start` and `stop` boundary timestamps for the current month.

`now()` determines the current month.

##### Function type signature

```js
(?month_offset: int) => {stop: time, start: time}
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### month\_offset

Number of months to offset from the current month. Default is `0`.

Use a negative offset to return boundaries from previous months. Use a positive offset to return boundaries for future months.

## Examples

-   [Return start and stop timestamps for the current month](#return-start-and-stop-timestamps-for-the-current-month)
-   [Query data from this month](#query-data-from-this-month)
-   [Query data from last month](#query-data-from-last-month)

### Return start and stop timestamps for the current month

```js
import "date/boundaries"

option now = () => 2022-05-10T10:10:00Z

boundaries.month(

)// Returns {start:2022-05-01T00:00:00.000000000Z, stop:2022-06-01T00:00:00.000000000Z}

```

### Query data from this month

```js
import "date/boundaries"

thisMonth = boundaries.month()

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

### Query data from last month

```js
import "date/boundaries"

lastMonth = boundaries.month(month_offset: -1)

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

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