轉載自? ?dayjs

API

Dayjs?并沒有改變或覆蓋 Javascript 原生的?Date.prototype， 而是創造了一個全新的包含?Javascript Date?對象的?Dayjs的對象。

Dayjs?對象是不可變的, 所有的 API 操作都將返回一個新的?Dayjs?對象。

• 解析
  • 當前時間
  • 時間字符串
  • Unix 時間戳 (毫秒)
  • Date 對象
  • 復制
  • 驗證
• 獲取+設置
  • 年
  • 月
  • 日
  • 星期
  • 時
  • 分
  • 秒
  • 毫秒
  • 設置
• 操作
  • 增加
  • 減少
  • 開頭時間
  • 末尾時間
• 顯示
  • 格式化
  • 時間差
  • Unix 時間戳 (毫秒)
  • Unix 時間戳 (秒)
  • 天數 (月)
  • Date 對象
  • 數組
  • JSON
  • ISO 8601 字符串
  • 對象
  • 字符串
• 查詢
  • 是否之前
  • 是否相同
  • 是否之后
  • 是否是 Dayjs?.isDayjs()
• 插件 APIs
  • 相對時間
  • 是否是閏年
  • 年中的第幾周
  • 是否之間

---

如果沒有特別說明，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	?	日期
day	d	星期幾 (星期天 0, 星期六 6)
month	M	月
year	y	年
hour	h	時
minute	m	分
second	s	秒
millisecond	ms	毫秒

---

操作

您可以對?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

YY	18	兩位數的年份
YYYY	2018	四位數的年份
M	1-12	月份，從 1 開始
MM	01-12	月份，兩位數
MMM	Jan-Dec	簡寫的月份名稱
MMMM	January-December	完整的月份名稱
D	1-31	月份里的一天
DD	01-31	月份里的一天，兩位數
d	0-6	一周中的一天，星期天是 0
dd	Su-Sa	最簡寫的一周中一天的名稱
ddd	Sun-Sat	簡寫的一周中一天的名稱
dddd	Sunday-Saturday	一周中一天的名稱
H	0-23	小時
HH	00-23	小時，兩位數
m	0-59	分鐘
mm	00-59	分鐘，兩位數
s	0-59	秒
ss	00-59	秒 兩位數
SSS	000-999	秒 三位數
Z	+5:00	UTC 的偏移量
ZZ	+0500	UTC 的偏移量，數字前面加上 0
A	AM PM	?
a	am 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?返回一個時間是否介于兩個時間之間

總結

以上是生活随笔為你收集整理的dayjs​​​​​​​文档的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。