Skip to content
Day.js

简体中文

English
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

简体中文

English
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

主题

Sidebar Navigation

安装

Node.js

浏览器

TypeScript

下载

解析

当前时间

字符串

字符串 + 格式

Unix 时间戳 (毫秒)

Unix 时间戳(秒)

Date 对象

对象

数组

UTC

Day.js 克隆

验证

获取和设置

毫秒

秒

分钟

小时

日期

星期几

星期几(本地化感知)

ISO 星期几

一年中的天数

一年中的第几周

ISO 周数

月份

季度

年

周年份

ISO 周年份

一年中的 ISO 周数

获取

设置

最大值(最晚的时间)

最小值(最早的时间)

操作

添加时间

减去时间

时间单位的起点

时间单位的结束

本地化时间

UTC

UTC 偏移量

展示

格式化

从现在开始的时间

从 X 开始的时间

距离当前时间的相对时间

相对于 X 的时间

日历时间

差异

Unix 时间戳(毫秒)

Unix 时间戳

当月天数

转换为 JavaScript Date

转换为数组

转换为 JSON

ISO 8601 字符串格式

转换为对象

转换为字符串

查询方法

是否早于

是否相同

是否晚于

是否相同或更早

是否相同或之后

是否在两个时间之间

是否为 Day.js 对象

闰年判断

i18n (国际化)

在 NodeJS 中加载区域设置

在浏览器中加载区域设置

全局更改语言环境

局部更改区域设置

获取当前 Day.js 实例的语言环境

列出当前区域设置的月份和星期

访问区域设置相关的功能

插件

在 Node.js 中加载插件

在浏览器中加载插件

AdvancedFormat

ArraySupport

BadMutable

BigIntSupport

BuddhistEra(佛历)

日历

CustomParseFormat

DayOfYear

DevHelper

Duration

IsBetween

IsLeapYear

IsSameOrAfter

IsSameOrBefore

IsToday

IsTomorrow

IsYesterday

IsoWeek

IsoWeeksInYear

LocaleData

LocalizedFormat

MinMax

ObjectSupport

PluralGetSet

PreParsePostFormat

QuarterOfYear

RelativeTime

时区

ToArray

ToObject

UpdateLocale

UTC

weekOfYear

WeekYear

星期几

自定义

月份名称

月份缩写

星期几名称

星期缩写

最小星期缩写

相对时间

日历

时长

创建

克隆

转换为易读时间

格式化

毫秒

秒

分钟

小时

天

周

月份

年份

添加时间

减少时间

使用 Duration 和 Diff

以指定单位获取时长

获取指定时间单位的时长

转换为 JSON

判断是否为 Duration 对象

作为 ISO 8601 字符串

语言环境

时区

在指定时区中解析

转换为时区

获取用户时区

设置默认时区

页面导航

格式化 ​

根据传入的格式字符串,获取格式化后的日期字符串。

要转义字符,请将其括在方括号中(例如 [MM])。

js
dayjs().format();
// 当前日期,采用 ISO8601 格式,例如 '2020-04-02T08:02:17-05:00',不包含毫秒。

dayjs('2019-01-25').format('[YYYYescape] YYYY-MM-DDTHH:mm:ssZ[Z]');
// 'YYYYescape 2019-01-25T00:00:00-02:00Z'

dayjs('2019-01-25').format('DD/MM/YYYY'); // '25/01/2019'

所有可用格式列表 ​

格式输出描述
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小时数(24 小时制)
HH00-23小时数(24 小时制),两位数字
h1-12小时数(12 小时制)
hh01-12小时数(12 小时制),两位数字
m0-59分钟数
mm00-59分钟数,两位数字
s0-59秒数
ss00-59秒数,两位数字
SSS000-999毫秒数,三位数字
Z+05:00与 UTC 的时差,格式为 ±HH:mm
ZZ+0500与 UTC 的时差,格式为 ±HHmm
AAM PM上午/下午 (AM/PM)
aam pm上午/下午 (am/pm)
......其他格式(取决于 AdvancedFormat 插件)
  • 更多可用格式,例如 Q Do k kk X x ...,请参考 AdvancedFormat 插件。

本地化格式 ​

由于不同地区/语言环境的日期格式偏好不同,可以使用一些基于特定地区/语言环境的本地化格式令牌。

TIP

这需要 LocalizedFormat 插件才能正常工作

javascript
dayjs.extend(LocalizedFormat);
dayjs().format('L LT');

本地化格式的列表 ​

格式英语(美国)示例输出
LTh:mm A8:02 PM
LTSh:mm:ss A8:02:18 PM
LMM/DD/YYYY08/16/2018
LLMMMM D, YYYYAugust 16, 2018
LLLMMMM D, YYYY h:mm AAugust 16, 2018 8:02 PM
LLLLdddd, MMMM D, YYYY h:mm AThursday, August 16, 2018 8:02 PM
lM/D/YYYY8/16/2018
llMMM D, YYYYAug 16, 2018
lllMMM D, YYYY h:mm AAug 16, 2018 8:02 PM
llllddd, MMM D, YYYY h:mm AThu, Aug 16, 2018 8:02 PM
Pager
上一页展示
下一页从现在开始的时间

基于 MIT 许可证 发布。

版权所有 (c) 2020 iamkun

https://day.js.org/docs/en/display/format

基于 MIT 许可证 发布。

版权所有 (c) 2020 iamkun