moment.js 使用方法总结

谁借莪１个温暖的怀抱￠ 2022-09-16 15:27 208阅读 0赞

**目录**

一、引入moment.js

1.Node.js方式引入 (｡◝‿◜｡)

2.浏览器方式引入 ლ(╹◡╹ლ )

二、设定moment区域为中国

三、使用

1.获取时间 Ⴚ(●ტ●)Ⴢ

2.设置时间 ︶ε╰✿

3.格式化时间 =≡Σ((( つ•̀ω•́)つ

4.比较时间 (◍'౪\`◍)ﾉﾞ

5.转化为JavaScript原生Date对象 ✿◡‿◡

6.日期格式化 ʅ(‾◡◝)ʃ 输出实例

7.相对时间 (◕ܫ◕) 输出实例

8.日历时间 (๑¯ิε ¯ิ๑) 输出实例

9.多语言支持 (๑´ڡ\`๑) 输出实例

10.其它实用技巧 (•‾̑⌣‾̑•)✧˖° 输出实例：

--------------------

Moment.js是一个轻量级的JavaScript时间库，它方便了日常开发中对时间的操作，提高了开发效率。日常开发中，通常会对时间进行下面这几个操作：比如获取时间，设置时间，格式化时间，比较时间等等。下面就是我对moment.js使用过程中的整理，方便以后查阅。

[回到顶部][Link 1]

## 一、引入moment.js ##

### 1.Node.js方式引入 (｡◝‿◜｡) ###

（1）安装

`npm install moment` 或者 `yarn add moment`

（2）引入

// require 方式
    var moment = require('moment');
    
    // import 方式
    import moment from 'moment';

### 2.浏览器方式引入 ლ(╹◡╹ლ ) ###

`<script src="moment.js"></script>`

[回到顶部][Link 1]

## 二、设定moment区域为中国 ##

// require 方式
    require('moment/locale/zh-cn')
    moment.locale('zh-cn'); 
    
    // import 方式
    import 'moment/locale/zh-cn'
    moment.locale('zh-cn');

[回到顶部][Link 1]

## 三、使用 ##

### 1.获取时间 Ⴚ(●ტ●)Ⴢ ###

（1）获取当前时间

moment()

（2）获取今天0时0分0秒

moment().startOf('day')

（3）获取本周第一天(周日)0时0分0秒

moment().startOf('week')

（4）获取本周周一0时0分0秒

moment().startOf('isoWeek')

（5）获取当前月第一天0时0分0秒

moment().startOf('month')

（6）获取今天23时59分59秒

moment().endOf('day')

（7）获取本周最后一天(周六)23时59分59秒

moment().endOf('week')

（8）获取本周周日23时59分59秒

moment().endOf('isoWeek')

（9）获取当前月最后一天23时59分59秒

moment().endOf('month')

（10）获取当前月的总天数

moment().daysInMonth()

（11）获取时间戳(以秒为单位)

moment().format('X') // 返回值为字符串类型
    moment().unix() // 返回值为数值型

（12）获取时间戳(以毫秒为单位)

moment().format('x') // 返回值为字符串类型
    moment().valueOf() // 返回值为数值型

（13）获取年份

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

（14）获取月份

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

（15）获取一个月中的某一天

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

（16）获取一个星期中的某一天

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')

（17）获取小时

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

（18）获取分钟

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

（19）获取秒数

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

（20）获取当前的年月日时分秒

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

### 2.设置时间 ︶ε╰✿ ###

（1）设置年份

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

（2）设置月份

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

（3）设置某个月中的某一天

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

（4）设置某个星期中的某一天

moment().weekday(0) // 设置日期为本周第一天（周日）
    moment().isoWeekday(1) // 设置日期为本周周一
    moment().set('weekday', 0)
    moment().set('isoWeekday', 1)

（5）设置小时

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

（6）设置分钟

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

（7）设置秒数

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

（8）年份+1

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

（9）月份+1

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

（10）日期+1

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

（11）星期+1

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

（12）小时+1

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

（13）分钟+1

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

（14）秒数+1

moment().add(1, 'seconds')
    #### （15）年份-1
    ```js
    moment().subtract(1, 'years')
    moment().subtract({years: 1})

（16）月份-1

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

（17）日期-1

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

（18）星期-1

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

（19）小时-1

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

（20）分钟-1

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

（21）秒数-1

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

### 3.格式化时间 =≡Σ((( つ•̀ω•́)つ ###

<table> 
 <thead> 
  <tr> 
   <th>格式代码</th> 
   <th>说明</th> 
   <th>返回值例子</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>M</td> 
   <td>数字表示的月份，没有前导零</td> 
   <td>1到12</td> 
  </tr> 
  <tr> 
   <td>MM</td> 
   <td>数字表示的月份，有前导零</td> 
   <td>01到12</td> 
  </tr> 
  <tr> 
   <td>MMM</td> 
   <td>三个字母缩写表示的月份</td> 
   <td>Jan到Dec</td> 
  </tr> 
  <tr> 
   <td>MMMM</td> 
   <td>月份，完整的文本格式</td> 
   <td>January到December</td> 
  </tr> 
  <tr> 
   <td>Q</td> 
   <td>季度</td> 
   <td>1到4</td> 
  </tr> 
  <tr> 
   <td>D</td> 
   <td>月份中的第几天，没有前导零</td> 
   <td>1到31</td> 
  </tr> 
  <tr> 
   <td>DD</td> 
   <td>月份中的第几天，有前导零</td> 
   <td>01到31</td> 
  </tr> 
  <tr> 
   <td>d</td> 
   <td>星期中的第几天，数字表示</td> 
   <td>0到6，0表示周日，6表示周六</td> 
  </tr> 
  <tr> 
   <td>ddd</td> 
   <td>三个字母表示星期中的第几天</td> 
   <td>Sun到Sat</td> 
  </tr> 
  <tr> 
   <td>dddd</td> 
   <td>星期几，完整的星期文本</td> 
   <td>从Sunday到Saturday</td> 
  </tr> 
  <tr> 
   <td>w</td> 
   <td>年份中的第几周</td> 
   <td>如42：表示第42周</td> 
  </tr> 
  <tr> 
   <td>YYYY</td> 
   <td>四位数字完整表示的年份</td> 
   <td>如：2014 或 2000</td> 
  </tr> 
  <tr> 
   <td>YY</td> 
   <td>两位数字表示的年份</td> 
   <td>如：14 或 98</td> 
  </tr> 
  <tr> 
   <td>A</td> 
   <td>大写的AM PM</td> 
   <td>AM PM</td> 
  </tr> 
  <tr> 
   <td>a</td> 
   <td>小写的am pm</td> 
   <td>am pm</td> 
  </tr> 
  <tr> 
   <td>HH</td> 
   <td>小时，24小时制，有前导零</td> 
   <td>00到23</td> 
  </tr> 
  <tr> 
   <td>H</td> 
   <td>小时，24小时制，无前导零</td> 
   <td>0到23</td> 
  </tr> 
  <tr> 
   <td>hh</td> 
   <td>小时，12小时制，有前导零</td> 
   <td>00到12</td> 
  </tr> 
  <tr> 
   <td>h</td> 
   <td>小时，12小时制，无前导零</td> 
   <td>0到12</td> 
  </tr> 
  <tr> 
   <td>m</td> 
   <td>没有前导零的分钟数</td> 
   <td>0到59</td> 
  </tr> 
  <tr> 
   <td>mm</td> 
   <td>有前导零的分钟数</td> 
   <td>00到59</td> 
  </tr> 
  <tr> 
   <td>s</td> 
   <td>没有前导零的秒数</td> 
   <td>1到59</td> 
  </tr> 
  <tr> 
   <td>ss</td> 
   <td>有前导零的描述</td> 
   <td>01到59</td> 
  </tr> 
  <tr> 
   <td>X</td> 
   <td>Unix时间戳</td> 
   <td>1411572969</td> 
  </tr> 
 </tbody> 
</table>

（1）格式化年月日： 'xxxx年xx月xx日'

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

（2）格式化年月日： 'xxxx-xx-xx'

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

（3）格式化时分秒(24小时制)： 'xx时xx分xx秒'

moment().format('HH时mm分ss秒')

（4）格式化时分秒(12小时制)：'xx:xx:xx am/pm'

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

（5）格式化时间戳(以毫秒为单位)

moment().format('x') // 返回值为字符串类型

### 4.比较时间 (◍'౪\`◍)ﾉﾞ ###

（1）获取两个日期之间的时间差

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

### 5.转化为JavaScript原生Date对象 ✿◡‿◡ ###

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

### 6.日期格式化 ʅ(‾◡◝)ʃ 输出实例 ###

moment().format('MMMM Do YYYY, h:mm:ss a'); // 五月 24日 2019, 7:47:43 晚上
    moment().format('dddd');                    // 星期五
    moment().format("MMM Do YY");               // 5月 24日 19
    moment().format('YYYY [escaped] YYYY');     // 2019 escaped 2019
    moment().format();                          // 2019-05-24T19:47:43+08:00

### 7.相对时间 (◕ܫ◕) 输出实例 ###

moment("20111031", "YYYYMMDD").fromNow(); // 8 年前
    moment("20120620", "YYYYMMDD").fromNow(); // 7 年前
    moment().startOf('day').fromNow();        // 20 小时前
    moment().endOf('day').fromNow();          // 4 小时内
    moment().startOf('hour').fromNow();       // 1 小时前

### 8.日历时间 (๑¯ิε ¯ิ๑) 输出实例 ###

moment().subtract(10, 'days').calendar(); // 2019年5月14日
    moment().subtract(6, 'days').calendar();  // 上周六晚上7点49
    moment().subtract(3, 'days').calendar();  // 本周二晚上7点49
    moment().subtract(1, 'days').calendar();  // 昨天晚上7点49分
    moment().calendar();                      // 今天晚上7点49分
    moment().add(1, 'days').calendar();       // 明天晚上7点49分
    moment().add(3, 'days').calendar();       // 下周一晚上7点49
    moment().add(10, 'days').calendar();      // 2019年6月3日

### 9.多语言支持 (๑´ڡ\`๑) 输出实例 ###

moment().format('L');    // 2019-05-24
    moment().format('l');    // 2019-05-24
    moment().format('LL');   // 2019年5月24日
    moment().format('ll');   // 2019年5月24日
    moment().format('LLL');  // 2019年5月24日晚上7点50分
    moment().format('lll');  // 2019年5月24日晚上7点50分
    moment().format('LLLL'); // 2019年5月24日星期五晚上7点50分
    moment().format('llll'); // 2019年5月24日星期五晚上7点50分

### 10.其它实用技巧 (•‾̑⌣‾̑•)✧˖° 输出实例： ###

moment().format("YYYY-MM-DD") // 格式化显示当前时间
    `${moment().subtract("month", +1).format("YYYY-MM")}-01` // 上一个月的1号
    `${moment().add("month", -1).format("YYYY-MM")}-01`  // 还是上一个月1号 
    let M = `${moment().format("YYYY-MM")}-01` // 本月一号
    moment(M).add("days", -1).format("YYYY-MM-DD") // 上一个月月底 
    moment().startOf("year").format("YYYY-MM-DD")  // 本年的的开始日期，（"2019-01-01"）
    moment().endOf("year").format("YYYY-MM-DD")  // 本年的的结束日期，（"2019-12-31"）
    // moment 转成时间戳
    moment().valueOf()
    // 时间戳 转 moment
    moment(string).format()
    
    // 解决Moment格式化时间出现时区差的问题
    // `utcOffset()` 接收数字，时间偏移量，单位：分钟
    // 北京时间东八区时间，比零时区早8个小时（480分钟），所以应该加上480分钟
    Moment(date).utcOffset(480).format('YYYY-MM-DD HH:mm:ss');

更多可参见官方文档：[文档 | Moment.js 中文网][_ Moment.js]

[Link 1]: https://www.cnblogs.com/MrZhujl/p/11398704.html#_labelTop
[_ Moment.js]: http://momentjs.cn/docs/