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

相关推荐
岁月宁静1 小时前
深度定制:在 Vue 3.5 应用中集成流式 AI 写作助手的实践
前端·vue.js·人工智能
心易行者2 小时前
10天!前端用coze,后端用Trae IDE+Claude Code从0开始构建到平台上线
前端
saadiya~2 小时前
ECharts 实时数据平滑更新实践(含 WebSocket 模拟)
前端·javascript·echarts
fruge2 小时前
前端三驾马车(HTML/CSS/JS)核心概念深度解析
前端·css·html
百锦再2 小时前
Vue Scoped样式混淆问题详解与解决方案
java·前端·javascript·数据库·vue.js·学习·.net
烛阴2 小时前
Lua 模块的完整入门指南
前端·lua
浪里行舟3 小时前
国产OCR双雄对决?PaddleOCR-VL与DeepSeek-OCR全面解析
前端·后端
znhy@1234 小时前
CSS易忘属性
前端·css
瓜瓜怪兽亚4 小时前
前端基础知识---Ajax
前端·javascript·ajax
AI智能研究院4 小时前
(四)从零学 React Props:数据传递 + 实战案例 + 避坑指南
前端·javascript·react.js