JavaScript Date对象基础:四种创建实例的方法与常用属性
全面讲解 JavaScript Date 对象的底层时间戳存储原理、四种创建实例的标准构造方法,以及获取和操作日期分量的常用属性与方法。
在 JavaScript 中,处理时间与日期的核心载体是 Date 对象。从底层原理来看,每一个 Date 实例内部仅存储一个唯一的 64 位整数,即自 1970 年 1 月 1 日 00:00:00 UTC(Unix 时间纪元)起算的毫秒数。本文直接围绕“四种创建实例的重载方式”与“常用时间属性分量获取方法”展开,详细梳理参数规则、时区转换机制、溢出进位特性以及工程实践中的高频陷阱。
一、Date 对象的本质与底层时间戳机制
初学者容易将 Date 对象误解为一个包含“年、月、日、时、分、秒”六个独立字段以及时区名称的复杂结构体。但依据 ECMAScript 标准规范,Date 实例实质上是一个对单一同质数值的封装器。其实例内部通过一个私有插槽 [[DateValue]] 保存绝对时间戳。
该数值的基准点被固定为 1970-01-01T00:00:00.000Z(世界协调时)。如果时间在基准点之后,时间戳为正整数;如果在基准点之前,时间戳为负整数。该数值的有效安全范围为 ±100,000,000 天(即正负 8,640,000,000,000,000 毫秒),能够覆盖公元前 27 万年至公元后 27 万年的时间跨度。
Date 实例内部并不保存本地时区名称。无论是 UTC 还是当地时间,它在内存中存储的毫秒数完全一致。我们在调用 getHours() 或 toString() 时看到的年月日,都是 JavaScript 引擎在执行方法时,临时根据运行宿主系统(操作系统)的时区偏移量动态计算推导出来的。
// 创建一个固定时刻的 Date 实例
const date = new Date(1735689600000); // 对应 2025-01-01 00:00:00 UTC
// 观察不同投影方法下的读数
console.log(date.getTime()); // 内部存储的原始毫秒数
console.log(date.getUTCHours()); // 标准零时区小时数
console.log(date.getHours()); // 宿主本地时区小时数
console.log(date.getTimezoneOffset()); // 本地时区与 UTC 的时间差(分钟)
二、四种创建 Date 实例的方法详解
在 JavaScript 中,只能通过带有 new 操作符的构造函数来创建 Date 对象实例(若不带 new 直接执行 Date(),则无论传入何种参数,均仅返回当前时刻的字符串,而非对象)。new Date() 根据传入参数的个数和数据类型,提供了四种明确的构造分支。
1. 无参数构造:new Date()
当调用时不传递任何参数,构造函数会立即读取当前宿主系统的硬件时钟,生成一个代表“当前执行瞬间”的 Date 实例。其实例内部的 [[DateValue]] 与此时执行 Date.now() 得到的数值完全一致。
const now = new Date();
console.log("类型判断:", typeof now);
console.log("本地格式字符串:", now.toLocaleString());
console.log("当前毫秒时间戳:", now.getTime());
2. 毫秒时间戳构造:new Date(value)
当且仅当只传递一个数值类型的参数时,该参数将被直接视为自 1970-01-01 00:00:00 UTC 起算的绝对毫秒数,并直接写入内部插槽。如果传入的是可转换为数值的类型,引擎会先执行隐式数字转换。
// 传入绝对毫秒数
const d1 = new Date(0); // 1970-01-01 00:00:00 UTC
const d2 = new Date(1735689600000); // 2025-01-01 00:00:00 UTC
const d3 = new Date(-3600000); // 1969-12-31 23:00:00 UTC (1970年前1小时)
console.log("d1 (UTC):", d1.toUTCString());
console.log("d2 (UTC):", d2.toUTCString());
console.log("d3 (UTC):", d3.toUTCString());
new Date(1735689600) 会被视作 1970 年 1 月的某一天。必须先乘以 1000 转换为 13 位毫秒数:new Date(timestampSec * 1000)。
3. 日期时间字符串构造:new Date(dateString)
当只传入一个字符串参数时,构造函数内部会调用与 Date.parse() 相同的算法来解析该字符串。虽然该方式非常直观,但由于历史兼容性问题,它是开发中最容易产生隐蔽 Bug 的构造方式。
// 推荐:符合 ISO 8601 标准的格式
const isoUtc = new Date("2025-01-01T08:00:00.000Z"); // 带 Z 明确表示 UTC 时间
const isoLocal = new Date("2025-01-01T08:00:00+08:00"); // 明确指定时区偏移
// ⚠️ 易错对比:仅包含日期的 ISO 字符串 vs 包含时间的字符串
const dateOnly = new Date("2025-05-01"); // ECMAScript 规定纯日期按 UTC 零点解析
const dateTime = new Date("2025-05-01 00:00:00"); // 含有时间的分隔符通常被按本地时间解析
console.log("dateOnly 本地小时数:", dateOnly.getHours());
console.log("dateTime 本地小时数:", dateTime.getHours());
"2025.05.01"、"05-01-2025")的容错机制不一致。若格式无法被引擎识别,会产生内部值为 NaN 的 Invalid Date。在生产代码中,若使用字符串构造,务必使用标准的 ISO 8601 格式,或改用下文的数值离散参数构造。
4. 离散数值参数构造:new Date(year, monthIndex, ...)
当传入 2 个或以上参数时,参数会被按照“年、月、日、时、分、秒、毫秒”的顺序识别,并且一律按运行环境的本地时间进行运算。各参数的位置和含义如下:
| 参数名 | 是否必选 | 默认值 | 合法取值范围及核心规则 |
|---|---|---|---|
year |
必选 | 无 | 四位数年份。注意:若传入 0~99 之间的数值,会被自动映射为 1900~1999 年。 |
monthIndex |
必选 | 无 | 0 至 11。0 代表 1 月,1 代表 2 月……11 代表 12 月(高频陷阱)。 |
date |
可选 | 1 | 1 至 31。月份中的具体天数。 |
hours |
可选 | 0 | 0 至 23。24 小时制小时数。 |
minutes |
可选 | 0 | 0 至 59。分钟数。 |
seconds |
可选 | 0 | 0 至 59。秒数。 |
ms |
可选 | 0 | 0 至 999。毫秒数。 |
离散数值参数构造具备自动溢出与归一化(Rollover)特性。当任何一个分量超出正常范围(或为负数、零)时,JavaScript 引擎不会报错,而是自动向上级或下级单位进位或退位:
// 1. 月份进位:传入 12(相当于第 13 个月)
const nextYear = new Date(2025, 12, 1);
console.log("月份进位结果:", nextYear.toLocaleDateString()); // 2026/1/1
// 2. 日期进位:2025年1月有31天,传入32
const febFirst = new Date(2025, 0, 32);
console.log("日期进位结果:", febFirst.toLocaleDateString()); // 2025/2/1
// 3. 经典技巧:传入 0 日获取指定月份的最后一天
// 传入 monthIndex = 2(即三月),day = 0,会自动退回到二月份的最后一天
const lastDayOfFeb2025 = new Date(2025, 2, 0); // 平年
const lastDayOfFeb2024 = new Date(2024, 2, 0); // 闰年
console.log("2025年2月最后一天:", lastDayOfFeb2025.getDate()); // 28
console.log("2024年2月最后一天:", lastDayOfFeb2024.getDate()); // 29
三、Date 对象的“常用属性”与核心分量获取方法
在 JavaScript 的语言设计中,Date 实例并没有直接公开类似 date.year 或 date.month 这样的可写属性。所有的时间状态均统一保存在内部插槽中,对外则通过原型链(Date.prototype)暴露一系列 Getter 和 Setter 方法。日常技术交流中常说的“Date 属性”,实质即指这些对应具体时间分量的读取器与修改器。
1. 本地时间分量读取方法
下列方法均基于当前代码执行所在系统的本地时区进行解析:
getFullYear():返回四位数的完整年份(如 2025)。严禁使用已被废弃的getYear()(该方法返回自 1900 年以来的年数差)。getMonth():返回月份索引(0~11)。实际展示在界面或拼接字符串时必须+ 1。getDate():返回当月的日期(1~31)。注意区分getDate()(日)与getDay()(星期)。getDay():返回星期几(0~6)。0 代表星期日,1 至 6 分别代表星期一至星期六。getHours()、getMinutes()、getSeconds()、getMilliseconds():分别返回 24 小时制小时(0~23)、分钟(0~59)、秒(0~59)及毫秒(0~999)。getTimezoneOffset():返回当前时区与 UTC 之间的时差(单位为分钟)。例如在中国标准时间(UTC+8)下,返回值为-480。
2. 标准 UTC 分量读取方法
对应上述本地方法,每个分量都有对应的 UTC 版本,直接以格林威治标准时间计算,不受宿主操作系统时区配置影响:
getUTCFullYear()、getUTCMonth()、getUTCDate()、getUTCDay()getUTCHours()、getUTCMinutes()、getUTCSeconds()、getUTCMilliseconds()
3. 实例时间戳获取与静态辅助工具
除了分量访问,工程中最常用的还有获取全局绝对毫秒数以及执行快速转换:
const target = new Date("2025-06-15T10:30:00+08:00");
// 1. 获取毫秒时间戳的三种等价方式
const ts1 = target.getTime();
const ts2 = target.valueOf();
const ts3 = +target; // 一元加号隐式转换
console.log("毫秒值是否相等:", ts1 === ts2 && ts2 === ts3); // true
// 2. 静态方法:获取当前时间戳(避免创建临时对象开销)
const perfStart = Date.now();
// 3. 静态方法:计算纯 UTC 参数的时间戳
const utcTimestamp = Date.UTC(2025, 5, 15, 2, 30, 0); // 对应 2025-06-15 02:30:00 UTC
console.log("UTC 静态计算时间戳:", utcTimestamp);
四、常见问题排查与工程最佳实践
1. 如何准确判断 Date 实例是否合法?
当给构造函数传入无法解析的字符串或非法数值时,JavaScript 不会抛出运行时异常,而是生成一个名为 Invalid Date 的特殊实例。由于 typeof (new Date("abc")) 依然返回 "object",且 date instanceof Date 恒为 true,常规的类型断言会完全失效。
可靠检测方案:检测其实例内部时间戳是否为 NaN:
function isValidDate(d) {
return d instanceof Date && !Number.isNaN(d.getTime());
}
console.log("有效日期:", isValidDate(new Date("2025-01-01"))); // true
console.log("非法日期:", isValidDate(new Date("invalid-str"))); // false
2. 两位数年份自动补全陷阱(0~99)
当使用 new Date(year, monthIndex, ...) 时,如果 year 处于 0 至 99 之间,JavaScript 引擎会为了向下兼容 Netscape 早期标准,强制将其加上 1900。例如 new Date(25, 0, 1) 产生的是公元 1925 年,而非公元 25 年。
若确实需要构建公元 1 世纪的历史年份,必须使用 setFullYear() 显式指定:
const ancient = new Date(25, 0, 1);
console.log("直接构造年份:", ancient.getFullYear()); // 1925
ancient.setFullYear(25); // 显式重设年份
console.log("重设后年份:", ancient.getFullYear()); // 25
3. 格式化输出选择建议
原生 Date 对象的 toString() 返回包含冗长时区信息的英文串。如果需要传输到服务端,首选 date.toISOString()(输出符合 ISO 8601 标准的 UTC 字符串,如 "2025-01-01T00:00:00.000Z")。如果在国内前端界面向用户展示,推荐使用现代浏览器的 Intl.DateTimeFormat API 或 date.toLocaleDateString("zh-CN")。
JavaScript去除字符串所有空格的几种方法对比
2026-11-18 13:21:23
JS使用filter方法批量移除满足条件的数组元素
2026-11-18 12:00:20
轻量级JavaScript弹窗库推荐:SweetAlert2与Layer对比
2026-11-18 11:07:20
JS怎么用正则表达式查找字符串?search与match区别解析
2026-11-18 10:32:12
JS全局对象包含哪些常用内置属性和方法
2026-11-18 10:20:10








