Add LAST_FISCAL_QUARTER support and related tests

Author: ZackFra

moxygen/main/default/classes/database/MockDatabaseTest.cls

@@ -7281,4 +7281,32 @@ private class MockDatabaseTest {
             'Incorrect number of opportunities'
         );
     }
+
+    @isTest
+    static void ensureLastFiscalQuarterWorksInWhereClause() {
+        List<Opportunity> oppList = new List<Opportunity>();
+        Date startOfThisFiscalQuarter = Gmt.startOfThisFiscalQuarter();
+        for (Integer i = 0; i < 36; i++) {
+            oppList.add(
+                new Opportunity(
+                    Name = 'Opp' + i,
+                    CloseDate = startOfThisFiscalQuarter.addMonths(-i)
+                )
+            );
+        }
+
+        MockDatabase.doInsert(oppList, true);
+
+        Test.startTest();
+        List<Opportunity> opportunities = MockDatabase.query(
+            'SELECT Id, CloseDate FROM Opportunity WHERE CloseDate = LAST_FISCAL_QUARTER'
+        );
+        Test.stopTest();
+
+        Assert.areEqual(
+            3,
+            opportunities.size(),
+            'Incorrect number of opportunities'
+        );
+    }
 }

moxygen/main/default/classes/database/Token.cls

@@ -155,6 +155,7 @@ public with sharing class Token {
     public final static String LAST_N_FISCAL_QUARTERS = 'last_n_fiscal_quarters';
     public final static String NEXT_FISCAL_QUARTER = 'next_fiscal_quarter';
     public final static String NEXT_N_FISCAL_QUARTERS = 'next_n_fiscal_quarters';
+    public final static String LAST_FISCAL_QUARTER = 'last_fiscal_quarter';
 
     public final static Set<String> DATE_LITERAL_TOKENS = new Set<String>{
         TODAY_LITERAL,
@@ -188,6 +189,7 @@ public with sharing class Token {
         N_YEARS_AGO,
         LAST_N_FISCAL_QUARTERS,
         NEXT_FISCAL_QUARTER,
-        NEXT_N_FISCAL_QUARTERS
+        NEXT_N_FISCAL_QUARTERS,
+        LAST_FISCAL_QUARTER
     };
 }

moxygen/main/default/classes/database/soql-engine/interpreter/operator-handler/date-literal-comparable/DateLiteralComparableFactory.cls

@@ -37,7 +37,8 @@ public with sharing class DateLiteralComparableFactory {
         Token.N_YEARS_AGO => NYearsAgoComparable.class,
         Token.LAST_N_FISCAL_QUARTERS => LastNFiscalQuartersComparable.class,
         Token.NEXT_FISCAL_QUARTER => NextFiscalQuarterComparable.class,
-        Token.NEXT_N_FISCAL_QUARTERS => NextNFiscalQuartersComparable.class
+        Token.NEXT_N_FISCAL_QUARTERS => NextNFiscalQuartersComparable.class,
+        Token.LAST_FISCAL_QUARTER => LastFiscalQuarterComparable.class
     };
 
     @TestVisible

moxygen/main/default/classes/database/soql-engine/interpreter/operator-handler/date-literal-comparable/LastFiscalQuarterComparable.cls

@@ -0,0 +1,17 @@
+/**
+ * @description Comparable class for LAST_FISCAL_QUARTER
+ * @author Zackary Frazier
+ * @since 2/2/2025
+ */
+public with sharing class LastFiscalQuarterComparable extends DateLiteralComparable {
+    public override Boolean isLessThan(Datetime fieldValue) {
+        Date startOfThisFiscalQuarter = Gmt.startOfthisFiscalQuarter();
+        Date startOfLastFiscalQuarter = startOfThisFiscalQuarter.addMonths(-3);
+        return fieldValue < startOfLastFiscalQuarter;
+    }
+
+    public override Boolean isGreaterThan(Datetime fieldValue) {
+        Date startOfThisFiscalQuarter = Gmt.startOfThisFiscalQuarter();
+        return fieldValue >= startOfThisFiscalQuarter;
+    }
+}

moxygen/main/default/classes/database/soql-engine/interpreter/operator-handler/date-literal-comparable/LastFiscalQuarterComparable.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>62.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

moxygen/main/default/classes/database/soql-engine/interpreter/operator-handler/date-literal-comparable/LastFiscalQuarterComparableTest.cls

@@ -0,0 +1,44 @@
+@isTest
+private class LastFiscalQuarterComparableTest {
+    @isTest
+    static void ensureIsLessThanWorks() {
+        LastFiscalQuarterComparable dateLiteralComparable = new LastFiscalQuarterComparable();
+        Date startOfThisFiscalQuarter = Gmt.startOfthisFiscalQuarter();
+        Date startOfLastFiscalQuarter = startOfThisFiscalQuarter.addMonths(-3);
+        Date startOfLastFiscalQuarterMinusOneDay = startOfLastFiscalQuarter.addDays(
+            -1
+        );
+        Assert.isTrue(
+            dateLiteralComparable.isLessThan(
+                startOfLastFiscalQuarterMinusOneDay
+            ),
+            'Start of last fiscal quarter minus one day should be less than the last fiscal quarter'
+        );
+
+        Assert.isFalse(
+            dateLiteralComparable.isLessThan(startOfLastFiscalQuarter),
+            'Start of last fiscal quarter should not be less than the last fiscal quarter'
+        );
+    }
+
+    @isTest
+    static void ensureIsGreaterThanWorks() {
+        LastFiscalQuarterComparable dateLiteralComparable = new LastFiscalQuarterComparable();
+        Date startOfThisFiscalQuarter = Gmt.startOfthisFiscalQuarter();
+        Date startOfThisFiscalQuarterMinusOne = startOfThisFiscalQuarter.addDays(
+            -1
+        );
+
+        Assert.isFalse(
+            dateLiteralComparable.isGreaterThan(
+                startOfThisFiscalQuarterMinusOne
+            ),
+            'Start of this fiscal quarter minus one day should not be greater than the last fiscal quarter'
+        );
+
+        Assert.isTrue(
+            dateLiteralComparable.isGreaterThan(startOfThisFiscalQuarter),
+            'Start of this fiscal quarter should be greater than the last fiscal quarter'
+        );
+    }
+}

moxygen/main/default/classes/database/soql-engine/interpreter/operator-handler/date-literal-comparable/LastFiscalQuarterComparableTest.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>62.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

moxygen/main/default/classes/database/soql-engine/parser/ParserTest.cls

@@ -788,4 +788,22 @@ private class ParserTest {
         }
         Test.stopTest();
     }
+
+    @isTest
+    static void ensureLastFiscalQuarterCanBeParsed() {
+        Parser p = new Parser();
+        String soqlQuery = 'SELECT Id FROM Opportunity WHERE CreatedDate = LAST_FISCAL_QUARTER';
+        Test.startTest();
+        try {
+            p.parse(soqlQuery);
+        } catch (Exception e) {
+            Assert.fail(
+                'Expected no exception but got ' +
+                    e.getMessage() +
+                    ' for ' +
+                    soqlQuery
+            );
+        }
+        Test.stopTest();
+    }
 }