Date-fns教程:现代JavaScript日期处理从入门到精通

1. 安装和快速上手

安装

bash 复制代码
npm install date-fns

快速体验

date-fns 与 Moment、Day.js 最大的不同点------它完全是函数式风格,通过函数操作Date对象,无全局对象污染,无副作用,极小体积。

js 复制代码
import { format } from 'date-fns';

console.log(format(new Date(), 'yyyy-MM-dd HH:mm:ss')); // 2024-06-01 16:08:00

2. 日期的创建与格式化

创建日期

date-fns 直接用原生 Date 对象操作:

js 复制代码
const now = new Date();
const customDate = new Date(2024, 5, 1, 12, 30); // 注意:6月是5,月份从0开始!

日期格式化

js 复制代码
import { format } from 'date-fns';

// 格式化为常用字符串
console.log(format(new Date(), 'yyyy-MM-dd HH:mm:ss')); // 2025-06-02 22:41:57
console.log(format(new Date(), 'EEEE, MMMM do, yyyy'));  // Monday, June 2nd, 2025

format 函数使用类似于Java的格式字符串,详细见 format文档


3. 日期的加减和计算

加减天、月、年

js 复制代码
import { format, addDays, subDays } from 'date-fns';

const today = new Date();
const tomorrow = addDays(today, 1);
const lastMonth = subDays(today, 30);

console.log(format(tomorrow, 'yyyy-MM-dd'));  // 明天
console.log(format(lastMonth, 'yyyy-MM-dd')); // 30天前

计算日期差异

js 复制代码
import { differenceInDays, differenceInMonths } from 'date-fns';

const d1 = new Date(2024, 5, 1);
const d2 = new Date(2024, 5, 21);

console.log(differenceInDays(d2, d1));    // 20
console.log(differenceInMonths(d2, d1));  // 0

4. 判断与比较日期

js 复制代码
import { isBefore, isAfter, isEqual } from 'date-fns';

const dA = new Date(2024, 5, 1);
const dB = new Date(2024, 6, 1);

console.log(isBefore(dA, dB)); // true
console.log(isAfter(dA, dB));  // false
console.log(isEqual(dA, new Date(2024, 5, 1))); // true

5. 日期区间&常用工具函数

判断日期是否在区间

js 复制代码
import { isWithinInterval } from 'date-fns';

const date = new Date(2024, 5, 10);
const start = new Date(2024, 5, 1);
const end = new Date(2024, 5, 30);

console.log(isWithinInterval(date, { start, end })); // true

获得月初月末

js 复制代码
import {format, startOfMonth, endOfMonth } from 'date-fns';

const now = new Date();
console.log(format(startOfMonth(now), 'yyyy-MM-dd')); // 月初
console.log(format(endOfMonth(now), 'yyyy-MM-dd'));   // 月末

6. 本地化、多语言支持

date-fns拥有完善的本地化支持,且无需全局配置!

js 复制代码
import { format } from 'date-fns';
import { zhCN } from 'date-fns/locale';

const today = new Date();
console.log(format(today, 'PPPP', { locale: zhCN })); // 2025年6月2日 星期一

结语

date-fns是现代JavaScript日期处理的最佳实践之选------全面、轻巧、函数式、可本地化。


点个赞,关注我获取更多实用 JavaScript 技术干货!如果觉得有用,记得收藏本文!

相关推荐
张一凡9328 分钟前
你的 AGENTS.md,真的管到模型写代码了吗?
前端·后端·agent
Brookty32 分钟前
CSS基础知识(一):选择器、优先级、层叠与继承、边框属性及盒模型
前端·css
颜进强1 小时前
微信小微AI-灰度与命中排查|代码全对、版本已发,为什么同事就是问不中?
前端·ai编程·全栈
verohh1 小时前
从代码组织到功能抽象:AI 时代的前端工程架构设计
前端
颜进强1 小时前
微信小微AI-评测|文档质量直接被判 0 分:小微团队评测那些没人告诉你的硬指标
前端·ai编程·全栈
Bacon1 小时前
给项目做一次"全身 CT":Agent Skills 生态里的代码体检全链路
前端·人工智能·后端
颜进强1 小时前
微信小微AI-提审与发布|评测过了不等于能上线:四道前置条件,缺一道都白提交
前端·ai编程·全栈
颜进强1 小时前
微信小微AI-【实战二】从零写一个 skill|卡片死活不出来?这 4 个坑我们全踩了一遍
前端·ai编程·全栈
颜进强1 小时前
微信小微AI-命中效果调优|在 AI 的「选择题」里,怎么让小微更愿意选中你(系列收官)
前端·ai编程·全栈
颜进强1 小时前
微信小微AI-【实战四】给 Agent 立人设|一份 AGENTS.md,决定小微是靠谱助手还是满嘴跑火车
前端·ai编程·全栈