{"id":12581,"date":"2026-03-25T06:24:41","date_gmt":"2026-03-25T06:24:41","guid":{"rendered":"https:\/\/www.greytrix.com\/blogs\/salesforce\/?p=12581"},"modified":"2026-03-23T09:52:50","modified_gmt":"2026-03-23T09:52:50","slug":"yyyy-vs-yyyy-in-salesforce-apex-understanding-the-critical-date-formatting-difference","status":"publish","type":"post","link":"https:\/\/www.greytrix.com\/blogs\/salesforce\/2026\/03\/25\/yyyy-vs-yyyy-in-salesforce-apex-understanding-the-critical-date-formatting-difference\/","title":{"rendered":"YYYY vs yyyy in Salesforce Apex: Understanding the Critical Date Formatting Difference"},"content":{"rendered":"\n

When working with date formatting in Salesforce Apex, developers often rely on formatting patterns to convert dates into readable strings for integrations, reports, or document generation.<\/p>\n\n\n\n

At first glance, the patterns YYYY and yyyy appear identical. However, they represent two different concepts of a year, and using the wrong one can produce unexpected results.<\/p>\n\n\n\n

This difference becomes especially noticeable around the start and end of a year, where a formatted date may unexpectedly display the wrong year value. Understanding this behavior can help developers avoid subtle bugs in Salesforce integrations, automation, and reporting processes.
<\/p>\n\n\n\n

How Date Formatting Works in Apex<\/mark><\/strong><\/h2>\n\n\n\n

In Salesforce Apex, Date and Datetime values can be formatted using the format() method. The formatting patterns follow the same conventions as Java\u2019s SimpleDateFormat<\/strong>.<\/p>\n\n\n\n

Example<\/strong><\/p>\n\n\n\n

Datetime dt = Datetime.newInstance(2024, 12, 31, 0, 0, 0);
String formatted = dt.format(‘yyyy-MM-dd’);
System.debug(formatted);<\/p>\n\n\n\n

Output<\/strong><\/p>\n\n\n\n

2024-12-31<\/p>\n\n\n\n

This works as expected because yyyy represents the calendar year, which is what most applications and business logic rely on.<\/p>\n\n\n\n

What Does yyyy Represent?<\/mark><\/strong><\/h2>\n\n\n\n

The yyyy <\/strong>pattern refers to the standard calendar year. This is the year value we normally expect when working with dates.<\/p>\n\n\n\n

Example<\/strong><\/p>\n\n\n\n

Datetime dt = Datetime.newInstance(2018, 12, 31, 0, 0, 0);
System.debug(dt.format(‘yyyy-MM-dd’));<\/p>\n\n\n\n

Output<\/strong><\/p>\n\n\n\n

2018-12-31<\/p>\n\n\n\n

Here, the formatted result correctly reflects that the date belongs to the year 2018.<\/p>\n\n\n\n

In most Salesforce implementations<\/strong>, such as:<\/p>\n\n\n\n