目錄：
- 簡介
- 1、獲取時間
- 2、設置時間
- 3、格式化時間
- 4、比較時間
- 5、轉化為JavaScript原生Date對象
Moment.js是一個輕量級的JavaScript時間庫，它方便了日常開發中對時間的操作，提高了開發效率。
日常開發中，通常會對時間進行下面這幾個操作：比如獲取時間，設置時間，格式化時間，比較時間等等。接下來，我將按照這些操作對Moment.js中的Doc進行整理分類，方便學習和日后的查閱。
使用：下載、引入
import moment from 'moment';
import 'moment/locale/zh-cn';
1、獲取時間
- Start of Time
moment().startOf(String)
// 獲取今天0時0分0秒
moment().startOf('day')
// 獲取本周第一天(周日)0時0分0秒
moment().startOf('week')
// 獲取本周周一0時0分0秒
moment().startOf('isoWeek')
// 獲取當前月第一天0時0分0秒
moment().startOf('month')
- End of Time
moment().endOf(String)
// 獲取今天23時59分59秒
moment().endOf('day')
// 獲取本周最后一天(周六)23時59分59秒
moment().endOf('week')
// 獲取本周周日23時59分59秒
moment().endOf('isoWeek')
// 獲取當前月最后一天23時59分59秒
moment().endOf('month')
- Days in Month：獲取當前月的總天數
moment().daysInMonth()
- Timestamp：獲取時間戳
// 以秒為單位
moment().format('X') // 返回值為字符串類型
moment().unix() // 返回值為數值型
// 以毫秒為單位
moment().format('x') // 返回值為字符串類型
moment().valueOf() // 返回值為數值型
- Get Time
// 獲取年份
moment().year()
moment().get('year')
// 獲取月份
moment().month() (0~11, 0: January, 11: December)
moment().get('month')
// 獲取一個月中的某一天
moment().date()
moment().get('date')
// 獲取一個星期中的某一天
moment().day() (0~6, 0: Sunday, 6: Saturday)
moment().weekday() (0~6, 0: Sunday, 6: Saturday)
moment().isoWeekday() (1~7, 1: Monday, 7: Sunday)
moment().get('day')
moment().get('weekday')
moment().get('isoWeekday')
// 獲取年月日
moment().format('YYYY-MM-DD')
// 獲取時分秒
moment().format('HH:ss:mm')
// 獲取星期
moment(moment()).day() // 數字
// 獲取小時
moment().hours()
moment().get('hours')
// 獲取分鐘
moment().minutes()
moment().get('minutes')
// 獲取秒數
moment().seconds()
moment().get('seconds')
// 獲取當前的年月日時分秒
moment().toArray() // [years, months, date, hours, minutes, seconds, milliseconds]
moment().toObject() // {years: xxxx, months: x, date: xx ...}
2、設置時間
- Set Time
moment().year(Number), moment().month(Number)...
moment().set(String, Int)
moment().set(Object)
// 設置年份
moment().year(2019)
moment().set('year', 2019)
moment().set({year: 2019})
// 設置月份
moment().month(11) (0~11, 0: January, 11: December)
moment().set('month', 11)
// 設置某個月中的某一天
moment().date(15)
moment().set('date', 15)
// 設置某個星期中的某一天
moment().weekday(0) // 設置日期為本周第一天（周日）
moment().isoWeekday(1) // 設置日期為本周周一
moment().set('weekday', 0)
moment().set('isoWeekday', 1)
// 設置小時
moment().hours(12)
moment().set('hours', 12)
// 設置分鐘
moment().minutes(30)
moment().set('minutes', 30)
// 設置秒數
moment().seconds(30)
moment().set('seconds', 30)
- Add Time
moment().add(Number, String)
moment().add(Object)
// 設置年份
moment().add(1, 'years')
moment().add({years: 1})
// 設置月份
moment().add(1, 'months')
// 設置日期
moment().add(1, 'days')
// 設置星期
moment().add(1, 'weeks')
// 設置小時
moment().add(1, 'hours')
// 設置分鐘
moment().add(1, 'minutes')
// 設置秒數
moment().add(1, 'seconds')
- Subtract Time
moment().subtract(Number, String)
moment().subtract(Object)
// 設置年份
moment().subtract(1, 'years')
moment().subtract({years: 1})
// 設置月份
moment().subtract(1, 'months')
// 設置日期
moment().subtract(1, 'days')
// 設置星期
moment().subtract(1, 'weeks')
// 設置小時
moment().subtract(1, 'hours')
// 設置分鐘
moment().subtract(1, 'minutes')
// 設置秒數
moment().subtract(1, 'seconds')
3、格式化時間
- Format Time
moment().format()
moment().format(String)
// 格式化年月日： 'xxxx年xx月xx日'
moment().format('YYYY年MM月DD日')
// 格式化年月日： 'xxxx-xx-xx'
moment().format('YYYY-MM-DD')
// 格式化時分秒(24小時制)： 'xx時xx分xx秒'
moment().format('HH時mm分ss秒')
// 格式化時分秒(12小時制)：'xx:xx:xx am/pm'
moment().format('hh:mm:ss a')
// 格式化時間戳(以秒為單位)
moment().format('X') // 返回值為字符串類型
// 格式化時間戳(以毫秒為單位)
moment().format('x') // 返回值為字符串類型
4、比較時間
- Difference
moment().diff(Moment|String|Number|Date|Array)
// 獲取兩個日期之間的時間差
let start_date = moment().subtract(1, 'weeks')
let end_date = moment()
end_date.diff(start_date) // 返回毫秒數
end_date.diff(start_date, 'months') // 0
end_date.diff(start_date, 'weeks') // 1
end_date.diff(start_date, 'days') // 7
start_date.diff(end_date, 'days') // -7
- isAfter：檢查某個時刻是否在另一個時刻之后
let bool = moment('2010-10-20').isAfter('2010-10-21') // false
let bool = moment('2019-10-20').isAfter('2010-12-31', 'year') // true
- isBefore：檢查某個時刻是否在另一個時刻之前
let bool = moment('2010-10-20').isBefore('2010-10-21') // true
let bool = moment('2010-10-20').isBefore('2010-12-31', 'year') // false
let bool = current.isBefore(moment(startDate, 'MM/DD/YYYY').format('YYYY-MM-DD'))
5、轉化為JavaScript原生Date對象
moment().toDate()
new Date(moment())
// 將Moment時間轉換為JavaScript原生Date對象
let m = moment()
let nativeDate1 = m.toDate()
let nativeDate2 = new Date(m)
String(nativeDate1) === String(nativeDate2) // true
參考文件：官網
參考文件：Moment.js常見用法總結
參考文件：isbefore
參考文件：isafter
