React Awesome Query Builder 中日期比较问题的解决方案

背景介绍

在使用 React Awesome Query Builder 构建查询规则时，开发者经常会遇到日期比较的问题。特别是在使用 JSON 逻辑表达式时，如何正确比较日期值成为一个常见的技术难点。

问题分析

当开发者尝试在 JSON 逻辑表达式中使用日期函数进行比较时，经常会遇到比较结果不符合预期的情况。例如，以下表达式：

[{"==":[{"var":"custRecord"},{"date_add":[{"now":[]},1,"day"]}]}]

配合数据：

{"custRecord": {"date_add":[{"now":[]},1,"day"]}}

这种比较方式会始终返回 false，因为直接比较函数对象本身而不是函数执行结果。

正确使用方法

1. 数据格式规范

在 JSON 逻辑的数据部分，应该使用原始日期值而不是函数表达式。正确的数据格式应该是：

{"custRecord": new Date("2025-05-16")}

2. 日期比较运算符

在最新版本中，React Awesome Query Builder 添加了专门的日期比较运算符来解决这个问题：

• date== 和 date!=：用于日期(Date)类型的比较
• datetime== 和 datetime!=：用于日期时间(DateTime)类型的比较

这些运算符应该替代标准的 == 和 != 运算符来比较日期值。

3. 配置设置

从版本 6.6.15 开始，可以通过设置 fixJsonLogicDateCompareOp: true 来启用日期比较的修复功能。这个设置将默认启用，但在当前版本中需要显式配置以避免破坏性变更。

4. 自定义运算符

如果使用自定义的 json-logic-js 实现，可以通过以下方式添加必要的日期比较运算符：

import JL from 'json-logic-js';
Utils.JsonLogicUtils.addRequiredJsonLogicOperations(JL);

版本更新说明

在即将发布的 6.6.15 版本中，日期和时间函数将进行重构，提供更直观的函数名称：

• NOW：用于获取当前日期时间
• TODAY：用于获取当前日期
• RELATIVE_DATETIME：用于计算相对日期时间
• RELATIVE_DATE：用于计算相对日期

最佳实践建议

1. 始终在数据部分使用具体的日期值，而不是函数表达式
2. 比较日期时使用专门的日期比较运算符
3. 升级到最新版本以获取更好的日期处理功能
4. 对于复杂的日期计算，考虑在应用层预处理数据

通过遵循这些指导原则，开发者可以避免常见的日期比较问题，构建出更加可靠和准确的查询规则。