lua插件之----【luaDate 日期类】
接口原型 | 说明 |
luaDate.timestamp | 获取时间戳。支持日期格式字符串、日期表 |
luaDate.isDate | 检测是否是日期。支持日期格式字符串或日期表 |
luaDate.split | 拆分成日期 |
luaDate.format | 格式化日期 |
luaDate.comput | 日期计算 |
luaDate.diff | 返回两个日期相差秒数 |
@ 说明:获取时间戳。支持日期格式字符串、日期表
@ 参数:
d [string | table 可选] 日期格式字符串或时间设置表。年月日是必需的,时分秒可选
日期格式字符串:2024-11-11 12:12:13 或 2024/11/11 12:12:13 或 2024年11月11日 12时12分13秒
日期表:{year=, month=, day=, hour=, min=, sec=}
@ 返回: [number | nil]
luaDate.timestamp() //获取当前时间戳,结果:1731132998 luaDate.timestamp({"year": 2024, "month": 11, "day": 12, "hour": 5, "min": 20, "sec": 1}) //以时间表的方式获取 2024年11月12日 5时20分1秒 的时间戳,结果:1731360001 luaDate.timestamp("2024年11月12日 5时20分1秒")//以日期字符串的方式获取 2024年11月12日 5时20分1秒 的时间戳,结果:1731360001 luaDate.timestamp("2024/11/12 5:20:1")//以日期字符串的方式获取 2024年11月12日 5时20分1秒 的时间戳,结果:1731360001
@ 说明:检测是否是日期类型。支持日期格式字符串、日期表、时间戳
@ 参数:
d [string | table 必需] 日期格式字符串或日期表
@ 返回: [boolean]
luaDate.isDate(1731360001) //结果: true luaDate.isDate("2024/11/12 5:20:1") //结果:true luaDate.isDate({"year": 2024, "month": 11, "day": 12, "hour": 5, "min": 20, "sec": 1}) //结果:true
@ 说明:拆分成日期
@ 参数:
d [string 必需] 日期格式字符串或日期表
@ 返回:[table | nil]
格式如下:{sec : 1 , min : 20 , month : 11 , hour : 5 , isdst : false , yday : 317 , day : 12 , year : 2024 , wday : 3}
isdst : 是否是夏令制
isdst :一年第多少天
wday : 当前第几周
luaDate.split({"year": 2024, "month": 11, "day": 12, "hour": 5, "min": 20, "sec": 1}) // 拆分日期表,结果:{sec : 1 , min : 20 , month : 11 , hour : 5 , isdst : false , yday : 317 , day : 12 , year : 2024 , wday : 3} luaDate.split(1731360001) // 拆分时间戳 luaDate.split("2024/11/12 5:20:1") //拆分日期字符串
原型:luaDate.format(d, formatStr)
@ 说明:格式化日期
@ 参数:
d [string 必需] 日期格式字符串或日期表或时间戳
formatStr [string 必需] 格式规则,比如:yyyy-mm-dd HH:MM:SS
@ 返回:[string | nil]
luaDate.format("2024/11/12 5:20:1", "yyyy年mm月dd日 hh时MM分ss秒") //格式化日期字符串,结果:2024年11月12日 5时20分1秒 luaDate.format(1731360001, "yyyy年mm月dd日 hh时MM分ss秒")//格式化时间戳,结果:2024年11月9日 14时52分11秒 luaDate.format({"year": 2024, "month": 11, "day": 12, "hour": 5, "min": 20, "sec": 1}, "yyyy年mm月dd日 hh时MM分ss秒") //格式化日期表,结果:2024年11月12日 5时20分1秒
@ 说明:日期计算
@ 参数:
d [string 必需] 日期格式字符串或日期表或时间戳
tbl [table],计算方式。比如,在当前日期上加年: {year=1} ,提前一年:{year=-1}。可设置: year/month/day/hour/min/sec
@ 返回:[table] 日期表,格式:{yday : 313 , isdst : false , month : 11 , min : 58 , wday : 6 , sec : 27 , hour : 14 , day : 8 , year : 2024}
luaDate.comput(1731360001, {"day": -1}) //昨天 luaDate.comput(1731360001, {"day": 1}) //明天
@ 说明:返回两个日期相差秒数
@ 参数:
d1 [string 必需] 日期
d2 [string 必需] 日期
@ 返回:[number | nil]
luaDate.diff("2024-11-11 15:15:15", "2024-11-11 15:15:25") // 结果:-10
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步