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

zm.TimeDiff 计算时间差

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

功能

计算时间1减去时间2的时间差, 返回单位以第3个参数为准

语法

结果 = zm.TimeDiff(时间1[, 时间2][, 单位][, 是否取整])

参数

参数 数据类型 解释
时间1 数值型或字符串 第1个时间, 字符串时支持”2017年7月23日 23:29:31”, “2017-07-23 23:29:38”等格式, 数值时表示时间戳
时间2 数值型或字符串 可选, 第2个时间, 字符串时支持”2017年7月23日 23:29:31”, “2017-07-23 23:29:38”等格式, 数值时表示时间戳, 省略默认为当前时间
单位 字符串 可选, 表示计算返回的时间单位, 可填写[“年”, “月”, “日”, “天”, “时”, “分”, “秒”]或[“Y”, “m”, “d”, “H”, “M”, “S”], 省略默认为”秒”
是否取整 布尔型 可选, 表示返回值是否只保留整数, 省略默认为false

返回值

数值型 , 成功返回两者时间差, 单位由参数3决定, 失败返回null

示例

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

//计算参数1减去参数2, 返回单位秒数
TracePrint zm.TimeDiff("2019年8月3日 14:03:26", "2018-08-03 22:06:04")

//计算2018-12-01 00:00:00减去当前时间, 返回单位天数, 并取整
TracePrint zm.TimeDiff("2018-12-01", "日", true)

备注

  • 一个月约为30.4天, 一年为365天
  • V3.1832: 加入命令