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 技术干货!如果觉得有用,记得收藏本文!

相关推荐
知白守黑26717 小时前
访问控制、用户认证、https
linux·服务器·前端
小妖怪的夏天17 小时前
electron 打包web页面解决跨域问题
前端·javascript·electron
骚饼17 小时前
Git 命令配置别名、Git命令缩写(Mac版)
前端·git
LoveEate17 小时前
vue3 el-switch表单联动校验
前端·javascript·vue.js
z_y_j22997043817 小时前
服务器中更新前端项目
服务器·前端
2301_7976042417 小时前
d40: vue杂项问题
前端·javascript·vue.js
Mintopia18 小时前
领域适配 AIGC:垂直行业 Web 应用的微调技术实践
前端·javascript·aigc
Mintopia18 小时前
Next.js 内置后端能力扩展 —— 重定向与路由保护
前端·javascript·next.js
IT_陈寒18 小时前
Python 3.12 性能暴增50%!这5个新特性让老项目直接起飞
前端·人工智能·后端
excel18 小时前
JavaScript 中的对象池:复用对象的高效方案
前端