MoMent时间工具类(JS)的基本使用

MoMent的基本使用

以下是 Moment.js 的所有 API 及其参数介绍,按照功能分类,方便查阅。其中,参数类型为 Moment 表示参数应该是一个 Moment 对象,String 表示参数应该是一个字符串,Object 表示参数应该是一个对象,Number 表示参数应该是一个数字。

创建 Moment 对象
方法名参数说明
moment()返回当前时间的 Moment 对象
moment(String)String根据字符串创建 Moment 对象
moment(String, String)String, String根据字符串和格式创建 Moment 对象
moment(Moment)Moment根据另一个 Moment 对象创建 Moment 对象
获取和设置 Moment 对象的值
方法名参数说明
year()Number获取或设置年份
month()Number获取或设置月份,范围是 0 到 11,0 表示一月
date()Number获取或设置日期
day()Number获取或设置星期几,范围是 0 到 6,0 表示星期日
hour()Number获取或设置小时数,范围是 0 到 23
minute()Number获取或设置分钟数
second()Number获取或设置秒数
millisecond()Number获取或设置毫秒数
格式化 Moment 对象
方法名参数说明
format(String)String格式化 Moment 对象为指定格式的字符串
操作 Moment 对象
方法名参数说明
add(Number, String)Number, String在原有的 Moment 对象上添加指定的时间量,并返回一个新的 Moment 对象
subtract(Number, String)Number, String在原有的 Moment 对象上减去指定的时间量,并返回一个新的 Moment 对象
startOf(String)String将 Moment 对象设置为指定时间单位的开始,例如 startOf('day') 表示将 Moment 对象设置为当天的开始
endOf(String)String将 Moment 对象设置为指定时间单位的结束,例如 endOf('day') 表示将 Moment 对象设置为当天的结束
获取 Moment 对象的值
方法名参数说明
valueOf()获取 Moment 对象的时间戳
unix()获取 Moment 对象的 UNIX 时间戳
toDate()获取 Moment 对象的 Date 对象
toISOString()获取 Moment 对象的 ISO 8601 格式字符串
toArray()获取 Moment 对象的值的数组,格式为 [年份, 月份, 日期, 小时数, 分钟数, 秒数, 毫秒数]
toJSON()获取 Moment 对象的 JSON 格式字符串
比较 Moment 对象
方法名参数说明
isBefore(Moment, String)Moment, String判断当前 Moment 对象是否在指定 Moment 对象之前
isSame(Moment, String)Moment, String判断当前 Moment 对象是否与指定 Moment 对象相同
isAfter(Moment, String)Moment, String判断当前 Moment 对象是否在指定 Moment 对象之后
isBetween(Moment, Moment, String)Moment, Moment, String判断当前 Moment 对象是否在指定的两个 Moment 对象之间
处理时区
方法名参数说明
tz()String设置或获取 Moment 对象的时区
utc()将 Moment 对象设置为 UTC 时间
local()将 Moment 对象设置为本地时间
解析字符串
方法名参数说明
parseZone(String)String解析带时区信息的字符串,返回 Moment 对象
utc(String)String解析 UTC 时间的字符串,返回

文档

好的,下面是 Moment.js 的使用文档和参数介绍,以表格方式呈现,包括版本号和所有 API:

参数描述版本号
moment([dateString], [format], [strict])创建 moment 对象,dateString 可以是日期字符串、日期对象或时间戳,format 是日期格式字符串,strict 表示是否严格解析模式。2.0.0
moment([array])创建 moment 对象,array 是日期数组,包括年、月、日、小时、分钟、秒和毫秒。2.0.0
moment([number])创建 moment 对象,number 是时间戳。2.0.0
moment()创建当前时间的 moment 对象。2.0.0
moment.utc([dateString], [format], [strict])创建 UTC 时间的 moment 对象,其他参数同 moment()。2.1.0
moment.utc([array])创建 UTC 时间的 moment 对象,其他参数同 moment()。2.1.0
moment.utc([number])创建 UTC 时间的 moment 对象,其他参数同 moment()。2.1.0
moment.duration([duration], [unit])创建时间间隔的 moment 对象,duration 是时间间隔数值,unit 是时间间隔单位。2.0.0
moment.isMoment(object)判断对象是否为 moment 对象。2.1.0
moment.isDate(object)判断对象是否为日期对象。2.1.0
moment.isDuration(object)判断对象是否为时间间隔对象。2.1.0
moment.locale([locale])设置或获取当前语言环境,locale 是语言环境字符串。2.8.1
moment.defineLocale([locale], [data])定义语言环境,locale 是语言环境字符串,data 是语言环境数据。2.3.0
moment.updateLocale([locale], [data])更新语言环境,locale 是语言环境字符串,data 是语言环境数据。2.8.1
moment.locales()获取所有语言环境。2.3.0
moment.weekdays([format])获取一周的所有天数,format 是格式化字符串。2.0.0
moment.weekdaysShort([format])获取一周的所有天数的缩写,format 是格式化字符串。2.0.0
moment.weekdaysMin([format])获取一周的所有天数的最小缩写,format 是格式化字符串。2.0.0
moment.months([format])获取一年的所有月份,format 是格式化字符串。2.0.0
moment.monthsShort([format])获取一年的所有月份的缩写,format 是格式化字符串。2.0.0
moment.parseZone(dateString)解析带时区信息的日期字符串,返回 moment 对象。2.6.0
moment([dateString], [format], [locale], [strict])创建指定语言环境的 moment 对象,其他参数同 moment()。2.8.1
moment([array], [locale], [strict])创建指定语言环境的 moment 对象,其他参数同 moment()。2.8.1
moment([number], [locale], [strict])创建指定语言环境的 moment 对象,其他参数同 moment()。2.8.1
moment().add(value, unit)在当前 moment 对象基础上添加时间间隔,value 是时间间隔数值,unit 是时间间隔单位。2.0.0
moment().subtract(value, unit)在当前 moment 对象基础上减去时间间隔,value 和 unit 同 add()。2.0.0
moment().startOf(unit)获取当前 moment 对象指定时间单位的起始时间。2.0.0
moment().endOf(unit)获取当前 moment 对象指定时间单位的结束时间。2.0.0
moment().year([value])获取或设置当前 moment 对象的年份,value 是年份数值。2.0.0
moment().quarter([value])获取或设置当前 moment 对象的季度,value 是季度数值。2.0.0
moment().month([value])获取或设置当前 moment 对象的月份,value 是月份数值。2.0.0
moment().week([value])获取或设置当前 moment 对象的周数,value 是周数值。2.0.0
moment().isoWeek([value])获取或设置当前 moment 对象的 ISO 周数,value 是周数值。2.0.0
moment().day([value])获取或设置当前 moment 对象的星期几,value 是星期几数值。2.0.0
moment().hour([value])获取或设置当前 moment 对象的小时数,value 是小时数值。2.0.0
moment().minute([value])获取或设置当前 moment 对象的分钟数,value 是分钟数值。2.0.0
moment().second([value])获取或设置当前 moment 对象的秒数,value 是秒数值。2.0.0
moment().millisecond([value])获取或设置当前 moment 对象的毫秒数,value 是毫秒数值。2.0.0
moment().valueOf()获取当前 moment 对象的时间戳。2.0.0
moment().unix()获取当前 moment 对象的 Unix 时间戳。2.0.0
moment().daysInMonth()获取当前 moment 对象所在月份的天数。2.0.0
moment().toDate()将当前 moment 对象转换为日期对象。2.0.0
moment().toArray()将当前 moment 对象转换为日期数组。2.0.0
moment().toISOString()将当前 moment 对象转换为 ISO 8601 格式的字符串。2.0.0
moment().toJSON()将当前 moment 对象转换为 JSON 格式的字符串。2.0.0
moment().format([format])将当前 moment 对象格式化为指定格式的字符串,format 是格式化字符串。2.0.0
moment().diff(moment2, [unit], [round])计算两个 moment 对象之间的时间间隔,unit 是时间间隔单位,round 表示是否进行四舍五入。2.0.0
moment().fromNow([withoutSuffix])获取当前 moment 对象与当前时间之间的时间间隔,withoutSuffix 表示是否省略后缀。2.0.0
moment().from(moment2, [withoutSuffix])获取当前 moment 对象与另一个 moment 对象之间的时间间隔,withoutSuffix 表示是否省略后缀。2.0.0
moment().calendar()获取当前 moment 对象的日历表示。2.0.0
moment().isBefore(moment2, [unit])判断当前 moment 对象是否在另一个 moment 对象之前,unit 是时间间隔单位。2.0.0
moment().isAfter(moment2, [unit])判断当前 moment 对象是否在另一个 moment 对象之后,unit 是时间间隔单位。2.0.0
moment().isSame(moment2, [unit])判断当前 moment 对象是否与另一个 moment 对象相同,unit 是时间间隔单位。2.0.0
moment().isLeapYear()判断当前 moment 对象所在年份是否为闰年。2.0.0
moment().toArray()将当前 moment 对象转换为日期数组。2.0.0
moment().toArray()将当前 moment 对象转换为日期数组。2.0.0
moment().toArray()将当前 moment 对象转换为日期数组。2.0.0

Moment.js 目前的最新版本是 2.29.1,以上列举的所有 API 都包含在该版本中。