如何使用 Sequelize 查询创建时间距今一年后的记录

本文介绍如何在 sequelize 中正确查询 `createddate` 字段值为当前日期一年之后的数据库记录，重点解决因日期构造错误导致的查询失败问题，并提供可直接使用的代码示例与关键注意事项。

在使用 Sequelize 进行时间范围查询时，一个常见误区是误将“一年后”理解为“今年某月某日”，而实际需求往往是从当前时刻起算，向未来推移一整年（例如：现在是 2025-07-19 14:30:00，则一年后是 2025-07-19 14:30:00）。你提供的原始代码：

[Op.gte]: new Date(new Date().getFullYear(), 1)

存在两个关键问题：

• new Date(year, month) 构造的是 当年 2 月 1 日（month 从 0 开始，1 表示二月）的午夜时间，而非“当前时间 + 1 年”；
• 它未考虑日、时、分、秒，导致逻辑完全偏离预期（如匹配所有 2025 年 2 月 1 日之后的记录）。

✅ 正确做法是基于当前时间动态计算“一年后”的精确时间点：

const now = new Date();
const oneYearLater = new Date(now);
oneYearLater.setFullYear(now.getFullYear() + 1);

// 在 Sequelize 查询中使用
return this.findAll({
  where: {
    createdDate: {
      [Op.gte]: oneYearLater
    }
  }
});

? 重要注意事项：

• setFullYear() 会自动处理闰年（如 2025-02-29 → 2025-02-28），比手动拼接字符串或使用 getTime() + 365*24*60*60*1000 更可靠；

• 若需查询“创建时间在一年后至今之间”的记录（即未来 1 年内即将到期的记录），应改用 [Op.between]：

  const now = new Date();
  const oneYearLater = new Date(now);
  oneYearLater.setFullYear(now.getFullYear() + 1);
  
  where: {
    createdDate: {
      [Op.between]: [now, oneYearLater]
    }
  }

• 确保数据库中 createdDate 字段类型为 DATE 或 DATETIME，且 Sequelize 模型中已正确定义为 DataTypes.DATE，否则可能引发类型转换异常。

? 总结：时间查询的核心是“语义准确 + 构造安全”。永远优先基于 new Date() 实例做增量修改（如 setFullYear），避免硬编码月份/日期，才能确保跨年、闰年、时区等场景下的健壮性。