week_of_year()
Learn how to use the week_of_year() function to get the integer representation of the week.
Returns an integer that represents the week number. The week number is calculated from the first week of a year, which is the one that includes the first Thursday, according to ISO 8601.
Deprecated aliases: weekofyear()
Syntax
week_of_year(date)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| date | datetime | ✔️ | The date for which to return the week of the year. |
Returns
week number - The week number that contains the given date.
Examples
| Input | Output |
|---|---|
week_of_year(datetime(2020-12-31)) | 53 |
week_of_year(datetime(2020-06-15)) | 25 |
week_of_year(datetime(1970-01-01)) | 1 |
week_of_year(datetime(2000-01-01)) | 52 |
The current version of this function, week_of_year(), is ISO 8601 compliant; the first week of a year is defined as the week with the year’s first Thursday in it.
The current version of this function, week_of_year(), is ISO 8601 compliant; the first week of a year is defined as the week with the year’s first Thursday in it.
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.