core-js 中的 ECMAScript Date 兼容层模块划分、修复原理与入口使用指南【免费下载链接】core-jsStandard Library项目地址: https://gitcode.com/GitHub_Trending/co/core-js导读本文以 core-js 仓库中的 ECMAScript: Date 文档 为主体系统梳理 core-js 对 ECMAScript 标准 Date 相关方法的实现与兼容修复。你将了解到core-js 把 Date 相关能力拆分为哪些独立模块、每个模块修复了哪些引擎缺陷、各方法的 TypeScript 签名与行为约定以及如何通过core-js/es|stable|actual|full/date等入口按需引入。配合仓库源码modules 与 internals 目录中的实现证据本文会从怎么用深入到为什么这样修。一、文档定位core-js 的 Date 兼容模块全景Date是 ECMAScript 内建对象中历史包袱较重的一个早期引擎如 IE8-、PhantomJS、老版本 WebKit在toISOString、toString、toJSON等方法的实现上存在明显的规范偏差而 Annex B 遗留方法getYear、setYear、toGMTString在不同引擎间的行为也不一致。core-js 将 Date 相关的兼容工作划分为两类ES5 特性及修复es.date.to-string、es.date.now、es.date.to-iso-string、es.date.to-json、es.date.to-primitiveAnnex B 遗留方法es.date.get-year、es.date.set-year、es.date.to-gmt-string。这种按模块粒度拆分的设计使开发者可以只引入自己需要的修复避免一次性引入整个 Date polyfill。二、ES5 Date 核心方法签名、修复点与源码实现1.Date.now()静态方法es.date.now文档给出的签名如下static now(): number;在 modules/es.date.now.js 中实现极简——它通过内部工具function-uncurry-this反柯里化Date.prototype.getTime然后作用于一个新构造的Date实例var thisTimeValue uncurryThis($Date.prototype.getTime); $({ target: Date, stat: true }, { now: function now() { return thisTimeValue(new $Date()); } });源码注释明确标注// TODO: Remove from core-js4说明在 core-js 4 中这类在现代引擎中已无兼容负担的模块将被移除。2.Date.prototype.toISOString()es.date.to-iso-stringtoISOString(): string;这是 core-js 修复力度最大的 Date 方法之一。入口模块 modules/es.date.to-iso-string.js 直接复用内部实现 internals/date-to-iso-string.js并通过对比Date.prototype.toISOString ! toISOString决定是否强制替换注释明确指出PhantomJS / 老版本 WebKit 的实现存在缺陷。内部实现揭示了两个关键修复点年份位数补齐对于超出 4 位的年份负数或大于 9999规范要求带符号且补足 6 位core-js 用padStart实现var sign year 0 ? - : year 9999 ? : ; return sign padStart(abs(year), sign ? 6 : 4, 0) ...非法日期抛RangeError当时间值为NaN时必须抛出RangeError(Invalid time value)而不是返回异常字符串if (!$isFinite(thisTimeValue(this))) throw new $RangeError(Invalid time value);完整输出格式为YYYY-MM-DDTHH:mm:ss.sssZUTC 时间源码逐字段拼接并统一padStart到固定位数。3.Date.prototype.toJSON()es.date.to-jsontoJSON(): string;modules/es.date.to-json.js 通过fails工具做运行时能力探测来决定是否启用 polyfillvar FORCED fails(function () { return new Date(NaN).toJSON() ! null || Date.prototype.toJSON.call({ toISOString: function () { return 1; } }) ! 1; });实现遵循规范的两步流程先把this转为对象再以numberhint 做toPrimitive转换若结果是数字且非有限NaN/±Infinity返回null否则委托给O.toISOString()var pv toPrimitive(O, number); return typeof pv number !isFinite(pv) ? null : O.toISOString();这正是JSON.stringify(new Date(NaN))应序列化为null的原因所在。4.Date.prototype.toString()es.date.to-stringtoString(): string;modules/es.date.to-string.js 修复的是非法日期格式化问题。规范要求new Date(NaN).toString()返回Invalid Date但部分老引擎输出其他字符串。core-js 通过探测决定是否注入修复if (String(new Date(NaN)) ! INVALID_DATE) { defineBuiltIn(DatePrototype, TO_STRING, function toString() { var value thisTimeValue(this); return value value ? nativeDateToString(this) : INVALID_DATE; }); }这里用value value自比较判断NaN合法日期仍走原生toString非法日期统一返回Invalid Date。文档示例也验证了这一点new Date(NaN).toString(); // Invalid Date5.Date.prototype[toPrimitive]es.date.to-primitivetoPrimitive(hint: default | number | string): string | number;modules/es.date.to-primitive.js 仅在原生对象缺少该符号方法时!hasOwn(DatePrototype, TO_PRIMITIVE)注入内部实现 internals/date-to-primitive.jsmodule.exports function (hint) { anObject(this); if (hint string || hint default) hint string; else if (hint ! number) throw new $TypeError(Incorrect hint); return ordinaryToPrimitive(this, hint); };要点hint为string或default时统一走字符串优先的ordinaryToPrimitivehint为number时走数字优先传入其他 hint 值如boolean直接抛出TypeError(Incorrect hint)。该方法是date、${date}等隐式转换行为统一性的基础。三、Annex B 遗留方法getYear/setYear/toGMTString这三个方法源自 Annex B浏览器兼容性附加特性不属于严格意义的 ES 核心core-js 将其单独拆分为独立模块便于按需加载。1.Date.prototype.getYear()es.date.get-yeargetYear(): int;modules/es.date.get-year.js 的语义是返回年 - 1900。core-js 通过fails探测 IE8- 的非标准行为并强制替换var FORCED fails(function () { return new Date(16e11).getYear() ! 120; }); var getFullYear uncurryThis(Date.prototype.getFullYear); getYear: function getYear() { return getFullYear(this) - 1900; }实现直接委托给getFullYear再减去 1900规避了老引擎对 2000 年前后年份的错误处理。2.Date.prototype.setYear()es.date.set-yearsetYear(year: int): number;modules/es.date.set-year.js 是这些模块中逻辑最复杂的一个它精确复刻规范中0–99 视为 1900–1999的怪癖var y year; // NaN 校验 if (y ! y) return setFullYear(this, y); var yi toIntegerOrInfinity(y); var yyyy yi 0 yi 99 ? yi 1900 : yi; return setFullYear(this, yyyy);行为要点先通过thisTimeValue(this)校验this是合法日期对象year会被year强转数字NaN直接透传给setFullYear0 ≤ year ≤ 99 时自动加 1900如setYear(99)相当于设置 1999 年其余值原样传递返回值为更新后的时间戳毫秒数与setFullYear一致。3.Date.prototype.toGMTString()es.date.to-gmt-stringtoGMTString(): string;modules/es.date.to-gmt-string.js 的实现堪称一行兼容——直接将toGMTString别名为标准化的toUTCString$({ target: Date, proto: true }, { toGMTString: Date.prototype.toUTCString });这既保留了历史 API 名称的可用性又确保了输出与现代规范一致。四、Entry Points按需引入的完整入口清单文档给出了 Date 系列模块的完整入口矩阵core-js(-pure)表示core-js与core-js-pure两个发行包均可使用core-js/es|stable|actual|full/date core-js/es|stable|actual|full/date/to-string core-js(-pure)/es|stable|actual|full/date/now core-js(-pure)/es|stable|actual|full/date/get-year core-js(-pure)/es|stable|actual|full/date/set-year core-js(-pure)/es|stable|actual|full/date/to-gmt-string core-js(-pure)/es|stable|actual|full/date/to-iso-string core-js(-pure)/es|stable|actual|full/date/to-json core-js(-pure)/es|stable|actual|full/date/to-primitive入口语义说明es仅标准 ES 特性不含 proposals 与 web 标准模块stable/actual/full三档渐进式集合stable仅稳定特性actual增加已进入最近 stage 的特性full包含全部可用模块core-js-pure不污染全局对象的纯净版适合库作者使用对应 packages/core-js-pure目录级入口core-js/date注意to-string与now没有单独的core-js-pure变体按需引入时以es/date目录入口为主即可。实际使用示例Node 环境// 引入全部 Date 相关修复 import core-js/stable/date; // 只修复 toISOString import core-js/es/date/to-iso-string;入口文件与上述模块的映射关系可在仓库中逐一验证例如 packages/core-js/es/date 目录下对应to-string.js、now.js等文件即按模块粒度转发。五、测试佐证与实现依据toString的Invalid Date行为文档示例new Date(NaN).toString() // Invalid Date正是 modules/es.date.to-string.js 中探测与修复逻辑的直接体现toISOString的大年份补齐internals/date-to-iso-string.js 用fails探测new Date(-5e13 - 1).toISOString()是否为0385-07-25T07:06:39.999Z确认负年份的符号与位数处理toJSON的null返回modules/es.date.to-json.js 对非有限时间值返回null与JSON.stringify的序列化语义严格对应。仓库的单元测试集中在 tests/unit-global 目录相关文件如 es.date.to-iso-string.js、es.date.to-json.js覆盖了非法日期、年份边界、hint 转换等场景可作为行为验证与回归测试的参考。结语core-js 对Date的兼容处理体现了一贯的设计哲学模块粒度拆分 运行时能力探测fails 最小化修补。面对 ES5 修复toString/now/toISOString/toJSON/toPrimitive与 Annex B 遗留getYear/setYear/toGMTString两组能力开发者既可以通过core-js/es|stable|actual|full/date目录入口整体引入也可以按单个方法精确引入在兼容性与包体积之间自由取舍。【免费下载链接】core-jsStandard Library项目地址: https://gitcode.com/GitHub_Trending/co/core-js创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
core-js 中的 ECMAScript Date 兼容层模块划分、修复原理与入口使用指南【免费下载链接】core-jsStandard Library项目地址: https://gitcode.com/GitHub_Trending/co/core-js导读本文以 core-js 仓库中的 ECMAScript: Date 文档 为主体系统梳理 core-js 对 ECMAScript 标准 Date 相关方法的实现与兼容修复。你将了解到core-js 把 Date 相关能力拆分为哪些独立模块、每个模块修复了哪些引擎缺陷、各方法的 TypeScript 签名与行为约定以及如何通过core-js/es|stable|actual|full/date等入口按需引入。配合仓库源码modules 与 internals 目录中的实现证据本文会从怎么用深入到为什么这样修。一、文档定位core-js 的 Date 兼容模块全景Date是 ECMAScript 内建对象中历史包袱较重的一个早期引擎如 IE8-、PhantomJS、老版本 WebKit在toISOString、toString、toJSON等方法的实现上存在明显的规范偏差而 Annex B 遗留方法getYear、setYear、toGMTString在不同引擎间的行为也不一致。core-js 将 Date 相关的兼容工作划分为两类ES5 特性及修复es.date.to-string、es.date.now、es.date.to-iso-string、es.date.to-json、es.date.to-primitiveAnnex B 遗留方法es.date.get-year、es.date.set-year、es.date.to-gmt-string。这种按模块粒度拆分的设计使开发者可以只引入自己需要的修复避免一次性引入整个 Date polyfill。二、ES5 Date 核心方法签名、修复点与源码实现1.Date.now()静态方法es.date.now文档给出的签名如下static now(): number;在 modules/es.date.now.js 中实现极简——它通过内部工具function-uncurry-this反柯里化Date.prototype.getTime然后作用于一个新构造的Date实例var thisTimeValue uncurryThis($Date.prototype.getTime); $({ target: Date, stat: true }, { now: function now() { return thisTimeValue(new $Date()); } });源码注释明确标注// TODO: Remove from core-js4说明在 core-js 4 中这类在现代引擎中已无兼容负担的模块将被移除。2.Date.prototype.toISOString()es.date.to-iso-stringtoISOString(): string;这是 core-js 修复力度最大的 Date 方法之一。入口模块 modules/es.date.to-iso-string.js 直接复用内部实现 internals/date-to-iso-string.js并通过对比Date.prototype.toISOString ! toISOString决定是否强制替换注释明确指出PhantomJS / 老版本 WebKit 的实现存在缺陷。内部实现揭示了两个关键修复点年份位数补齐对于超出 4 位的年份负数或大于 9999规范要求带符号且补足 6 位core-js 用padStart实现var sign year 0 ? - : year 9999 ? : ; return sign padStart(abs(year), sign ? 6 : 4, 0) ...非法日期抛RangeError当时间值为NaN时必须抛出RangeError(Invalid time value)而不是返回异常字符串if (!$isFinite(thisTimeValue(this))) throw new $RangeError(Invalid time value);完整输出格式为YYYY-MM-DDTHH:mm:ss.sssZUTC 时间源码逐字段拼接并统一padStart到固定位数。3.Date.prototype.toJSON()es.date.to-jsontoJSON(): string;modules/es.date.to-json.js 通过fails工具做运行时能力探测来决定是否启用 polyfillvar FORCED fails(function () { return new Date(NaN).toJSON() ! null || Date.prototype.toJSON.call({ toISOString: function () { return 1; } }) ! 1; });实现遵循规范的两步流程先把this转为对象再以numberhint 做toPrimitive转换若结果是数字且非有限NaN/±Infinity返回null否则委托给O.toISOString()var pv toPrimitive(O, number); return typeof pv number !isFinite(pv) ? null : O.toISOString();这正是JSON.stringify(new Date(NaN))应序列化为null的原因所在。4.Date.prototype.toString()es.date.to-stringtoString(): string;modules/es.date.to-string.js 修复的是非法日期格式化问题。规范要求new Date(NaN).toString()返回Invalid Date但部分老引擎输出其他字符串。core-js 通过探测决定是否注入修复if (String(new Date(NaN)) ! INVALID_DATE) { defineBuiltIn(DatePrototype, TO_STRING, function toString() { var value thisTimeValue(this); return value value ? nativeDateToString(this) : INVALID_DATE; }); }这里用value value自比较判断NaN合法日期仍走原生toString非法日期统一返回Invalid Date。文档示例也验证了这一点new Date(NaN).toString(); // Invalid Date5.Date.prototype[toPrimitive]es.date.to-primitivetoPrimitive(hint: default | number | string): string | number;modules/es.date.to-primitive.js 仅在原生对象缺少该符号方法时!hasOwn(DatePrototype, TO_PRIMITIVE)注入内部实现 internals/date-to-primitive.jsmodule.exports function (hint) { anObject(this); if (hint string || hint default) hint string; else if (hint ! number) throw new $TypeError(Incorrect hint); return ordinaryToPrimitive(this, hint); };要点hint为string或default时统一走字符串优先的ordinaryToPrimitivehint为number时走数字优先传入其他 hint 值如boolean直接抛出TypeError(Incorrect hint)。该方法是date、${date}等隐式转换行为统一性的基础。三、Annex B 遗留方法getYear/setYear/toGMTString这三个方法源自 Annex B浏览器兼容性附加特性不属于严格意义的 ES 核心core-js 将其单独拆分为独立模块便于按需加载。1.Date.prototype.getYear()es.date.get-yeargetYear(): int;modules/es.date.get-year.js 的语义是返回年 - 1900。core-js 通过fails探测 IE8- 的非标准行为并强制替换var FORCED fails(function () { return new Date(16e11).getYear() ! 120; }); var getFullYear uncurryThis(Date.prototype.getFullYear); getYear: function getYear() { return getFullYear(this) - 1900; }实现直接委托给getFullYear再减去 1900规避了老引擎对 2000 年前后年份的错误处理。2.Date.prototype.setYear()es.date.set-yearsetYear(year: int): number;modules/es.date.set-year.js 是这些模块中逻辑最复杂的一个它精确复刻规范中0–99 视为 1900–1999的怪癖var y year; // NaN 校验 if (y ! y) return setFullYear(this, y); var yi toIntegerOrInfinity(y); var yyyy yi 0 yi 99 ? yi 1900 : yi; return setFullYear(this, yyyy);行为要点先通过thisTimeValue(this)校验this是合法日期对象year会被year强转数字NaN直接透传给setFullYear0 ≤ year ≤ 99 时自动加 1900如setYear(99)相当于设置 1999 年其余值原样传递返回值为更新后的时间戳毫秒数与setFullYear一致。3.Date.prototype.toGMTString()es.date.to-gmt-stringtoGMTString(): string;modules/es.date.to-gmt-string.js 的实现堪称一行兼容——直接将toGMTString别名为标准化的toUTCString$({ target: Date, proto: true }, { toGMTString: Date.prototype.toUTCString });这既保留了历史 API 名称的可用性又确保了输出与现代规范一致。四、Entry Points按需引入的完整入口清单文档给出了 Date 系列模块的完整入口矩阵core-js(-pure)表示core-js与core-js-pure两个发行包均可使用core-js/es|stable|actual|full/date core-js/es|stable|actual|full/date/to-string core-js(-pure)/es|stable|actual|full/date/now core-js(-pure)/es|stable|actual|full/date/get-year core-js(-pure)/es|stable|actual|full/date/set-year core-js(-pure)/es|stable|actual|full/date/to-gmt-string core-js(-pure)/es|stable|actual|full/date/to-iso-string core-js(-pure)/es|stable|actual|full/date/to-json core-js(-pure)/es|stable|actual|full/date/to-primitive入口语义说明es仅标准 ES 特性不含 proposals 与 web 标准模块stable/actual/full三档渐进式集合stable仅稳定特性actual增加已进入最近 stage 的特性full包含全部可用模块core-js-pure不污染全局对象的纯净版适合库作者使用对应 packages/core-js-pure目录级入口core-js/date注意to-string与now没有单独的core-js-pure变体按需引入时以es/date目录入口为主即可。实际使用示例Node 环境// 引入全部 Date 相关修复 import core-js/stable/date; // 只修复 toISOString import core-js/es/date/to-iso-string;入口文件与上述模块的映射关系可在仓库中逐一验证例如 packages/core-js/es/date 目录下对应to-string.js、now.js等文件即按模块粒度转发。五、测试佐证与实现依据toString的Invalid Date行为文档示例new Date(NaN).toString() // Invalid Date正是 modules/es.date.to-string.js 中探测与修复逻辑的直接体现toISOString的大年份补齐internals/date-to-iso-string.js 用fails探测new Date(-5e13 - 1).toISOString()是否为0385-07-25T07:06:39.999Z确认负年份的符号与位数处理toJSON的null返回modules/es.date.to-json.js 对非有限时间值返回null与JSON.stringify的序列化语义严格对应。仓库的单元测试集中在 tests/unit-global 目录相关文件如 es.date.to-iso-string.js、es.date.to-json.js覆盖了非法日期、年份边界、hint 转换等场景可作为行为验证与回归测试的参考。结语core-js 对Date的兼容处理体现了一贯的设计哲学模块粒度拆分 运行时能力探测fails 最小化修补。面对 ES5 修复toString/now/toISOString/toJSON/toPrimitive与 Annex B 遗留getYear/setYear/toGMTString两组能力开发者既可以通过core-js/es|stable|actual|full/date目录入口整体引入也可以按单个方法精确引入在兼容性与包体积之间自由取舍。【免费下载链接】core-jsStandard Library项目地址: https://gitcode.com/GitHub_Trending/co/core-js创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
