使用date-fns的isSameWeek时parseISO的使用及本地化问题

问题根源拆解 #

• 写法一的无效日期问题：parseISO仅接受ISO 8601标准格式的字符串作为入参，你传入new Date("2023-02-05")时，会先把Date对象转为带时区的非标准字符串，parseISO无法识别这种格式，直接返回无效日期。
• 写法二的本地化误解：parseISO的作用只是将ISO字符串解析为Date对象，本地化配置不影响解析结果。你看到的"不符合本地化"是Date对象默认toString()的输出，和parseISO无关——本地化是用来处理周计算规则、日期显示格式的，不属于解析阶段的配置。
• 隐藏坑：Beta v2版本中isSameWeek的locale参数不能传字符串（如"en-GB"），必须传入date-fns官方提供的locale对象，否则本地化规则完全不生效。

正确实现代码 #

// 导入所需工具函数和对应locale
import { isSameWeek, parseISO, format } from 'date-fns';
import enGB from 'date-fns/locale/en-GB';

// 直接传入ISO格式字符串给parseISO，这是唯一正确的用法
const date1 = parseISO("2023-02-05");
const date2 = parseISO("2023-02-06");

// 传入正确的locale对象，配置周起始规则
const isSameWk = isSameWeek(date1, date2, { 
  weekStartsOn: 0, 
  locale: enGB 
});

// 若要按en-GB本地化显示日期，使用format函数配合locale
console.log(format(date1, 'yyyy-MM-dd EEEE', { locale: enGB })); // 输出：2023-02-05 Sunday

关键注意事项 #

• 禁止给parseISO传入Date对象，仅使用标准ISO字符串（如YYYY-MM-DD、YYYY-MM-DDTHH:mm:ss），避免环境解析差异。
• 本地化配置必须通过导入locale对象实现，字符串标识仅在旧版date-fns中生效。
• Beta v2要求用parseISO解析日期，核心是规避原生Date构造函数在不同环境下的解析不一致问题（比如部分浏览器会把YYYY-MM-DD解析为UTC时间）。

内容的提问来源于stack exchange，提问作者malfoy