docs-v2/content/flux/v0.x/stdlib/date/week.md

title	description	aliases	menu	weight	introduced
date.week() function	The `date.week()` function returns the ISO week of the year for a specified time. Results range from `[1-53]`.	/influxdb/v2.0/reference/flux/functions/date/week/ /influxdb/v2.0/reference/flux/stdlib/date/week/ /influxdb/cloud/reference/flux/stdlib/date/week/	flux_0_x_ref name parent date.week date	301	0.37.0

The date.week() function returns the ISO week of the year for a specified time. Results range from [1-53].

import "date"

date.week(t: 2019-07-17T12:05:21.012Z)

// Returns 29

Parameters

t

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

Examples

Return the week of the year

import "date"

date.week(t: 2020-02-11T12:21:03.293534940Z)

// Returns 7

Return the week of the year using a relative duration

import "date"

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

date.week(t: -12d)

// Returns 5