# 时间戳类工具
- currentStamp 获取当前时间时间戳
- getStamp 获取指定时间时间戳
- formatStamp 根据时间戳格式化显示日期
- formatDateToStamp 从规则的时间格式中获取时间戳
- getDaysInOneMonth 获取某个月有多少天
- dayStartStamp 获取天开始时间戳
- dayEndStamp 获取天结束时间戳
- weekStartStamp 获取周开始时间戳
- weekEndStamp 获取周结束时间戳
- monthStartStamp 获取月开始时间戳
- monthEndStamp 获取月结束时间戳
- yearStartStamp 获取年开始时间戳
- yearEndStamp 获取年结束时间戳
- stampToWeekNumber 根据时间戳获取是星期几
utils.timeStamp.currentStamp()
获取当前时间时间戳
示例
utils.timeStamp.currentStamp() // 1583393796765
utils.timeStamp.getStamp(year?, month?, day?, hours?, minute?, second?)
获取指定时间时间戳
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| year | Number | Null | 否 | 当前年 | 年 |
| month | Number | Null | 否 | 当年月 | 月 |
| day | Number | Null | 否 | 当前日 | 日 |
| hours | Number | 否 | 0 | 时 |
| minute | Number | 否 | 0 | 分 |
| second | Number | 否 | 0 | 秒 |
示例
utils.timeStamp.getStamp() // 1583337600000
utils.timeStamp.getStamp(2020, 3, 5, 17, 0, 23) // 1583398823000
utils.timeStamp.getStamp(null, null, null, 10, 55, 30) // 1584932130000 当天
utils.timeStamp.formatStamp(options)
根据时间戳格式化显示日期
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| options | Object | String | Number | 是 | 无 | 可以为时间戳，支持string格式，也可以为options对象 |
options参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| stamp | Number | String | 是 | 无 | 时间戳 |
| separator | String | 否 | "-" | 分隔符 |
| digit | Number | 否 | 6 | 默认年月日时分秒 |
| numbersModel | Number | 否 | 1 | 年月日-时分秒单双位数显示 1单双 2双双 3单单 4双单 |
| custom | Boolean | 否 | false | 是否开启自定义组装 |
示例
utils.timeStamp.formatStamp(1584542645000) // 2020-3-18 22:44:05
console.log(utils.timeStamp.formatStamp({ // {"year":2020,"month":3,"day":18,"hour":22,"minute":44,"second":"05","timeSlot":"下午","weekNumber":3,"weekNumberText":"星期三"}
stamp: 1584542645000,
custom: true,
}))
utils.timeStamp.formatStamp({ // 2018/02/13 0:0:0
stamp: 1518451200000,
separator: '/', // 分割符
digit: 6, // 位数
numbersModel: 4, // 数字显示模式
})
utils.timeStamp.formatDateToStamp(options?)
从规则的时间格式中获取时间戳
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| options | Object | String | 否 | 配置参数/时间文字 |
options参数
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| text | String | 是 | "" | 日期文字 '2018-3-5' | '2018-03-05 23:56:30' |
| separator | String | 否 | '-' | 日期分隔符 |
| mode | String | 否 | 'start' | 'start' | 'end' 决定返回一天开始或结束时间戳 年月日时分秒格式文字无效 |
示例
utils.timeStamp.formatDateToStamp() // 当前天时间戳
utils.timeStamp.formatDateToStamp('2018-2-13') // 1518451200000
utils.timeStamp.formatDateToStamp({ text: '2018-2-13' }) // 1518451200000
utils.timeStamp.formatDateToStamp({ // 1518451200000
text: '2018/2/13',
separator: '/',
})
utils.timeStamp.formatDateToStamp({ // 1518537599000
text: '2018-2-13',
mode: 'end',
})
utils.timeStamp.formatDateToStamp({ text: '2018-2-13 15:28:05' }) // 1518506885000
utils.timeStamp.getDaysInOneMonth(year?, month?)
获取某个月有多少天
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| year | Number | 否 | 当前年 | 年/时间戳 |
| month | Number | 否 | 当年月 | 月 |
PS：填写了时间戳第二参数无效
示例
utils.timeStamp.getDaysInOneMonth() // 当前月天数
utils.timeStamp.getDaysInOneMonth(2) // 当年2月天数
utils.timeStamp.getDaysInOneMonth(2020, 3) // 2020年3月天数
utils.timeStamp.getDaysInOneMonth(1582646400000) // 29
utils.timeStamp.dayStartStamp(stamp?)
获取天开始时间戳
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| stamp | Number | 否 | 当前天 | 时间戳 |
示例
utils.timeStamp.dayStartStamp() // 当前天开始时间戳
utils.timeStamp.dayStartStamp(1582646405000) // 1582646400000
utils.timeStamp.dayStartStamp(1580763967000) // 1580745600000
utils.timeStamp.dayEndStamp(stamp?)
获取天结束时间戳
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| stamp | Number | 否 | 当前天 | 时间戳 |
示例
utils.timeStamp.dayEndStamp() // 当前天结束时间戳
utils.timeStamp.dayEndStamp(1582646405000) // 1582732799000
utils.timeStamp.dayEndStamp(1580763967000) // 1580831999000
utils.timeStamp.weekStartStamp(stamp?)
获取周开始时间戳
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| stamp | Number | 否 | 当前周 | 时间戳 |
示例
utils.timeStamp.weekStartStamp() // 本周开始时间戳
utils.timeStamp.weekStartStamp(1582646400000) // 1582473600000
utils.timeStamp.weekStartStamp(1585152000000) // 1584892800000
utils.timeStamp.weekEndStamp(stamp?)
获取周结束时间戳
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| stamp | Number | 否 | 当前周 | 时间戳 |
示例
utils.timeStamp.weekEndStamp() // 本周结束时间戳
utils.timeStamp.weekEndStamp(1582646400000) // 1583078399000
utils.timeStamp.weekEndStamp(1585152000000) // 1585497599000
utils.timeStamp.monthStartStamp(year?, month?)
获取月起始时间戳
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| year | Number | 否 | 当前年 | 年/时间戳 |
| month | Number | 否 | 当前月 | 月 |
PS：填写了时间戳第二参数无效
示例
utils.timeStamp.monthStartStamp() // 本月开始时间戳
utils.timeStamp.monthStartStamp(2018) // 1519833600000
utils.timeStamp.monthStartStamp(1614700800000) // 1612108800000
utils.timeStamp.monthEndStamp(year?, month?)
获取月结束时间戳
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| year | Number | 否 | 当前年 | 年/时间戳 |
| month | Number | 否 | 当前月 | 月 |
PS：填写了时间戳第二参数无效
示例
utils.timeStamp.monthEndStamp() // 本月结束时间戳
utils.timeStamp.monthEndStamp(2018) // 1522511999000
utils.timeStamp.monthEndStamp(1614700800000) // 1617206399000
utils.timeStamp.yearStartStamp(year?)
获取年开始时间戳
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| year | Number | 否 | 当前年 | 年/时间戳 |
示例
utils.timeStamp.yearStartStamp() // 本年开始时间戳
utils.timeStamp.yearStartStamp(2030) // 1893427200000
utils.timeStamp.yearStartStamp(1612108800000) // 1609430400000
utils.timeStamp.yearEndStamp(year?)
获取年结束时间戳
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| year | Number | 否 | 当前年 | 年/时间戳 |
示例
utils.timeStamp.yearEndStamp() // 本年结束时间戳
utils.timeStamp.yearEndStamp(2030) // 1924963199000
utils.timeStamp.yearEndStamp(1612108800000) // 1640966399000
utils.timeStamp.stampToWeekNumber(stamp?, cn?)
根据时间戳获取是星期几
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| stamp | Number | String | Null | 否 | 当前时间戳 | |
| cn | Boolean | 否 | 是否返回中文模式 |
示例
utils.timeStamp.stampToWeekNumber() // 当前
utils.timeStamp.stampToWeekNumber(1585411200000) // 7
utils.timeStamp.stampToWeekNumber(1585411200000, true) // 星期天