一个包含44的方法的日期时间JS库，支持获取本月最后一天、本月第一天、本周、上周、下周等日期

最新推荐文章于 2024-03-06 14:50:48 发布

IT男有个IT梦

最新推荐文章于 2024-03-06 14:50:48 发布

阅读量480

点赞数

文章标签： javascript 前端开发语言

本文链接：https://blog.csdn.net/weixin_41971632/article/details/121602437

版权

插件介绍

timer库支持获取当前日期时间、时间差、延迟执行、自定义多个轮询等功能

插件特色

无论项目多大，全局仅仅只需要一个定时器，减少内存消耗，防止定时器过多导致的系统崩溃

下载地址

https://gitee.com/xbc-it/plugins/tree/master/xbc-timer

交流沟通

加群交流QQ群：1078718987

引入SDK

import timer from './static/timer.js'

内置方法

1、start(reset) 开启定时任务

reset 布尔值，是否开启单页任务，即进入新页面时，重置所有定时任务，默认true，即开启

timer.start()

2、remove(taskId) 移除指定任务

// 移除指定单个任务
timer.remove('test')
// 移除指定多个任务
timer.remove(['test1', 'test2'])

3、clear() 移除所有任务

timer.clear()

4、delay(tasks) 延时任务链(每个任务仅执行一次)

tasks 要延时执行的任务，支持单个(JSON)，也支持同时多个(jsonArray)，包含的参数有：
func-任务名（特别说明，不能加括号）
delay-延迟执行时间，单位毫秒
param-任务参数，支持合法的格式

// 执行单个延时任务
timer.delay({
	func: this.test,
	delay: 5000
})
// 执行多个延时任务
timer.delay([
	{	// 延迟5秒执行
		func: this.test1,
		delay: 5000
	},
	{	// 延迟10秒执行
		func: this.test2,
		delay: 10000
	}
])

5、chain(tasks) 定时任务链(每个任务按照指定间隔循环执行)

tasks 要延时执行的任务，支持单个(JSON)，也支持同时多个(jsonArray)，包含的参数有：
id-任务ID
func-任务名（特别说明，不能加括号）
delay-延迟执行时间，单位毫秒
param-任务参数，支持合法的格式
interval-间隔执行时间，单位毫秒，默认1000
time-定时执行时间，支持yyyy-mm-dd hh:mm:ss、yyyy-mm-dd、hh:mm:ss

// 同时添加多个循环任务
timer.chain([
	{
		id: 'test1',
		func: this.test1,
		delay: 2000,
		interval: 1000,
		param: 5
	},
	{
		id: 'test2',
		func: this.test2,
		interval: 1000,
		param: {name: 'test'}
	}
])
// 同时添加多个定时任务
timer.chain([
	{	// 在指定的某个具体时间定时执行（年月日时分秒均须固定2位）
		id: 'test1',
		func: this.test1,
		param: 5,
		time: '2021-05-22 12:00:00'
	},
	{	// 在指定的某个日期的00:00:00定时执行（不传入时间时，默认00:00:00）
		id: 'test2',
		func: this.test2,
		time: '2021-05-22'
	},
	{	// 在每天的某个时间点定时执行（时分秒均须固定2位）
		id: 'test3',
		func: this.test3,
		time: '00:30:20'
	}
])

6、getYearDates(year=0, bool=true, separ=’-’) 获取指定年月内的日期

year 整数值，年份(4位)，当前年份时传入0
bool 布尔值，是否设置月日固定2位，true-是（默认），false-否
separ 字符串，年月日分隔，默认-，设置为text时为年月日

timer.getYearDates()

7、getYearMonthDates(year, month, isAll=false, bool=true, separ=’-’) 获取指定年月内的日期

year 整数值，年份(4位)
month 整数值，月份
isAll 布尔值，是否返回指定年月内的所有连续日期，默认否
bool 布尔值，是否设置月日固定2位，true-是（默认），false-否
separ 字符串，年月日分隔，默认-，设置为text时为年月日

timer.getYearMonthDates(2021, 11)

8、getThisMonthDates(isAll=false, bool=true, separ=’-’) 获取本月内的日期

isAll 布尔值，是否返回本月内的所有连续日期，默认否
bool 布尔值，是否设置月日固定2位，true-是（默认），false-否
separ 字符串，年月日分隔，默认-，设置为text时为年月日

timer.getThisMonthDates()

9、getLastMonthDates(isAll=false, bool=true, separ=’-’) 获取上月内的日期

isAll 布尔值，是否返回上月内的所有连续日期，默认否
bool 布尔值，是否设置月日固定2位，true-是（默认），false-否
separ 字符串，年月日分隔，默认-，设置为text时为年月日

timer.getLastMonthDates()

10、getNextMonthDates(isAll=false, bool=true, separ=’-’) 获取下月内的日期

isAll 布尔值，是否返回下月内的所有连续日期，默认否
bool 布尔值，是否设置月日固定2位，true-是（默认），false-否
separ 字符串，年月日分隔，默认-，设置为text时为年月日

timer.getNextMonthDates()

11、getRangeWeekDates(step=0, isAll=false, bool=true, separ=’-’) 获取向前向后推的X周内的日期

step 整数值，表当向前向后推的多少周，本周时为0
isAll 布尔值，是否返回本周内的所有连续日期，默认否
bool 布尔值，是否设置月日固定2位，true-是（默认），false-否
separ 字符串，年月日分隔，默认-，设置为text时为年月日

timer.getRangeWeekDates()

12、getThisWeekDates(isAll=false, bool=true, separ=’-’) 获取本周日期

isAll 布尔值，是否返回本周内的所有连续日期，默认否
bool 布尔值，是否设置月日固定2位，true-是（默认），false-否
separ 字符串，年月日分隔，默认-，设置为text时为年月日

timer.getThisWeekDates()

13、getLastWeekDates(isAll=false, bool=true, separ=’-’) 获取上周日期

isAll 布尔值，是否返回上周内的所有连续日期，默认否
bool 布尔值，是否设置月日固定2位，true-是（默认），false-否
separ 字符串，年月日分隔，默认-，设置为text时为年月日

timer.getLastWeekDates()

14、getNextWeekDates(isAll=false, bool=true, separ=’-’) 获取下周日期

isAll 布尔值，是否返回下周内的所有连续日期，默认否
bool 布尔值，是否设置月日固定2位，true-是（默认），false-否
separ 字符串，年月日分隔，默认-，设置为text时为年月日

timer.getNextWeekDates()

15、getYesterday(bool=true, separ=’-’) 获取昨天日期

bool 布尔值，是否设置月日固定2位，true-是（默认），false-否
separ 年月日分隔，默认-，设置为text时为年月日

timer.getYesterday()

16、getToday(bool=true, separ=’-’) 获取今天日期

bool 布尔值，是否设置月日固定2位，true-是（默认），false-否
separ 年月日分隔，默认-，设置为text时为年月日

timer.getToday()

17、getYearMonthLastDate(year=0, month=0, bool=true, separ=’-’) 获取指定年月的最后一天的日期

year 整数值，年份(4位)，当前年份时传入0
month 整数值，月份，当前月份时传入0
bool 布尔值，是否设置月日固定2位，true-是（默认），false-否
separ 字符串，年月日分隔，默认-，设置为text时为年月日

timer.getYearMonthLastDate()