17370845950

本文介绍如何在 sequelize 中正确查询 `createddate` 字段值早于当前日期一年的记录，重点解决因日期计算错误导致查询结果不准确的问题，并提供可直接使用的代码示例与关键注意事项。

在使用 Sequelize 进行时间范围查询时，一个常见误区是误将“一年后”理解为筛选条件，而实际业务需求往往是：获取创建时间超过一年（即早于当前时间减去 12 个月）的记录。例如，当前时间为 2025-07-19，则需查出 createdDate ≤ 2025-07-19 的数据。

你提供的尝试代码存在两个关键问题：

[Op.gte]: new Date(new Date().getFullYear(), 1) // ❌ 错误：生成的是今年 2 月 1 日，且未考虑月份/日期偏移

• new Date(year, month) 中 month 是从 0 开始计数（1 表示 2 月），因此 new Date(2025, 1) 实际为 2025-02-01；
• 更严重的是，该写法完全未体现「一年前」的语义，反而容易被误解为「今年某月之后」。

✅ 正确做法是：计算「当前时间减去一整年」作为时间下界，再用 [Op.lte] 筛选早于此时间的记录（注意：不是 gte，也不是“一年后”）。

以下是推荐实现方式（兼容 Node.js 原生 Date 和时区安全场景）：

const { Op } = require('sequelize');

// ✅ 安全计算「一年前的此刻」
const oneYearAgo = new Date();
oneYearAgo.setFullYear(oneYearAgo.getFullYear() - 1);

// 查询 createdDate ≤ 一年前的记录（即已满一年）
return this.findAll({
  where: {
    createdDate: {
      [Op.lte]: oneYearAgo
    }
  }
});

⚠️ 注意事项：

• setFullYear() 会自动处理闰年（如 2025-02-29 → 2025-02-28），比手动拼接字符串或毫秒运算更可靠；
• 若数据库存储的 createdDate 为 UTC 时间，而应用运行在非 UTC 时区，请确保 Node.js 进程时区一致（可通过 process.env.TZ = 'UTC' 统一），或改用 Sequelize.fn('DATE_SUB', ...) 在 SQL 层计算（适用于 MySQL）；
• 避免使用 Date.now() - 365 * 24 * 60 * 60 * 1000：该方式按固定 365 天计算，忽略闰年与夏令时，长期运行可能导致偏差。

? 扩展建议：如需更高精度（如精确到“12个日历月”，而非365天），可使用 date-fns 库：

npm install date-fns

import { subYears } from 'date-fns';
const oneYearAgo = subYears(new Date(), 1);

综上，核心逻辑始终是：明确业务语义 → 正确构造时间边界 → 使用匹配的 Sequelize 操作符（[Op.lte]）→ 验证时区与精度需求。