08.插件命令zm 紫猫插件zm 日期时间
, ,

zm.TimeAdd 时间计算

文章目录
  1. 1. 功能
  2. 2. 语法
  3. 3. 参数
  4. 4. 返回值
  5. 5. 示例
  6. 6. 备注

功能

计算时间加减后的数值, 例如一天后的时间, 3年前的时间等, 数值单位由参数3决定

语法

结果 = zm.TimeAdd([时间, ]数值[, 单位])

参数

参数 数据类型 解释
时间 数值型或字符串 可选, 待计算的时间, 字符串时支持”2017年7月23日 23:29:31”, “2017-07-23 23:29:38”等格式, 数值时表示时间戳, 省略默认为当前时间
数值 数值型 表示要加减的具体数值, 支持正负数
单位 字符串 可选, 表示数值的计算单位, 可填写[“年”, “月”, “日”, “天”, “时”, “分”, “秒”]或[“Y”, “m”, “d”, “H”, “M”, “S”], 省略默认为”秒”

返回值

数值型 , 返回加减计算后的时间戳结果, 失败返回null

示例

1
2
3
4
5
6
7
8
Import "zm.luae" //导入插件,只需执行一次
zm.Init  //初始化插件,只需执行一次

//计算15天后的时间日期
TracePrint zm.TimeAdd("2019年8月3日 14:03:26", 15, "日")

//计算当前时间往后20个月的时间
TracePrint zm.TimeAdd(20, "月")

备注

  • 月份加减时要注意, 比如3月31日加1个月将会得到5月1日, 并非4月30日.
  • V3.1832: 加入命令
  • V4.2015: 采用归一化计算日期, 时间更加准确