JavaScript Temporal.PlainDate 怎么处理生日和日期区间：时区无关、比较与序列化

用户资料里的生日、合同账期和“某天是否到期”，本质上都不是一个带时区的瞬间。用 new Date('2000-08-24') 处理它们，页面一换时区就可能显示成前一天。Temporal.PlainDate 把“日历上的一天”单独建模，比较、加减和序列化都不会偷偷引入本地时区。

先把“日期”与“时刻”分开

Date 保存的是时间线上的一个瞬间；生日“2000-08-24”没有出生时刻，也没有“按哪个城市的午夜”这个问题。PlainDate 只携带日历日期，因此在北京、东京或洛杉矶展示时仍是同一天。

这个区分很适合三类字段：用户生日、按自然日计算的试用截止日、以及账单中的结算日。反过来，支付成功时间、日志时间和会议开始时间不能用 PlainDate 代替。

用 from() 读取生日和接口日期

生产代码更适合使用 Temporal.PlainDate.from()，因为它能接受 ISO 字符串或年月日对象。解析后可以立即检查输入是否是一个真实日期：

const birthday = Temporal.PlainDate.from('2000-08-24');
const renewalDate = Temporal.PlainDate.from({
  year: 2026,
  month: 9,
  day: 1
});

console.log(birthday.toString());     // 2000-08-24
console.log(renewalDate.toString()); // 2026-09-01

无效日期会抛出 RangeError，例如 2026 年 2 月 30 日。表单层可以把这个异常转换成“请输入有效日期”，不要把错误值悄悄改成下个月。

比较日期时使用 compare()，不要比较格式化文本

ISO 日期字符串在统一格式下可以按字典序比较，但业务代码里直接写字符串比较很容易在输入格式变化后失效。Temporal.PlainDate.compare() 明确表达了排序意图：

const start = Temporal.PlainDate.from('2026-09-01');
const end = Temporal.PlainDate.from('2026-09-30');
const today = Temporal.PlainDate.from('2026-09-12');

const inRange = Temporal.PlainDate.compare(today, start) >= 0
  && Temporal.PlainDate.compare(today, end) 

compare(a, b) 返回负数、零或正数，正好可以传给 sort()。区间是否包含首尾，则由业务规则决定，代码中最好保留清晰的边界判断。

按自然日加减，并核对月份边界

生日提前 7 天提醒、账期顺延一个月，都属于日历运算。PlainDate 的实例不可变，add() 会返回新日期，不会改掉原变量：

const due = Temporal.PlainDate.from('2026-01-31');
const nextMonth = due.add({ months: 1 });
const reminder = due.subtract({ days: 7 });

console.log(due.toString());       // 2026-01-31
console.log(nextMonth.toString()); // 2026-02-28
console.log(reminder.toString());  // 2026-01-24

月底加月不是简单地把 month 加一。遇到目标月没有同一天时，默认溢出策略会把结果收敛到有效日期；如果合同要求“超出月底就报错”，应在输入和结果之间增加明确的业务校验，不要把默认规则当成合同规则。

序列化、区间长度与时区转换的边界

接口和数据库通常保存 YYYY-MM-DD。使用 toString() 或 toJSON() 可以得到稳定文本；再次读取时仍用 from()，避免把日期误当成带时间的 ISO 时间戳。

const from = Temporal.PlainDate.from('2026-09-01');
const to = Temporal.PlainDate.from('2026-09-30');

console.log(from.toJSON());
console.log(from.until(to).days); // 29

const payload = JSON.stringify({ birthday: from });
console.log(payload); // {"birthday":"2026-09-01"}

如果业务下一步要表达“这一天的上午 9 点（上海）”，先组合 PlainDate 和 PlainTime，再转换为 ZonedDateTime。不能用浏览器本地时区直接补一个午夜，因为那会把“日期字段”变成依赖设备位置的瞬间。

兼容旧浏览器时保留 Date 的降级路径

Temporal 仍应按目标浏览器的实际支持情况验收。能力检测通过后使用原生实现，否则加载经过审核的 polyfill；降级实现也要保持“日期字符串不加时区”的约定。

function parseCalendarDate(value) {
  if (globalThis.Temporal?.PlainDate) {
    return Temporal.PlainDate.from(value);
  }
  // 旧环境走项目已审核的日期库，不在这里用 new Date(value) 猜时区。
  return legacyCalendarDate.parse(value);
}

验收时至少覆盖 2 月末、跨年、无效日期、不同系统时区和接口往返五组样例。浏览器控制台若出现 Temporal is not defined，先确认 polyfill 加载时机，再检查打包产物是否把它排除。

常见问题

生日字段应该存 Date 还是 PlainDate？

只需要年月日时优先保存 PlainDate 的 ISO 文本；只有出生时刻本身是业务数据时，才保存带时区的时间类型。

PlainDate 能直接计算两个日期相差几天吗？

可以，用 start.until(end).days 得到日期差；如果还要处理具体时刻或夏令时，应改用带时区的类型。

为什么不直接把日期字符串传给 Date？

Date 会把它解释成时间线上的值，显示时再受本地时区影响。PlainDate 能让接口字段始终保持日历日期语义。

落地前的检查清单

• 字段是否真的只需要年月日？若是，使用 PlainDate。
• 解析是否通过 from() 且能拒绝无效日期？
• 比较、加减和区间首尾规则是否写成了可测试的代码？
• 序列化后是否保持 YYYY-MM-DD，没有偷偷追加时分秒或时区？
• 目标浏览器不支持 Temporal 时，polyfill 或旧库是否已经覆盖同样的边界？