Moment.js常見用法總結(jié)

Moment.js是一個(gè)輕量級(jí)的JavaScript時(shí)間庫(kù)，它方便了日常開發(fā)中對(duì)時(shí)間的操作，提高了開發(fā)效率。

? 日常開發(fā)中轿塔，通常會(huì)對(duì)時(shí)間進(jìn)行下面這幾個(gè)操作：比如獲取時(shí)間，設(shè)置時(shí)間请垛，格式化時(shí)間催训，比較時(shí)間等等。接下來(lái)宗收，我將按照這些操作對(duì)Moment.js中的Doc進(jìn)行整理分類，方便學(xué)習(xí)和日后的查閱亚兄。

獲取時(shí)間

• Start of Time

  moment().startOf(String)
  

  • 獲取今天0時(shí)0分0秒

    moment().startOf('day')
    

  • 獲取本周第一天(周日)0時(shí)0分0秒

    moment().startOf('week')
    

  • 獲取本周周一0時(shí)0分0秒

    moment().startOf('isoWeek')
    

  • 獲取當(dāng)前月第一天0時(shí)0分0秒

    moment().startOf('month')
    

• End of Time

  moment().endOf(String)
  

  • 獲取今天23時(shí)59分59秒

    moment().endOf('day')
    

  • 獲取本周最后一天(周六)23時(shí)59分59秒

    moment().endOf('week')
    

  • 獲取本周周日23時(shí)59分59秒

    moment().endOf('isoWeek')
    

  • 獲取當(dāng)前月最后一天23時(shí)59分59秒

    moment().endOf('month')
    

• Days in Month

  moment().daysInMonth()
  

  • 獲取當(dāng)前月的總天數(shù)

    moment().daysInMonth() 
    

• Timestamp

  • 獲取時(shí)間戳(以秒為單位)

  moment().format('X') // 返回值為字符串類型
  moment().unix() // 返回值為數(shù)值型
  

  • 獲取時(shí)間戳(以毫秒為單位)

  moment().format('x') // 返回值為字符串類型
  moment().valueOf() // 返回值為數(shù)值型
  

• Get Time

  • 獲取年份

    moment().year()
    moment().get('year')
    

  • 獲取月份

    moment().month() (0~11, 0: January, 11: December)
    moment().get('month')
    

  • 獲取一個(gè)月中的某一天

    moment().date()
    moment().get('date')
    

  • 獲取一個(gè)星期中的某一天

    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')
    mment().get('weekday')
    moment().get('isoWeekday')
    

  • 獲取小時(shí)

    moment().hours()
    moment().get('hours')
    

  • 獲取分鐘

    moment().minutes()
    moment().get('minutes')
    

  • 獲取秒數(shù)

    moment().seconds()
    moment().get('seconds')
    

  • 獲取當(dāng)前的年月日時(shí)分秒

    moment().toArray() // [years, months, date, hours, minutes, seconds, milliseconds]
    moment().toObject() // {years: xxxx, months: x, date: xx ...}
    

設(shè)置時(shí)間

• Set Time

  moment().year(Number), moment().month(Number)...
  moment().set(String, Int)
  moment().set(Object)
  

  • 設(shè)置年份

    moment().year(2019)
    moment().set('year', 2019)
    moment().set({year: 2019})
    

  • 設(shè)置月份

    moment().month(11) (0~11, 0: January, 11: December)
    moment().set('month', 11) 
    

  • 設(shè)置某個(gè)月中的某一天

    moment().date(15)
    moment().set('date', 15)
    

  • 設(shè)置某個(gè)星期中的某一天

    moment().weekday(0) // 設(shè)置日期為本周第一天（周日）
    moment().isoWeekday(1) // 設(shè)置日期為本周周一
    moment().set('weekday', 0)
    moment().set('isoWeekday', 1)
    

  • 設(shè)置小時(shí)

    moment().hours(12)
    moment().set('hours', 12)
    

  • 設(shè)置分鐘

    moment().minutes(30)
    moment().set('minutes', 30)
    

  • 設(shè)置秒數(shù)

    moment().seconds(30)
    moment().set('seconds', 30)
    

• Add Time

  moment().add(Number, String)
  moment().add(Object)
  

  • 設(shè)置年份

    moment().add(1, 'years')
    moment().add({years: 1})
    

  • 設(shè)置月份

    moment().add(1, 'months')
    

  • 設(shè)置日期

    moment().add(1, 'days')
    

  • 設(shè)置星期

    moment().add(1, 'weeks')
    

  • 設(shè)置小時(shí)

    moment().add(1, 'hours')
    

  • 設(shè)置分鐘

    moment().add(1, 'minutes')
    

  • 設(shè)置秒數(shù)

    moment().add(1, 'seconds')
    

• Subtract Time

  moment().subtract(Number, String)
  moment().subtract(Object)
  

  • 設(shè)置年份

    moment().subtract(1, 'years')
    moment().subtract({years: 1})
    

  • 設(shè)置月份

    moment().subtract(1, 'months')
    

  • 設(shè)置日期

    moment().subtract(1, 'days')
    

  • 設(shè)置星期

    moment().subtract(1, 'weeks')
    

  • 設(shè)置小時(shí)

    moment().subtract(1, 'hours')
    

  • 設(shè)置分鐘

    moment().subtract(1, 'minutes')
    

  • 設(shè)置秒數(shù)

    moment().subtract(1, 'seconds')
    

格式化時(shí)間

• Format Time

  moment().format()
  moment().format(String)
  

  • 格式化年月日： 'xxxx年xx月xx日'

    moment().format('YYYY年MM月DD日')
    

  • 格式化年月日： 'xxxx-xx-xx'

    moment().format('YYYY-MM-DD')
    

  • 格式化時(shí)分秒(24小時(shí)制)： 'xx時(shí)xx分xx秒'

    moment().format('HH時(shí)mm分ss秒')
    

  • 格式化時(shí)分秒(12小時(shí)制)：'xx:xx:xx am/pm'

    moment().format('hh:mm:ss a')
    

  • 格式化時(shí)間戳(以秒為單位)

    moment().format('X') // 返回值為字符串類型
    

  • 格式化時(shí)間戳(以毫秒為單位)

    moment().format('x') // 返回值為字符串類型
    

比較時(shí)間

• Difference

  moment().diff(Moment|String|Number|Date|Array)
  

  • 獲取兩個(gè)日期之間的時(shí)間差

    let start_date = moment().subtract(1, 'weeks')
    let end_date = moment()
    
    end_date.diff(start_date) // 返回毫秒數(shù)
    
    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
    

轉(zhuǎn)化為JavaScript原生Date對(duì)象

moment().toDate()
new Date(moment())

• 將Moment時(shí)間轉(zhuǎn)換為JavaScript原生Date對(duì)象

  let m = moment()
  let nativeDate1 = m.toDate()
  let nativeDate2 = new Date(m)
  
  String(nativeDate1) === String(nativeDate2) // true
  

實(shí)戰(zhàn)

• 獲取昨日0時(shí)0分0秒到昨日23時(shí)59分59秒混稽， 格式：[milliseconds, milliseconds]

• 獲取上周一到上周日時(shí)間范圍，格式: [seconds, seconds]

• 獲取上個(gè)月第一天和最后一天時(shí)間范圍审胚， 格式：[YYYY-MM-DD, YYYY-MM-DD]