[IMP] CF: add new conditional formats for dates

This commit adds the `dateIs/dateIsBefore/dateIsAfter` conditional
formats, as well as the excel export for these.

Note:
The excel export doesn't use Excel's date conditional formats, because
they don't have the same behaviour as ours. We'll use custom formulas
instead.

Example: today is 2025/11/19
- Our date is last month: 2025/10/19 -> 2025/11/18
- Excel's date is last month: 2025/10/01 -> 2025/10/30

Task: 5343283

Author: hokolomopo

packages/o-spreadsheet-engine/src/helpers/locale.ts

@@ -276,6 +276,11 @@ function changeCFRuleLocale(
         case "isLessThan":
         case "isLessOrEqualTo":
         case "customFormula":
+        case "dateIs":
+        case "dateIsBefore":
+        case "dateIsAfter":
+        case "dateIsOnOrAfter":
+        case "dateIsOnOrBefore":
           rule.values = rule.values.map((v) => changeContentLocale(v));
           return rule;
         case "beginsWithText":

packages/o-spreadsheet-engine/src/plugins/ui_core_views/evaluation_conditional_format.ts

@@ -21,6 +21,7 @@ import {
   IconSetRule,
   IconThreshold,
 } from "../../types/conditional_formatting";
+import { EvaluatedCriterion, EvaluatedDateCriterion } from "../../types/generic_criterion";
 import { DEFAULT_LOCALE } from "../../types/locale";
 import { CellPosition, DataBarFill, HeaderIndex, Lazy, Style, UID, Zone } from "../../types/misc";
 import { CoreViewPlugin } from "../core_view_plugin";
@@ -373,9 +374,10 @@ export class EvaluationConditionalFormatPlugin extends CoreViewPlugin {
       return false;
     }
 
-    const evaluatedCriterion = {
+    const evaluatedCriterion: EvaluatedCriterion | EvaluatedDateCriterion = {
       type: rule.operator,
       values: evaluatedCriterionValues.map(toScalar),
+      dateValue: rule.dateValue || "exactDate",
     };
     return evaluator.isValueValid(cell.value ?? "", evaluatedCriterion, this.getters, sheetId);
   }

packages/o-spreadsheet-engine/src/types/conditional_formatting.ts

@@ -1,3 +1,4 @@
+import { DateCriterionValue } from "./generic_criterion";
 import { Style, UID } from "./misc";
 import { Range } from "./range";
 
@@ -54,6 +55,7 @@ export interface CellIsRule extends SingleColorRule {
   operator: ConditionalFormattingOperatorValues;
   // can be one value for all operator except between, then it is 2 values
   values: string[];
+  dateValue?: DateCriterionValue;
 }
 export interface ExpressionRule extends SingleColorRule {
   type: "ExpressionRule";
@@ -154,38 +156,31 @@ export interface Top10Rule extends SingleColorRule {
 }
 //https://docs.microsoft.com/en-us/dotnet/api/documentformat.openxml.spreadsheet.conditionalformattingoperatorvalues?view=openxml-2.8.1
 // Note: IsEmpty and IsNotEmpty does not exist on the specification
-export type ConditionalFormattingOperatorValues =
-  | "beginsWithText"
-  | "isBetween"
-  | "containsText"
-  | "isEmpty"
-  | "isNotEmpty"
-  | "endsWithText"
-  | "isEqual"
-  | "isGreaterThan"
-  | "isGreaterOrEqualTo"
-  | "isLessThan"
-  | "isLessOrEqualTo"
-  | "isNotBetween"
-  | "notContainsText"
-  | "isNotEqual"
-  | "customFormula";
+
+const cfOperators = [
+  "containsText",
+  "notContainsText",
+  "isGreaterThan",
+  "isGreaterOrEqualTo",
+  "isLessThan",
+  "isLessOrEqualTo",
+  "isBetween",
+  "isNotBetween",
+  "beginsWithText",
+  "endsWithText",
+  "isNotEmpty",
+  "isEmpty",
+  "isNotEqual",
+  "isEqual",
+  "customFormula",
+  "dateIs",
+  "dateIsBefore",
+  "dateIsAfter",
+  "dateIsOnOrBefore",
+  "dateIsOnOrAfter",
+] as const;
+
+export type ConditionalFormattingOperatorValues = (typeof cfOperators)[number];
 
 export const availableConditionalFormatOperators: Set<ConditionalFormattingOperatorValues> =
-  new Set([
-    "containsText",
-    "notContainsText",
-    "isGreaterThan",
-    "isGreaterOrEqualTo",
-    "isLessThan",
-    "isLessOrEqualTo",
-    "isBetween",
-    "isNotBetween",
-    "beginsWithText",
-    "endsWithText",
-    "isNotEmpty",
-    "isEmpty",
-    "isNotEqual",
-    "isEqual",
-    "customFormula",
-  ]);
+  new Set(cfOperators);

packages/o-spreadsheet-engine/src/xlsx/functions/conditional_formatting.ts

@@ -1,4 +1,5 @@
 import { ICON_SETS, IconSetType } from "../../components/icons/icons";
+import { parseLiteral } from "../../helpers/cells/cell_evaluation";
 import { colorNumberToHex } from "../../helpers/color";
 import {
   CellIsRule,
@@ -12,6 +13,7 @@ import {
   IconThreshold,
   ThresholdType,
 } from "../../types/conditional_formatting";
+import { DEFAULT_LOCALE } from "../../types/locale";
 import { ExcelIconSet, XLSXDxf, XMLAttributes, XMLString } from "../../types/xlsx";
 import { XLSX_ICONSET_MAP } from "../constants";
 import { toXlsxHexColor } from "../helpers/colors";
@@ -116,6 +118,50 @@ function cellRuleFormula(ranges: string[], rule: CellIsRule): string[] {
     case "isBetween":
     case "isNotBetween":
       return [values[0], values[1]];
+    case "dateIs":
+      switch (rule.dateValue || "exactDate") {
+        case "exactDate": {
+          const value = values[0].startsWith("=")
+            ? values[0].slice(1)
+            : (parseLiteral(values[0], DEFAULT_LOCALE) || "").toString();
+          const roundedValue = `ROUNDDOWN(${value},0)`;
+          return [`AND(${firstCell}>=${roundedValue},${firstCell}<${roundedValue}+1)`];
+        }
+        case "today":
+          return [`AND(${firstCell}>=TODAY(),${firstCell}<TODAY()+1)`];
+        case "yesterday":
+          return [`AND(${firstCell}>=TODAY()-1,${firstCell}<TODAY())`];
+        case "tomorrow":
+          return [`AND(${firstCell}>=TODAY()+1,${firstCell}<TODAY()+2)`];
+        case "lastWeek":
+          return [`AND(${firstCell}>=TODAY()-7,${firstCell}<TODAY())`];
+        case "lastMonth":
+          return [`AND(${firstCell}>=EDATE(TODAY(),-1),${firstCell}<TODAY())`];
+        case "lastYear":
+          return [`AND(${firstCell}>=EDATE(TODAY(),-12),${firstCell}<TODAY())`];
+      }
+    case "dateIsBefore":
+    case "dateIsAfter":
+    case "dateIsOnOrAfter":
+    case "dateIsOnOrBefore":
+      switch (rule.dateValue || "exactDate") {
+        case "exactDate":
+          return values[0].startsWith("=")
+            ? [values[0].slice(1)]
+            : [(parseLiteral(values[0], DEFAULT_LOCALE) || "").toString()];
+        case "today":
+          return ["TODAY()"];
+        case "yesterday":
+          return ["TODAY()-1"];
+        case "tomorrow":
+          return ["TODAY()+1"];
+        case "lastWeek":
+          return ["TODAY()-7"];
+        case "lastMonth":
+          return ["EDATE(TODAY(),-1)"];
+        case "lastYear":
+          return ["EDATE(TODAY(),-12)"];
+      }
   }
 }
 
@@ -141,7 +187,12 @@ function cellRuleTypeAttributes(rule: CellIsRule): XMLAttributes {
     case "isLessOrEqualTo":
     case "isBetween":
     case "isNotBetween":
+    case "dateIsBefore":
+    case "dateIsAfter":
+    case "dateIsOnOrAfter":
+    case "dateIsOnOrBefore":
       return [["type", "cellIs"]];
+    case "dateIs":
     case "customFormula":
       return [["type", "expression"]];
   }

packages/o-spreadsheet-engine/src/xlsx/helpers/content_helpers.ts

@@ -72,6 +72,16 @@ export function convertOperator(operator: ConditionalFormattingOperatorValues):
       return "notEqual";
     case "customFormula":
       return "";
+    case "dateIs":
+      return "";
+    case "dateIsBefore":
+      return "lessThan";
+    case "dateIsAfter":
+      return "greaterThan";
+    case "dateIsOnOrAfter":
+      return "greaterThanOrEqual";
+    case "dateIsOnOrBefore":
+      return "lessThanOrEqual";
   }
 }
 

src/components/side_panel/conditional_formatting/cf_editor/cf_editor.ts

@@ -26,6 +26,7 @@ import {
   ConditionalFormattingOperatorValues,
   DataBarRule,
   GenericCriterion,
+  GenericDateCriterion,
   IconSetRule,
   IconThreshold,
   ThresholdType,
@@ -328,6 +329,9 @@ export class ConditionalFormattingEditor extends Component<Props, SpreadsheetChi
 
   editOperator(operator: ConditionalFormattingOperatorValues) {
     this.state.rules.cellIs.operator = operator;
+    if (operator.includes("date") && !this.state.rules.cellIs.dateValue) {
+      this.state.rules.cellIs.dateValue = "exactDate";
+    }
     this.updateConditionalFormat({ rule: this.state.rules.cellIs, suppressErrors: true });
     this.closeMenus();
   }
@@ -347,16 +351,20 @@ export class ConditionalFormattingEditor extends Component<Props, SpreadsheetChi
     return criterionComponentRegistry.get(this.state.rules.cellIs.operator).component;
   }
 
-  get genericCriterion(): GenericCriterion {
+  get genericCriterion(): GenericDateCriterion | GenericCriterion {
     return {
       type: this.state.rules.cellIs.operator,
       values: this.state.rules.cellIs.values,
+      dateValue: this.state.rules.cellIs.dateValue,
     };
   }
 
   onRuleValuesChanged(rule: CellIsRule) {
     this.state.rules.cellIs.values = rule.values;
-    this.updateConditionalFormat({ rule: { ...this.state.rules.cellIs, values: rule.values } });
+    this.state.rules.cellIs.dateValue = rule.dateValue;
+    this.updateConditionalFormat({
+      rule: { ...this.state.rules.cellIs, values: rule.values, dateValue: rule.dateValue },
+    });
   }
 
   /*****************************************************************************

tests/conditional_formatting/conditional_formatting_panel_component.test.ts

@@ -277,6 +277,28 @@ describe("UI of conditional formats", () => {
       });
     });
 
+    test("can edit a date CellIsRule", async () => {
+      await click(fixture.querySelectorAll(selectors.listPreview)[0]);
+      await nextTick();
+
+      await changeRuleOperatorType(fixture, "dateIs");
+      expect(".o-composer").toHaveClass("active");
+      editStandaloneComposer(selectors.ruleEditor.editor.valueInput, "10/10/2025");
+
+      await click(fixture, selectors.ruleEditor.editor.bold);
+      await click(fixture, selectors.buttonSave);
+
+      const sheetId = model.getters.getActiveSheetId();
+      const cf = model.getters.getConditionalFormats(sheetId).find((c) => c.id === "1");
+      expect(cf?.rule).toEqual({
+        operator: "dateIs",
+        dateValue: "exactDate",
+        style: { bold: true, fillColor: "#FF0000" },
+        type: "CellIsRule",
+        values: ["10/10/2025"],
+      });
+    });
+
     test("Can cycle on reference (with F4) in a CellIsRule editor input", async () => {
       await click(fixture.querySelectorAll(selectors.listPreview)[0]);
       await changeRuleOperatorType(fixture, "beginsWithText");