$year (Get Year)

Last updated: 2026-10-09

$year (Get Year)

$year returns the full year of a date (e.g. 2026) — the most basic date extractor. It often combines with $month or $week into multi-level group keys, or serves yearly archiving and year-over-year analysis. Returns an integer. Note the difference from $isoWeekYear, which returns the ISO week's year and can differ in straddling weeks — prefer it for week-based stats.

📝 Syntax

{ $year: { date: <date-expression>, timezone: <timezone> } }

⚙️ Parameters

Returns：The year as an integer; null if date is null.

▶ Example

Run the commands below in your local mongosh (requires a running mongod):

// $year: order totals by year
 db.orders.aggregate([
  { $group: {
      _id: { $year: { date: '$orderDate' } },
      total: { $sum: '$amount' }
  } }
])

Output：

{ "_id": 2026, "total": 892000 }
{ "_id": 2025, "total": 764000 }

📌 Notes

• Returns the full four-digit year
• Records with null date land in a null bucket when grouping
• Use $isoWeekYear, not $year, for straddling-week stats

🏷️ Related Tags

💡 Related Cases

📚 Related Tutorials

❓ FAQ

Web-Tutorial Tech Team

A team of developers maintaining programming tutorials. Each tutorial is written and reviewed by developers with expertise in that field. We work to keep our content accurate and reliable — if you spot an issue, please let us know.

About Us