Moment.js常见用法总结

╰+攻爆jí腚メ 2021-08-13 18:58 409阅读 0赞

> Moment.js是一个轻量级的JavaScript时间库，它方便了日常开发中对时间的操作，提高了开发效率。

日常开发中，通常会对时间进行下面这几个操作：比如**获取时间，设置时间，格式化时间，比较时间**等等。接下来，我将按照这些操作对Moment.js中的Doc进行整理分类，方便学习和日后的查阅。

### 获取时间 ###

*  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()
    
     *  获取当前月的总天数
        
            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')
            mment().get('weekday')
            moment().get('isoWeekday')
     *  获取小时
        
            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 ...}

### 设置时间 ###

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

### 格式化时间 ###

*  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') // 返回值为字符串类型

### 比较时间 ###

*  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

### 转化为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