Why Date expressions ($year, $month, $dayOfMonth) in MongoDB? - Purpose & Use Cases

The Big Idea

What if you could instantly pull out the year or month from any date in your data with just one simple command?

The Scenario

Imagine you have a big list of events with full timestamps, and you want to find out how many happened in a specific year or month. Doing this by hand means opening each event, reading the date, and writing down the year or month separately.

The Problem

Manually checking each date is slow and tiring. It's easy to make mistakes, like mixing up months or forgetting leap years. Also, if you have thousands of events, this becomes impossible to do quickly or accurately.

The Solution

Date expressions like $year, $month, and $dayOfMonth let you automatically pull out parts of a date inside your database queries. This means you can quickly group, filter, or sort events by year, month, or day without extra work.

Before vs After

✗ Before

for event in events:
    year = extract_year_manually(event.date)
    if year == 2023:
        count += 1

✓ After

db.events.aggregate([
  { $match: { $expr: { $eq: [{ $year: "$date" }, 2023] } } }
])

What It Enables

You can instantly analyze and organize your data by any part of the date, making time-based insights easy and fast.

Real Life Example

A store owner wants to see how many sales happened each month this year. Using $month, they can group sales by month and spot busy or slow times without manual counting.

Key Takeaways

Manually extracting date parts is slow and error-prone.

$year, $month, and $dayOfMonth automate date part extraction inside queries.

This makes filtering and grouping by date fast and reliable.

Practice

1. What does the MongoDB expression {$year: "$dateField"} return when used in an aggregation pipeline?

easy

A. The month number of the date

B. The year part of the date stored in dateField

C. The full date as a string

D. The day of the week of the date

Solution

1. Step 1: Understand the $year operator

   The $year expression extracts the year component from a date value.

2. Step 2: Apply to the field dateField

   Using {$year: "$dateField"} returns the year number from the date stored in dateField.

3. Final Answer:

   The year part of the date stored in dateField -> Option B

4. Quick Check:

   $year extracts year [OK]

Hint: Remember $year extracts only the year number from a date [OK]

Common Mistakes:

• Confusing $year with $month or $dayOfMonth
• Expecting a full date string instead of just the year
• Using $year outside aggregation pipeline

2. Which of the following is the correct syntax to extract the month from a date field named createdAt in a MongoDB aggregation pipeline?

easy

A. { $month: "$createdAt" }

B. { $month: createdAt }

C. { month: "$createdAt" }

D. { $month: "createdAt" }

Solution

1. Step 1: Identify correct field reference syntax

   In MongoDB aggregation, field names must be referenced as strings with a $ prefix, like "$createdAt".

2. Step 2: Confirm correct operator usage

   The operator to extract month is $month, so the correct syntax is { $month: "$createdAt" }.

3. Final Answer:

   { $month: "$createdAt" } -> Option A

4. Quick Check:

   Field names need "$" prefix in aggregation [OK]

Hint: Use "$fieldName" to reference fields inside aggregation [OK]

Common Mistakes:

• Omitting quotes and $ prefix around field name
• Using operator without $ sign
• Passing field name as plain string without $

3. Given the following aggregation stage, what will be the output for a document with dateField value of ISODate("2023-07-15T10:00:00Z")?

{ $project: { year: { $year: "$dateField" }, month: { $month: "$dateField" }, day: { $dayOfMonth: "$dateField" } } }

medium

A. { year: 2023, month: 7, day: 14 }

B. { year: 2023, month: 6, day: 15 }

C. { year: 2023, month: 7, day: 15 }

D. { year: 2022, month: 7, day: 15 }

Solution

1. Step 1: Extract year, month, and day from the date

   The date is July 15, 2023. So, year = 2023, month = 7 (July), day = 15.

2. Step 2: Confirm output matches extracted values

   The output document will have year: 2023, month: 7, day: 15 as projected.

3. Final Answer:

   { year: 2023, month: 7, day: 15 } -> Option C

4. Quick Check:

   Date parts match output [OK]

Hint: Remember months are 1-based in MongoDB date expressions [OK]

Common Mistakes:

• Assuming months start at 0 instead of 1
• Confusing dayOfMonth with dayOfWeek
• Misreading the date value

4. You wrote this aggregation stage to get the day of the month from orderDate:

{ $project: { day: { $dayOfMonth: orderDate } } }

But it throws an error. What is the mistake?

medium

A. Missing quotes and $ before field name in $dayOfMonth

B. Using $project instead of $match

C. Field orderDate is not a date type

D. Incorrect operator; should use $day instead

Solution

1. Step 1: Check field reference syntax inside $dayOfMonth

   Field names must be referenced as strings with a $ prefix, so it should be "$orderDate".

2. Step 2: Identify the cause of error

   Using orderDate without quotes and $ causes a syntax error in aggregation.

3. Final Answer:

   Missing quotes and $ before field name in $dayOfMonth -> Option A

4. Quick Check:

   Field names need "$" prefix in aggregation [OK]

Hint: Always use "$fieldName" inside aggregation expressions [OK]

Common Mistakes:

• Forgetting $ and quotes around field names
• Assuming $day is a valid operator
• Confusing aggregation stages

5. You want to group sales documents by the year and month of their saleDate field. Which aggregation pipeline stage correctly groups by year and month using date expressions?

hard

A. { $group: { _id: { year: { $year: "$saleDate" }, month: "$month" }, totalSales: { $sum: "$amount" } } }

B. { $group: { _id: { year: "$year", month: "$month" }, totalSales: { $sum: "$amount" } } }

C. { $group: { _id: { year: { $year: saleDate }, month: { $month: saleDate } }, totalSales: { $sum: "$amount" } } }

D. { $group: { _id: { year: { $year: "$saleDate" }, month: { $month: "$saleDate" } }, totalSales: { $sum: "$amount" } } }

Solution

1. Step 1: Use correct field references with $year and $month

   Field names must be referenced as strings with $ prefix, so "$saleDate" is correct.

2. Step 2: Verify grouping keys and sum operator

   Grouping by year and month extracted from saleDate and summing amount is done correctly in { $group: { _id: { year: { $year: "$saleDate" }, month: { $month: "$saleDate" } }, totalSales: { $sum: "$amount" } } }.

3. Final Answer:

   { $group: { _id: { year: { $year: "$saleDate" }, month: { $month: "$saleDate" } }, totalSales: { $sum: "$amount" } } } -> Option D

4. Quick Check:

   Correct field references and operators used [OK]

Hint: Group by {_id: {year: {$year: "$field"}, month: {$month: "$field"}}} [OK]

Common Mistakes:

• Using field names without $ and quotes
• Mixing string field names with expressions
• Incorrectly mixing aggregation operators