---
title: date.month() function
description: date.month() returns the month of a specified time. Results range from [1 - 12].
url: https://docs.influxdata.com/flux/v0/stdlib/date/month/
estimated_tokens: 458
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/date/month/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.37.0+

InfluxDB support

`date.month()` returns the month of a specified time. Results range from `[1 - 12]`.

|Returned value|  Month  |
|--------------|---------|
|      1       | January |
|      2       |February |
|      3       |  March  |
|      4       |  April  |
|      5       |   May   |
|      6       |  June   |
|      7       |  July   |
|      8       | August  |
|      9       |September|
|      10      | October |
|      11      |November |
|      12      |December |

##### Function type signature

```js
(t: A, ?location: {zone: string, offset: duration}) => int where A: Timeable
```

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

## Parameters

### t

(Required)
Time to operate on.

Use an absolute time, relative duration, or integer.
Durations are relative to `now()`.

### location

Location used to determine timezone.
Default is the `location` option.

## Examples

* [Return the month of a time value](#return-the-month-of-a-time-value)
* [Return the month of a relative duration](#return-the-month-of-a-relative-duration)
* [Return the current numeric month](#return-the-current-numeric-month)

### Return the month of a time value

```
import "date"

date.month(t: 2020-02-11T12:21:03.29353494Z)// Returns 2

```

### Return the month of a relative duration

```
import "date"

option now = () => 2020-02-11T12:21:03.29353494Z

date.month(t: -3mo)// Returns 8

```

### Return the current numeric month

```js
import "date"

date.month(t: now())
```

[date/time](/flux/v0/tags/date/time/)
| Returned value | Month |
| --- | --- |
| Returned value | Month |
| 1 | January |
| 2 | February |
| 3 | March |
| 4 | April |
| 5 | May |
| 6 | June |
| 7 | July |
| 8 | August |
| 9 | September |
| 10 | October |
| 11 | November |
| 12 | December |