docs-v2/content/v2.0/reference/flux/stdlib/date/week.md

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

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

Function type: Transformation

import "date"

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

// Returns 29

Parameters

t

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

Data type: Time | Duration

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