dayjs​​​​​​​文档

最新推荐文章于 2025-10-28 18:31:08 发布
转载 最新推荐文章于 2025-10-28 18:31:08 发布 · 2k 阅读 · 1

本文介绍了 Dayjs.js 的核心功能，包括创建、解析、格式化日期时间，进行时间操作及比较等。Dayjs 是一个轻量级的 JavaScript 库，用于替代原生 Date 对象，提供了丰富的 API 和插件来简化日期时间的处理。

转载自   dayjs

API

Dayjs 并没有改变或覆盖 Javascript 原生的 Date.prototype， 而是创造了一个全新的包含 Javascript Date 对象的 Dayjs的对象。

Dayjs 对象是不可变的, 所有的 API 操作都将返回一个新的 Dayjs 对象。

如果没有特别说明，Day.js 的返回值都是新的 Dayjs 对象。

解析

在 dayjs() 中传入支持的格式

当前时间

直接运行 dayjs()，得到包含当前时间和日期的 Dayjs 对象。

dayjs();

时间字符串

可以解析传入的一个标准的ISO 8601时间字符串。

dayjs(String);
dayjs("1995-12-25");

Unix 时间戳 (毫秒)

可以解析传入的一个 Unix 时间戳 (13位数字)。

dayjs(Number);
dayjs(1318781876406);

Date 对象

可以解析传入的一个 Javascript Date 对象。

dayjs(Date);
dayjs(new Date(2018, 8, 18));

复制

Dayjs 对象是不可变的，如果您想获得一个对象的拷贝，请执行 .clone()。 向 dayjs() 里传入一个 Dayjs 对象也能实现同样的效果。

dayjs(Dayjs);
dayjs().clone();

验证

  • return Boolean

检测当前 Dayjs 对象是否是一个有效的时间。

dayjs().isValid();

获取+设置

获取和改变日期。

年

  • return Number

获取年份。

dayjs().year();

月

  • return Number

获取月份。

dayjs().month();

日

  • return Number

获取日期。

dayjs().date();

星期

  • return Number

获取星期。

dayjs().day();

时

  • return Number

获取小时。

dayjs().hour();

分

  • return Number

获取分钟。

dayjs().minute();

秒

  • return Number

获取秒。

dayjs().second();

毫秒

  • return Number

获取毫秒。

dayjs().millisecond();

设置

设置时间 传入的单位 (unit) 对大小写不敏感。

dayjs().set(unit : String, value : Int);
dayjs().set('date', 1);
dayjs().set('month', 3); // 四月
dayjs().set('second', 30);

可用单位

单位缩写描述
date 日期
dayd星期几 (星期天 0, 星期六 6)
monthM月
yeary年
hourh时
minutem分
seconds秒
millisecondms毫秒

操作

您可以对 Dayjs 对象如下增加减少之类的操作：

dayjs().startOf('month').add(1, 'day').subtract(1, 'year')

增加

增加时间并返回一个新的 Dayjs() 对象。

dayjs().add(value : Number, unit : String);
dayjs().add(7, 'day');

减少

减少时间并返回一个新的 Dayjs() 对象，使用方法和 dayjs#add 相同。

dayjs().subtract(value : Number, unit : String);
dayjs().subtract(7, 'year');

开头时间

返回当前时间的开头时间的 Dayjs() 对象，如月份的第一天。

dayjs().startOf(unit : String);
dayjs().startOf('year');

末尾时间

返回当前时间的末尾时间的 Dayjs() 对象，如月份的最后一天。

dayjs().endOf(unit : String);
dayjs().endOf('month');

显示

格式化 Dayjs 对象并展示。

格式化

  • return String

接收一系列的时间日期字符串并替换成相应的值。

dayjs().format(String);
dayjs().format();                       // "2014-09-08T08:02:17-05:00" (ISO 8601, no fractional seconds)
dayjs().format("{YYYY} MM-DDTHH:mm:ssZ[Z]"); // "{2014} 09-08T08:02:17-05:00Z"

详情如下:

FormatOutputDescription
YY18两位数的年份
YYYY2018四位数的年份
M1-12月份，从 1 开始
MM01-12月份，两位数
MMMJan-Dec简写的月份名称
MMMMJanuary-December完整的月份名称
D1-31月份里的一天
DD01-31月份里的一天，两位数
d0-6一周中的一天，星期天是 0
ddSu-Sa最简写的一周中一天的名称
dddSun-Sat简写的一周中一天的名称
ddddSunday-Saturday一周中一天的名称
H0-23小时
HH00-23小时，两位数
m0-59分钟
mm00-59分钟，两位数
s0-59秒
ss00-59秒 两位数
SSS000-999秒 三位数
Z+5:00UTC 的偏移量
ZZ+0500UTC 的偏移量，数字前面加上 0
AAM PM 
aam pm 
  • 更多格式化的选项 Q Do k kk X x ... 可以使用插件 AdvancedFormat

时间差

  • return Number

获取两个 Dayjs 对象的时间差，默认毫秒。

dayjs().diff(Dayjs, unit);
dayjs().diff(dayjs(), 'years'); // 0

Unix 时间戳 (毫秒)

  • return Number

返回 Unix 时间戳 (毫秒)

dayjs().valueOf();

Unix 时间戳 (秒)

  • return Number

返回 Unix 时间戳 (秒)。

dayjs().unix();

天数 (月)

  • return Number

返回月份的天数。

dayjs().daysInMonth();

Date 对象

  • return Javascript Date object

返回原生的 Date 对象。

dayjs().toDate();

数组

  • return Array

返回包含时间数值的数组。

dayjs().toArray(); //[2018, 8, 18, 00, 00, 00, 000];

As JSON

  • return JSON String

当序列化 Dayjs 对象时，会返回 ISO8601 格式的字符串。

dayjs().toJSON(); //"2018-08-08T00:00:00.000Z"

ISO 8601 字符串

  • return String

返回 ISO8601 格式的字符串。

dayjs().toISOString();

对象

  • return Object

返回包含时间数值的对象。

dayjs().toObject();// { years:2018, months:8, date:18, hours:0, minutes:0, seconds:0, milliseconds:0}

字符串

  • return String
dayjs().toString();

查询

是否之前

  • return Boolean

检查一个 Dayjs 对象是否在另一个 Dayjs 对象时间之前。

dayjs().isBefore(Dayjs);
dayjs().isBefore(dayjs()); // false

是否相同

  • return Boolean

检查一个 Dayjs 对象是否和另一个 Dayjs 对象时间相同。

dayjs().isSame(Dayjs);
dayjs().isSame(dayjs()); // true

是否之后

  • return Boolean

检查一个 Dayjs 对象是否在另一个 Dayjs 对象时间之后。

dayjs().isAfter(Dayjs);
dayjs().isAfter(dayjs()); // false

是否是 Dayjs .isDayjs(compared: any)

返回一个 boolean 验证传入值是否是一个 Dayjs 对象.

dayjs.isDayjs(dayjs()); // true
dayjs.isDayjs(new Date()); // false

插件 APIs

相对时间

.from .to .fromNow .toNow 获得相对时间

插件 RelativeTime

是否是闰年

.isLeapYear 获得是否闰年

插件 IsLeapYear

年中的第几周

.week 获取是第几个周

插件 WeekOfYear

是否之间

.isBetween 返回一个时间是否介于两个时间之间

Day.js 中文文档完整版 JavaScript 时间日期处理库可替代Moment.js
代码简单说 Vue、JAVA、PHP、Node.js 熟练运用，接口、架构、性能全搞定。
10-13 256
Day.js 可以运行在浏览器和 Node.js 中。本文档所有代码都可以在这两种环境中正常运行，所有单元测试也都在这两个环境下完成。CI 系统测试覆盖的浏览器有：Chrome on Windows XP, IE 8, 9, and 10 on Windows 7, IE 11 on Windows 10, latest Firefox on Linux, and latest Safari on OSX 10.8 and 10.11。打开您的浏览器控制台，即可输入测试示例代码。要在您的 Node.js 项
探索小程序开发环境的最佳实践
小程序开发
06-22 925
本文旨在为小程序开发者提供一套完整的开发环境最佳实践方案，涵盖从环境配置到发布上线的全流程。我们将重点关注微信小程序开发环境，但许多原则也适用于其他平台的小程序开发。文章将从基础环境搭建开始，逐步深入到高级开发技巧，最后探讨性能优化和跨平台开发策略。每个部分都将提供详细的步骤说明和实际代码示例。小程序：一种不需要下载安装即可使用的应用，实现了"触手可及"的梦想WXML：WeiXin Markup Language，微信小程序框架设计的一套标签语言WXSS。
日期时间工具 -- dayjs
Dark_programmer的博客
12-08 1148
莫道君行早 更有早行人 DayJs1.关于dayJs2.插件安装3. 部分API展示3.1 获取某日所属周后面一周的开始、结束日期：3.2 获取某日所在月的开始、结束日期 1.关于dayJs Moment.js 的 2kB 轻量化方案，拥有同样强大的 API Day.js 是一个轻量的处理时间和日期的 JavaScript 库，和 Moment.js 的 API 设计保持完全一样. 如果您曾经用过 Moment.js, 那么您已经知道如何使用 Day.js 更多介绍 : dayjs 2.插件安装 安.
dayjs常用时间处理
发渐稀的博客
11-19 2043
获取一段时间后的时间，时间单位支持年、月、日、时、分、秒、毫秒、周、季度，返回的是 dayjs 实例。
Day.js 使用文档
最新发布
懒羊羊我小弟的博客
10-28 1058
Day.js 是一个轻量级 JavaScript 日期处理库，仅 2KB 大小，API 与 Moment.js 兼容。它支持日期解析、格式化、计算等核心功能，所有操作都基于不可变的 Day.js 对象。常用功能包括格式化日期（format()）、时间计算（add()/subtract()）、比较差值（diff()）等。通过插件可扩展本地化、相对时间等能力。相比 Moment.js，Day.js 更轻量且支持 tree-shaking，适合对体积敏感的项目。安装简单，只需导入核心模块即可使用基础功能，按需加载
日期时间工具（dayjs）的使用
热门推荐
一只倔强的蜗牛的博客
05-27 6万+
简介 Day.js 是一个轻量的处理时间和日期的 JavaScript 库，和 Moment.js 的 API 设计保持完全一样. 如果您曾经用过 Moment.js, 那么您已经知道如何使用 Day.js 安装 npm install dayjs --save import dayjs from 'dayjs' // 或者 CommonJS // var dayjs = require('d...
Day.js ：一个轻量的处理时间和日期的 JavaScript 库
小太阳的博客
08-02 1282
安装： npm install dayjs --save main.js引入 import dayjs from 'dayjs'; Vue.prototype.$dayjs = dayjs; API参考： Dayjs 并没有改变或覆盖 Javascript 原生的 Date.prototype， 而是创造了一个全新的包含 Javascript Date 对象的 Dayjs 的对象。 Dayjs 对象是不可变的, 所有的 API 操作都将返回一个新的 Dayjs 对象。 当前时间 直接运行 dayj
鸿蒙开发5.0【鸿蒙时间格式化】
2401_82772199的博客
08-07 788
时间格式化有很多方式，本文将使用轻量级的dayjs实现时间格式化，废话不多说，直接看下边样例
常用第三方包汇总（持续更新）
Angel_of_hell的博客
08-12 2424
目录 1 前端开发常用第三方包 1.1 moment日期处理 1.2 then-fs读取文件内容 1.3 webpack打包代码 1.3.1 加载器 1.3.2 插件 1.3.3 webpack-dev-server自动刷新 1.4 axios发送ajax请求的库 1.5 bootstrap前端开发框架 1.6 vue-routerr路由系统 1.7 vant组件库,移动端开发框架 1.8 postcss postcss-pxtorem 1.9 移动端REM适配包 1.9.1 a
Vue 2.0 学习笔记（二）
weixin_44772326的博客
12-07 4962
Vue基础入门（1）：Vue的数据驱动视图与双向绑定特性，MVVM工作原理，Vue调试工具，Vue指令与Vue过滤器
小程序领域的开发攻略：框架使用技巧
小程序开发
07-18 360
本文旨在为小程序开发者提供全面的框架使用指南，覆盖从入门到进阶的关键技术点。我们将重点讨论微信小程序原生框架、uni-app、Taro等主流开发框架的特点和使用技巧，帮助开发者根据项目需求选择合适的开发方案。文章将从框架选择开始，逐步深入到开发技巧、性能优化和调试方法，最后探讨未来发展趋势。每个部分都配有实际代码示例和最佳实践建议。小程序框架：提供小程序开发所需的基础设施和工具链，包括模板语法、组件系统、API封装等跨平台开发：一套代码可编译到多个小程序平台（微信、支付宝、百度等）运行的技术方案。
dayjs
pumpkin_truck的博客
08-04 1182
时间框架——Day.js 今天给大家推荐一个好用的时间框架，dayjs，一个轻量的处理时间和日期的 JavaScript 库。 在做这个项目以前我都没接触过这个框架，正在我用最元老的方法去完成对时间格式的转变和求时间间隔时，同事使用这个框架让我耳目一新。它和Moment.js 的 API 设计保持完全一样. 如果您曾经用过 Moment.js, 那么您已经知道如何使用 Day.js 简单地说，只要你会Moment.js，那么你就会Day.js! 但是我们知道的，Moment.js 的大小是200多k, Da
Day.js 1.8.7 发布，轻量级时间和日期 JavaScript 库
weixin_33836874的博客
02-25 136
Day.js 1.8.7 发布了。该版本更新内容是 Bug 的修复： 新增插件类型定义 (#418) (361d437) 新增斯瓦希里语 (#508) ...
js库——Day.js、Big.js
黎小小的博客
10-20 1785
Day.js 方便操作对时间解析 验证 对时间进行计算等操作。
day.js（时间）
ljlhah的博客
02-14 400
1. npm install dayjs 下载。
js日期处理库--dayjs
Cloud的专栏
08-09 1703
返回指定时间的开始或结束,这在某些日期查询里面很有用，比如查结束日期往往要传那天的23:59:59,就可以用endOf('day')来实现。这个功能在发布文章，发布消息时很有用，我们在看评论时可以看到发布在多少时间前，这个用day.js可以轻松实现。如果超出这个范围，它会进位到年份。使用format函数来格式化日期，支持的格式化字符见下表。接受1到31的数字。如果使用的是element plus,可以直接使用。返回增加一定时间的复制的 Day.js 对象。返回减去一定时间的复制的 Day.js 对象。
时间日期库dayjs 快速高效的处理时间日期的js库（轻量级，拿来就能用）
weixin_42354407的博客
06-03 864
NPM npm install dayjs --save import dayjs from 'dayjs' // 或者 CommonJS // var dayjs = require('dayjs'); dayjs().format(); CDN <!--压缩版dayjs--> <script src="https://unpkg.com/dayjs"></script> <script> dayjs().format(); </script&
Day.js - JavaScript时间处理库
weixin_33819479的博客
05-02 249
Day.js简介 　　在使用JavaScript处理时间方面，使用的时Moment.js，但是它太重了，有200多k，一般项目中可能也只是用了几个api而已，所以，这里推荐一个轻量的时间库 - Day.js。 github地址上 可以看到已经有将近7k的star，说明还是比较火的。下面就是使用的一个例子： dayjs().startOf('month').add(1, 'day').set...
dayjs使用
weixin_45353536的博客
03-06 2166
dayjs使用
dayjs官方文档
08-07
Day.js 是一个轻量级的 JavaScript 时间日期处理库，其官方文档提供了全面的 API 说明和使用示例。可以通过访问 Day.js 的官方网站来获取最新的官方文档：[https://day.js.org](https://day.js.org)[^1]。 在官方文档中，可以找到以下内容： - **安装和引入**：包括如何通过 npm 安装 Day.js，以及如何在浏览器或模块化项目中引入使用。 - **核心功能**：如日期解析、格式化、操作（增加或减少时间）、比较日期等功能的使用方法。 - **插件系统**：Day.js 支持一系列插件来扩展其功能，例如相对时间（`relativeTime`）、自定义区域设置（`localizedFormat`）等[^1]。 - **国际化支持**：文档中详细说明了如何配置和使用不同的语言包，以支持多语言环境。 以下是一个简单的 Day.js 使用示例： ```javascript // 引入 Day.js const dayjs = require('dayjs'); // 格式化日期 console.log(dayjs().format('YYYY-MM-DD HH:mm:ss')); // 输出当前时间，格式为年-月-日 时:分:秒 // 日期加减操作 const tomorrow = dayjs().add(1, 'day'); console.log(tomorrow.format('YYYY-MM-DD')); // 输出明天的日期 // 日期比较 const isAfter = dayjs('2023-09-01').isAfter('2023-08-01'); console.log(isAfter); // 输出 true ``` 如果需要更高级的功能，可以结合插件使用，例如： ```javascript // 引入 relativeTime 插件 const relativeTime = require('dayjs/plugin/relativeTime'); dayjs.extend(relativeTime); // 输出相对时间 console.log(dayjs().subtract(1, 'hour').fromNow()); // 输出 "an hour ago" ```
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值