Looker Studio Function: Looker Studio Week Complete Guide with Examples : Use case

Category: DATE function

The WEEK() function in Looker Studio is used to extract the week number of the year from a given date field. It is especially helpful when analyzing time-based performance patterns, comparing week-over-week growth, monitoring seasonal behaviors, and segmenting data into weekly reporting cycles.

Purpose of the Week Function 

1. Weekly Reporting & Analysis

The WEEK() function allows you to categorize data by week number, simplifying dashboards that focus on weekly KPIs such as sales, leads, or website sessions.

2. Performance Comparison

It helps compare results week-over-week (WoW), enabling analysts to identify growth, decline, or stability over time.

3. Trend Forecasting

Weekly segmentation reveals patterns such as busy weeks, marketing impact weeks, seasonal spikes, or recurring slowdowns

Type of Calculation & Practical Use Cases

✅ Week-over-Week Performance Monitoring

Track changes in metrics such as revenue, conversions, or user engagement across weeks.

✅ Sales Cycle Tracking

Useful for evaluating weekly sales achievements compared to a target or forecast.

✅ Behavior Segmentation

Group customers by the week of signup, purchase, or activity to identify behavioral cohorts. to show only today’s records.

✅ Campaign Performance

Measure campaign results based on weekly reporting windows instead of monthly or quarterly cycles.

				
					WEEK(date_expression)

				
			
ParameterTypeDescription
date_expressionDateThe date field from which to extract the week number
  

How Does the Week Function Work?

The WEEK() function reads any valid date value and returns a number from 1 to 53, representing the week of the year. The calculation follows the calendar system and updates as the year progresses, enabling consistent time-based grouping.

For example, if a date falls in the second week of January, WEEK() returns 2 automatically.

When should use the Week Function Work?

Use WEEK() when analyzing data that is required at weekly granularity:

  • Week-to-week comparison dashboards

  • Weekly funnel or sales pipelines

  • Weekly project or operational reporting

  • Campaign analysis by week

  • Time-series charts grouped weekly

Example of  Week()  with Result

Example 1: Basic Usage

WEEK(Transaction_Date)
Transaction_DateResult
2025-01-051
2025-02-147
2025-12-3153

Example 2: Calculate Week-Over-Week Growth

Revenue WoW Growth = (SUM(Revenue) - LAG(SUM(Revenue), 1, WEEK(Transaction_Date))) / LAG(SUM(Revenue), 1, WEEK(Transaction_Date))

Example 3: Group Data by Week in Charts

Use WEEK(Date) as the dimension and SUM(Revenue) as the metric to create a weekly revenue trend graph.

Example 4: Customer Cohort Segmentation

CASE WHEN WEEK(Signup_Date) = WEEK(TODAY()) THEN "Joined This Week" ELSE "Previous Users" END

Tips & Best Practices

  • Combine WEEK() with YEAR() to avoid mixing weeks from different years.

  • Use WEEK() with TODAY() to dynamically filter recent weekly reports.

  • For retail analytics, compare week numbers across years for seasonal patterns.

  • Pair with DATE_DIFF() for accurate week-based interval calculations.

1. What is the purpose of the WEEK() function?

The WEEK() function extracts the week number of the year from a date column, enabling weekly grouping and analysis.

2. Can I use WEEK() with non-date values?

No. Convert fields using PARSE_DATE() or CAST() before using WEEK() if the original field is text.

3. Does the WEEK() function consider timezone?

Yes. It uses the timezone defined in the data source or report settings.

4. Is WEEK() useful for trend analysis?

Absolutely — it helps track performance patterns and compare data week over week.

5. Can WEEK() be used in time-series charts?

Yes. WEEK(Date) is commonly used as a dimension for charts requiring weekly visual insights.

Established in 2020, Lets Viz Technologies provides a full range of high-quality data analysis and data visualization services. We are also an authorized Zoho Partner.

 

Contact

WeWork Berger Delhi One, C-001/A2, Sector 16B, Noida, Uttar Pradesh 201301

0124-502-5592
info@lets-viz.com

We are Social

Trust Pilot Reviews