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 都包含在该版本中。