# 操作
我们希望能够对日期时间进行操作
# 加上
对指定的时间进行加操作,返回操作后的日期
语法:
R.add(value, unit, dt, ft)
单位不区分大小写,支持复数和缩写形式。
// 当前日期 + 1 天
rdate.add(1, 'day')
// 当前日期 + 1 年
rdate.add(1, 'year')
// 当前日期 + 1 月
rdate.add(1, 'month')
// 当前日期 + 1 分钟
rdate.add(1, 'minute')
// 当前日期 + 1 秒
rdate.add(1, 'second')
// 指定 '2021-1-1 15:55:55'日期 + 7 天(一周)
rdate.add(7, 'day', '2021-1-1 15:55:55') // "2021-01-08 15:55:55"
// 指定 '2021-1-1 15:55:55' 日期 + 7 天(一周)
rdate.add(7, 'day', '2021-1-1 15:55:55', 'YYYY-MM-DD') // "2021-01-08"
// 当前日期 + 1 个季度,1个季度 3个月,当前日期后延3个月
rdate.add(1, 'quarter') //
// 指定 '2021-1-1' 日期 + 1 个季度,1个季度 3个月,当前日期后延3个月
rdate.add(1, 'quarter', '2021-1-1') //"2021-04-01 00:00:00"
所有可用单位列表
单位 | 缩写 | 描述 |
---|---|---|
week | w | 周 |
day | d | 星期(星期日 0,星期六 6) |
month | M | 月份(0-11) |
quarter | Q | 依赖QuarterOfYear 插件 |
year | y | 年 |
hour | h | 小时 |
minute | m | 分钟 |
second | s | 秒 |
millisecond | ms | 毫秒 |
# 减上
对指定的时间进行减操作,返回操作后的日期
语法:
rdate.subtract(value, unit, dt, ft)
单位不区分大小写,支持复数和缩写形式。
rdate.subtract(1, 'quarter', '2021-6-1') // "2021-03-01 00:00:00"
# 开始时间
获取 一个 日期时间的 开始时间
语法:
rdate.startOf(unit, dt, ft)
单位不区分大小写,支持复数和缩写形式。
// 获取 当前日期 的年开始日期
rdate.startOf('year')
// 获取指定日期所属的 月开始日期
rdate.startOf('month','2022-3-15')// "2022-03-01 00:00:00"
rdate.startOf('month','2022-3-15','YYYY-MM-DD')// "2022-03-01"
所有可用单位列表
单位 | 缩写 | 描述 |
---|---|---|
date | D | 天 00:00 |
day | d | 星期 00:00 |
month | M | 月第一天 00:00 |
quarter | Q | 季度第一个月第一天 00:00 |
year | y | 1 月 1 日 00 点 |
week | w | 周第一天 00:00 |
hour | h | 00:00:00 |
minute | m | 00:00 |
second | s | 00 |
millisecond | ms | 0 |
week | w | 周第一天 00:00 |
# 结束时间
获取 一个 日期时间的 结束时间
语法:
rdate.endOf(unit, dt, ft)
单位不区分大小写,支持复数和缩写形式
// 获取今年的最后一天日期
rdate.endOf('year')
// 获取本月的最后一天日期
rdate.endOf('month')
// 获取指定日期 '2021-2-2' 所属的月的最后一天日期
rdate.endOf('month', '2021-2-2') // "2021-02-28 23:59:59"
// 获取指定日期 '2021-2-2' 所属日期的 最后一刻
rdate.endOf('date', '2021-2-2') //"2021-02-02 23:59:59"
// 获取指定日期 '2021-2-2' 所属时的 最后一刻
rdate.endOf('hour', '2021-2-2') // "2021-02-02 00:59:59"
// 获取指定日期 '2021-2-2' 所属时的 最后一刻
rdate.endOf('minute', '2021-2-2') // "2021-02-02 00:00:59"
// 获取指定日期 '2021-2-2' 所属时的 最后一刻
rdate.endOf('second', '2021-2-2') // "2021-02-02 00:00:00"
// 获取指定日期 '2021-2-2' 所属时的 最后一刻
rdate.endOf('millisecond', '2021-2-2', 'YYYY-MM-DD HH:mm:ss SSS') // "2021-02-02 00:00:00 000"
// 获取指定日期 '2021-6-14' 所属周的的 最后一天(周日)日期
rdate.endOf('week', '2021-6-14') // "2021-06-20 23:59:59"
rdate.endOf('quarter', '2021-5-14') // "2021-06-30 23:59:59"
rdate.endOf('quarter', '2021-6-14') // "2021-06-30 23:59:59"
rdate.endOf('quarter', '2021-4-14') // "2021-06-30 23:59:59"
rdate.endOf('quarter', '2021-3-14') // "2021-03-31 23:59:59"
rdate.endOf('quarter', '2021-1-14') // "2021-03-31 23:59:59"
rdate.endOf('quarter', '2021-9-14') // "2021-09-30 23:59:59"
rdate.endOf('quarter', '2021-10-14') // "2021-12-31 23:59:59"