moment
是一个使用非常方便的 Node.js 模块,可以帮助我们处理和格式化日期和时间。这里就来总结一下moment的常见用法。
首先是安装:
npm i moment
其次是引入:
const moment = require('moment'); //common.js 模式
//或者ES6模式: import moment from 'moment'
基本用法
Moment.js中文文档系列之八时间段(Durations)
创建时间段:duration()
人性化:humanize()
毫秒:milliseconds()
秒:seconds()
分:minutes()
小时:hours()
天:days()
月:months()
年:years()
增加时间:add()
减少时间:subtract()
单位转换:as()
取值:get()
转换为JSON:toJSON()
是否时间段:isDuration()
Moment.js
中也有时间段对象。一个时间moment
被定义为一个单点时刻,而时间段被定义为一个时间长度。
时间段没有定义开始和结束时间,它们是一种前后的关系。一个时间段更类似于“2小时”,而不是“今天下午的2点到4点之间”。
例如,一年可以被定义为366天、365天、365.25天、12个月或52周。计算两个时间之间的天或年时,使用moment#diff 比使用Durations
更好。
duration()
moment.duration(Number, String);
moment.duration(Number);
moment.duration(Object);
moment.duration(String);
创建一个时间段,通过moment.duration()
方法并传入一个毫秒级的时间戳。
moment.duration(100); // 100 毫秒
如果你想在创建时间段时使用非毫秒级的单位,你可以像这样传入时间单位:
moment.duration(2, 'seconds');
moment.duration(2, 'minutes');
moment.duration(2, 'hours');
moment.duration(2, 'days');
moment.duration(2, 'weeks');
moment.duration(2, 'months');
moment.duration(2, 'years');
在moment#add
和moment#subtract
方法中使用简写形式在这儿也同样适用。
years | y |
months | M |
weeks | w |
days | d |
hours | h |
minutes | m |
seconds | s |
milliseconds | ms |
像moment#add
一样,你可以按需要传入一个包含多个单位的对象。
moment.duration({
seconds: 2,
minutes: 2,
hours: 2,
days: 2,
weeks: 2,
months: 2,
years: 2
});
格式是一个以冒号分隔的时、分、秒的字符串,如23:59:59
。表示天的数字,使用点号分隔,如7.23:59:59
。秒的部分还支持这样23:59:59.999
。
moment.duration('23:59:59');
moment.duration('23:59:59.999');
moment.duration('7.23:59:59.999');
moment.duration('23:59'); //added in 2.3.0
2. 人性化:humanize()
moment.duration().humanize();
有时,你想像moment#from一样友好显示,但不想创建两个时间。
moment.duration(1, "minutes").humanize(); // a minute
moment.duration(2, "minutes").humanize(); // 2 minutes
moment.duration(24, "hours").humanize(); // a day
默认,其返回值是无后缀的。如果需要带后,可以传一个参数。
moment.duration(1, "minutes").humanize(true); // in a minute
如果是相对当前时间的前缀,可以传入一个负数。
moment.duration(-1, "minutes").humanize(true); // a minute ago
3. 毫秒:milliseconds()
moment.duration().milliseconds();
moment.duration().asMilliseconds();
获取一个数字表示的毫秒数,使用moment.duration().milliseconds()
,其返回是一个0〜999之间的数字。
moment.duration(500).milliseconds(); // 500
moment.duration(1500).milliseconds(); // 500
moment.duration(15000).milliseconds(); // 0
如果要获取的是一个毫秒级的时间段长度,使用moment.duration().asMilliseconds()
方法代替。
moment.duration(500).asMilliseconds(); // 500
moment.duration(1500).asMilliseconds(); // 1500
moment.duration(15000).asMilliseconds(); // 15000
4. 秒:seconds()
moment.duration().seconds();
moment.duration().asSeconds();
获取一个数字表示的秒数,使用moment.duration().seconds()
,其返回是一个0〜59之间的数字。
moment.duration(500).seconds(); // 0
moment.duration(1500).seconds(); // 1
moment.duration(15000).seconds(); // 15
如果要获取的是一个秒级的时间段长度,使用moment.duration().asSeconds()
方法代替。
moment.duration(500).asSeconds(); // 0.5
moment.duration(1500).asSeconds(); // 1.5
moment.duration(15000).asSeconds(); // 15
5. 分:minutes()
moment.duration().minutes();
moment.duration().asMinutes();
获取其它的时间段,moment.duration().minutes()
可以获取分钟数(0〜59),moment.duration().asMinutes()
可以获取表示分的长度。
hours()
moment.duration().hours();
moment.duration().asHours();
获取其它的时间段,moment.duration().hours()
可以获取小时数(0〜23),moment.duration().asHours()
可以获取表示小时的长度。
days()
moment.duration().days();
moment.duration().asDays();
获取其它的时间段,moment.duration().days()
可以获取天数(0〜23),moment.duration().asHours()
可以获取表示天的长度。
months()
moment.duration().months();
moment.duration().asMonths();
获取其它的时间段,moment.duration().months()
可以获取月数(0〜11),moment.duration().asMonths()
可以获取表示月的长度。
注意:一月的时间长度被定义为30天。
9. 年:years()
moment.duration().years();
moment.duration().asYears();
获取其它的时间段,moment.duration().years()
可以获取年份,moment.duration().asYears()
可以获取表示年的长度。
注意:一年的时间长度被定义为365天。
10. 增加时间:add()
moment.duration().add(Number, String);
moment.duration().add(Number);
moment.duration().add(Duration);
moment.duration().add(Object);
对原时间段增加时间。
在创建时间段时使用的简写形式的时间单位,在这里也同样适用。可以第二个参数中传入。
var a = moment.duration(1, 'd');
var b = moment.duration(2, 'd');
a.add(b).days(); // 3
11. 减少时间:subtract()
moment.duration().subtract(Number, String);
moment.duration().subtract(Number);
moment.duration().subtract(Duration);
moment.duration().subtract(Object);
对原时间段减少时间。
在创建时间段时使用的简写形式的时间单位,在这里也同样适用。可以第二个参数中传入。
var a = moment.duration(3, 'd');
var b = moment.duration(2, 'd');
a.subtract(b).days(); // 1
12. 单位转换:as()
moment.duration().as(String);
替换Duration#asX
等方法,可以使用Duration#as('x')
,moment#add中使用的单位简写,在这里也同样适用。
duration.as('hours');
duration.as('minutes');
duration.as('seconds');
duration.as('milliseconds');
13. 取值:get()
moment.duration().get(String);
替换Duration#x
等方法,可以使用Duration#get('x')
,moment#add中使用的单位简写,在这里也同样适用。
duration.get('hours');
duration.get('minutes');
duration.get('seconds');
duration.get('milliseconds');
14. 转换为JSON:toJSON()
moment.duration().toJSON();
将时间段对象序列化成JSON时,其会按ISO8601标准的字符串进行转换。
JSON.stringify({
postDuration : moment.duration(5, 'm')
}); // '{"postDuration":"PT5M"}'
15. 是否时间段:isDuration()
moment.isDuration(obj);
检查是否是一个有效的时间段对象,使用moment.isDuration()
moment.isDuration() // false
moment.isDuration(new Date()) // false
moment.isDuration(moment()) // false
moment.isDuration(moment.duration()) // true
moment.isDuration(moment.duration(2, 'minutes')) // true
总结 :
moment.duration(now()) 获取当前时间
moment.duration(now()).asHours() //获取当前时间的小时时间段
asMilliseconds()//毫秒
asSeconds()//秒
asMinutes()//分
asHours()//时
asDays()//天
asMonths()//月
asYears()//年
不加 as 的时候,是获取时间值
附:
一个使用 moment
模块计算时间差的示例:
const moment = require('moment');
const start = moment('2023-05-01 09:00:00', 'YYYY-MM-DD HH:mm:ss');
const end = moment();
const diff = end.diff(start);
console.log(moment.duration(diff).asMinutes()); // 输出两个时间之间间隔的分钟数
在这个示例中,首先引入了 moment
模块,并使用 moment()
方法创建了两个日期对象 start
和 end
。其中,start
表示起始日期和时间,使用 moment()
方法可以从标准的日期字符串或 JavaScript Date 对象创建日期对象。end
则表示当前时间,通过直接调用moment()
创建当前时间的日期对象。
然后,使用 diff()
方法计算 end
和 start
之间的时间差,将结果保存到变量 diff
中。接着,将 diff
传递给 duration()
方法,创建一个持续时间对象,并使用 asMinutes()
方法获取该持续时间以分钟为单位的值。
最后,将两个时间之间的间隔分钟数输出到控制台上。