Day.js与原生JS获取小时数的写法对比
深入对比 Day.js 与原生 JavaScript 获取小时数的写法差异,涵盖数值提取、补零格式化、可变性机制、UTC与时区扩展以及技术选型建议。
获取当前或指定时间的小时数是前端与 Node.js 开发中的高频需求。原生 JavaScript 通过 date.getHours() 提取本地小时,而轻量时间库 Day.js 则采用 dayjs().hour() 语法。两者最终返回的均为 0 ~ 23 范围的整型数值。但在实际业务中,从小数字段的提取、补零格式化、实例可变性保护到跨时区转换,二者体现出截然不同的设计哲学与使用体验。
一、基础数值提取:基本写法与 API 设计
在纯粹提取“小时整型数值”的场景下,两者的目标完全一致:从特定时间对象中提取代表小时的数字(取值范围均为 0 到 23,其中 0 代表午夜 12 点,23 代表晚上 11 点)。
1. 原生 JavaScript 的标准写法
原生 JS 基于 ECMAScript 内置的 Date 对象。无需引入任何第三方模块,直接调用其原型方法 getHours() 即可获取本地时区对应的小时:
// 运行环境:现代浏览器 / Node.js
const now = new Date();
const currentHour = now.getHours();
console.log('当前本地小时数:', currentHour);
// 示例输出: 14 (数字类型,取值 0 到 23)
如果需要获取世界协调时间(UTC)对应的小时,原生提供了成对的方法 getUTCHours():
const utcHour = now.getUTCHours();
console.log('当前 UTC 小时数:', utcHour);
// 示例输出: 6 (在 UTC+8 东八区环境下,14点对应的UTC时间为6点)
2. Day.js 的标准写法与别名机制
Day.js 将时间包装为专属的不可变对象。获取小时数时,主要使用单数形式的 hour() 方法:
import dayjs from 'dayjs';
const now = dayjs();
const currentHour = now.hour();
console.log('Day.js 获取本地小时数:', currentHour);
// 示例输出: 14 (同样返回 0 到 23 的整型数值)
// 等价写法:使用通用 getter 或复数形式别名
const hourViaGet = now.get('hour');
const hourViaPlural = now.hours(); // 与 hour() 功能完全一致
在 API 设计上,Day.js 借鉴了 Moment.js 的“重载式”设计:无传参时 now.hour() 是 Getter(读取小时),有传参时 now.hour(16) 则是 Setter(产生一个小时为 16 的新实例)。而原生 JS 则采用严格的 getHours() 与 setHours() 动宾分离命名。
二、格式化展示:从数值到字符串的转换效率
在真实前端业务中,单纯拿到数字 9 或 14 往往无法直接展示在界面上。我们通常需要将其格式化为两位数补零字符串(如 "09")、12 小时制展示(如 "下午 02:00")或带周期的英文格式(如 "02 PM")。正是在这一步,两者的编码成本拉开了明显差距。
1. 原生 JS 的格式化处理
原生 getHours() 仅返回基础类型 number,缺乏内置的模板占位符机制。要实现双位数字(如 9 点展示为 "09"),通常需要结合现代字符串方法 padStart():
const date = new Date();
const rawHour = date.getHours();
// 24 小时制补零处理
const formatted24 = String(rawHour).padStart(2, '0');
console.log('原生补零结果:', formatted24); // 示例输出: "14" 或 "09"
// 转换为 12 小时制需要手动进行求模计算
const hour12 = (rawHour % 12) || 12;
const period = rawHour >= 12 ? 'PM' : 'AM';
console.log('手动转换 12 小时制:', `${String(hour12).padStart(2, '0')} ${period}`);
// 示例输出: "02 PM"
若希望借助国际化标准 API,可以使用 Intl.DateTimeFormat,但这在单纯处理小时字段时语法相对冗长:
const formatter = new Intl.DateTimeFormat('zh-CN', {
hour: '2-digit',
hour12: false
});
console.log(formatter.format(date)); // 示例输出: "14时" 或 "14"
2. Day.js 的声明式格式化
Day.js 内置了强大的格式化引擎。开发者无需关心类型转换与字符串拼接,只需传递对应的格式化占位符:
const day = dayjs();
// 24小时制:单数与双数
console.log(day.format('H')); // 示例输出: "14" (0 ~ 23,不补零)
console.log(day.format('HH')); // 示例输出: "14" (00 ~ 23,自动补零)
// 12小时制:带上下午标识
console.log(day.format('h')); // 示例输出: "2" (1 ~ 12,不补零)
console.log(day.format('hh')); // 示例输出: "02" (01 ~ 12,自动补零)
console.log(day.format('hh A')); // 示例输出: "02 PM"
console.log(day.format('hh a')); // 示例输出: "02 pm"
在旧时代(ES5 及以前),原生 JS 缺乏 padStart,开发者往往需要写 ("0" + h).slice(-2) 这种技巧性代码,这成为许多人转向时间库的主要动力。但在支持 ES2017+ 的现代 JavaScript 环境中,String(h).padStart(2, '0') 已经成为规范且原生的标准写法。如果仅仅是为了在日志或时钟界面补零,原生写法的可读性与执行效率完全满足要求,不必为了补零而专程引入时间库。
三、机制原理:可变性(Mutability)与副作用防范
获取小时数往往不是孤立的操作。在复杂的业务逻辑中,我们常常需要基于当前小时数去计算未来或过去的某个时点(例如“将时间调整为下午 5 点整,并对比早晚状态”)。正是在写操作和传参环节,原生 Date 与 Day.js 展现出了根本性的机制分歧。
1. 原生 Date 的原地突变(In-place Mutation)
原生 Date 是典型的“可变对象”。调用其 setHours() 方法时,会直接改写该实例在内存中的内部时间戳:
const meetingTime = new Date('2026-11-17T14:00:00');
function checkSchedule(timeObj) {
// 意图:基于该时间设置下班时点
timeObj.setHours(18); // 警告:这会直接改变传入的原对象!
return timeObj.getHours();
}
console.log('处理前小时:', meetingTime.getHours()); // 示例输出: 14
checkSchedule(meetingTime);
console.log('处理后小时:', meetingTime.getHours()); // 示例输出: 18 (meetingTime 被污染!)
这种原地修改极易在大型项目、异步回调或 React/Vue 等状态驱动的框架中引发难以追踪的“幽灵 Bug”。为了保证安全,原生 JS 必须在修改前手动克隆新对象:const safeCopy = new Date(meetingTime.getTime());。
2. Day.js 的不可变性(Immutability)
Day.js 在底层贯彻了不可变数据设计模式。调用 hour(val) 传入数值时,原有的 Dayjs 实例绝对不会发生任何变更,而是返回一个全新的 Dayjs 实例:
const meetingTime = dayjs('2026-11-17T14:00:00');
// 调整小时数,生成新对象
const closingTime = meetingTime.hour(18);
console.log('原对象小时:', meetingTime.hour()); // 示例输出: 14 (始终保持安全)
console.log('新对象小时:', closingTime.hour()); // 示例输出: 18 (独立的新实例)
四、时区与 UTC 场景下的获取差异
当系统涉及跨国业务、境外用户或服务器与客户端时区不一致时,小时数的判定极度敏感。一个在北京时间为下午 14 点的事件,在伦敦可能为早上 6 点,在纽约则为凌晨 1 点。
1. 原生 JS 的时区支持边界
原生 Date 本质上存储的是自 Unix 纪元起的毫秒绝对值。它原生仅提供两个时区维度的直属 API:
date.getHours():宿主操作系统的当前本地时区。date.getUTCHours():零时区(UTC+0)。
如果需要获取特定时区(如 America/New_York)的小时数,原生 Date 无法直接修改其时区属性,必须借助 Intl.DateTimeFormat 进行转换提取:
const now = new Date('2026-11-17T14:00:00+08:00');
// 获取指定纽约时区的小时数
const nyFormatter = new Intl.DateTimeFormat('en-US', {
timeZone: 'America/New_York',
hour: 'numeric',
hour12: false
});
console.log('纽约当前小时:', nyFormatter.format(now));
// 示例输出: "1" (凌晨 1 点)
2. Day.js 的插件化时区方案
为了保持核心体积仅约 2KB,Day.js 默认同样只处理本地时间。但在需要精准时区时,可以通过官方插件 utc 和 timezone 获得极具可读性的链式写法:
import dayjs from 'dayjs';
import utc from 'dayjs/plugin/utc';
import timezone from 'dayjs/plugin/timezone';
dayjs.extend(utc);
dayjs.extend(timezone);
const targetTime = dayjs('2026-11-17T14:00:00+08:00');
// 获取 UTC 小时数
console.log('UTC 小时:', targetTime.utc().hour()); // 示例输出: 6
// 获取目标时区小时数
console.log('纽约小时:', targetTime.tz('America/New_York').hour()); // 示例输出: 1
console.log('东京小时:', targetTime.tz('Asia/Tokyo').hour()); // 示例输出: 15
五、开发决策与选型对比总结
在技术选型时,不能孤立地评价哪个工具绝对优秀,而应基于工程规模、依赖预算以及业务场景的复杂度进行权衡。下表总结了原生 JS 与 Day.js 在获取小时数时的多维度表现:
| 对比维度 | 原生 JavaScript (Date) | Day.js 库 |
|---|---|---|
| 获取小时语法 | date.getHours() |
day.hour() 或 day.get('hour') |
| 返回值类型 | 整型数字 0 ~ 23 |
整型数字 0 ~ 23 |
| 包体积与依赖 | 0 字节,标准内置,无打包负担 | 核心约 2KB gzip,需安装外部依赖 |
| 字符串补零效率 | 需手动 padStart(2, '0') |
声明式 day.format('HH') 一步完成 |
| 12 小时制与上下午 | 需编写取模逻辑或使用 Intl |
内置模板 day.format('hh A') |
| 设置小时的安全性 | setHours() 原地突变,易引发并发污染 |
hour(val) 纯函数返回新实例,状态不可变 |
| 任意时区小时获取 | 依赖 Intl.DateTimeFormat 配合解析 |
扩展 timezone 插件后一行搞定 |
实际工程落地建议
-
基础脚本、高频动画或极简工具函数:优先使用原生
new Date().getHours()。它的调用没有任何中间层,执行性能最高,且不会对公共组件库引入外部依赖包。 -
具备多重格式化、日期加减或展示诉求的业务系统:若项目中已经引入了 Day.js,应统一采用
dayjs().hour()和dayjs().format('HH')。这样能保持整个项目日期处理心智模型的统一,同时规避原生Date突变带来的隐患。
六、常见误区与避坑清单
在处理小时数相关的日常编码中,以下三个细节特别容易被疏忽:
-
误区一:混淆“0点”的数值表征
许多初学者误以为午夜 12 点返回的是24或12。事实上,无论是原生getHours()还是 Day.js 的hour(),在午夜零点均严格返回整数0。在编写根据时间切换问候语或夜间模式的代码时,务必将0纳入深夜时间区间,切忌以if (hour >= 1)为起始判断条件。 -
误区二:误将
setHours()当作链式纯函数
在编写原生代码时,切勿写出形如const target = originalDate.setHours(10);的代码。原生setHours返回的是时间戳毫秒数而非 Date 实例本身,而且它已经静默修改了originalDate。而在 Day.js 中,day.hour(10)才会返回包装好的新 Dayjs 实例。 -
误区三:非标准时间字符串解析的跨浏览器陷阱
原生new Date('2026/11/17 14:00')与new Date('2026-11-17 14:00')在某些老旧浏览器或不同操作系统引擎中可能被解析为不同时区甚至返回Invalid Date,导致getHours()返回NaN。Day.js 提供了更严格的customParseFormat插件,在解析非 ISO 标准时间字符串并提取小时时更加健壮。
Modern Web Guidance 为什么不再对字符串建议 toReversed?
2026-11-18 13:35:17
Google GenAI SDK 3.5.0的WebSocket和WebRTC该怎样理解?
2026-11-18 13:32:28
Ducter 0.0.75 和 0.0.76 怎样解释仓库待办与待审 PR?
2026-11-18 13:30:20
JS布尔值强制转换:哪些值会被转为false?
2026-11-18 09:27:54
JS怎么使用JSON.stringify格式化JSON字符串并控制缩进
2026-11-18 09:05:50








