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)
| Parameter | Type | Description |
|---|---|---|
| date_expression | Date | The 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_Date | Result |
|---|---|
| 2025-01-05 | 1 |
| 2025-02-14 | 7 |
| 2025-12-31 | 53 |
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" ENDTips & 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.
The WEEK() function extracts the week number of the year from a date column, enabling weekly grouping and analysis.
No. Convert fields using PARSE_DATE() or CAST() before using WEEK() if the original field is text.
Yes. It uses the timezone defined in the data source or report settings.
Absolutely — it helps track performance patterns and compare data week over week.
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.
Sitelinks
