MySQL - WEEKOFYEAR() Function

The MySQL WEEKOFYEAR() function is used to retrieve the calendar week of the given date. This function returns a numerical ranging from 1 to 53.

Every year has at least 52 weeks and half of the 53rd week. Hence, the function counts the weeks from 1st of January and the count of week going on until 31st of December. This function returns the numerical value of the week counted from the start of the year.

NOTE: WEEKOFYEAR() function is a synonym to WEEK(date,3) function.

Syntax

Following is the syntax of MySQL WEEKOFYEAR() function −

WEEKOFYEAR(date);

Parameters

This method accepts the date value from which we need to retrieve the week of the year as a parameter.

Return value

This function in MySQL returns the week number for a given date. The week number is an integer value representing the week of the year, ranging from 1 to 53.

Example

In the following example, we are using the MySQL WEEKOFYEAR() function to retrieve the calendar week of the given date −

SELECT WEEKOFYEAR('2019-05-25') As Result;

Output

This will produce the following result −

Result
21

Example

The WEEKOFYEAR() function is equivalent to WEEK(date, 3) −

SELECT WEEK('2021-01-03', 3) As Result;

Output

Following is the output −

Result
53

Example

In the following query, we are retrieving week of the year for the current date (2023-11-20) −

SELECT WEEKOFYEAR(CURDATE()) As Result;

Output

Following is the output −

Result
47

Example

In the following example, let us create a table named ORDERS using CREATE TABLE statement −

CREATE TABLE ORDERS (
   OID INT NOT NULL,
   DATE VARCHAR (20) NOT NULL,
   CUSTOMER_ID INT NOT NULL,
   AMOUNT DECIMAL (18, 2)
);

Now, insert the following records into the ORDERS table using the INSERT statement −

INSERT INTO ORDERS VALUES 
(102, '2009-10-08 00:00:00', 3, 3000.00),
(100, '2009-10-08 00:00:00', 3, 1500.00),
(101, '2009-11-20 00:00:00', 2, 1560.00),
(103, '2008-05-20 00:00:00', 4, 2060.00);

Execute the below query to fetch all the inserted records in the above-created table −

Select * From ORDERS;

Following is the ORDERS table −

OID DATE CUSTOMER_ID AMOUNT
102 2009-10-08 00:00:00 3 3000.00
100 2009-10-08 00:00:00 3 1500.00
101 2009-11-20 00:00:00 2 1560.00
103 2008-05-20 00:00:00 4 2060.00

Now, we use the MySQL WEEKOFYEAR() function to calculate the week number for each date value in the "DATE" column.

Select OID, DATE, WEEKOFYEAR(DATE) As Result From ORDERS;

Output

The output is displayed as follows −

OID DATE Result
102 2009-10-08 00:00:00 41
100 2009-10-08 00:00:00 41
101 2009-11-20 00:00:00 47
103 2008-05-20 00:00:00 21
Advertisements