跳到主要内容

计算时间

对日期时间做计算。要先拿到当前时间,用 获取日期时间

当前模块定义

sys:computeTime计算与比较Action
标准模块
输入 11 · 输出 7 · 枚举 1

输入参数

  • 类型typeEnum必填

    比较方式

    填写 固定输入默认 getdate
    5 个选项取日期值(去除当天的时间部分)、计算时间差(日期时间2 减 日期时间)、计算结束时间
    取日期值(去除当天的时间部分)默认getdate
    计算时间差(日期时间2 减 日期时间)timespan
    计算结束时间endtime
    本地时间转换为UTC时间localToUtc
    UTC时间转换为本地时间utcToLocal
  • 日期时间time1DateTime必填

    要计算的时间值

    填写 输入或变量
  • 日期时间2time2DateTime必填

    要计算的第二个时间值

    填写 输入或变量条件 仅:timespan
  • 格式化字符串formatStringText必填

    时间差转换为文本时的格式化字符串。d:天数,hh:小时,mm:分钟,ss:秒。符号.:需要使用\转义

    填写 输入或变量条件 仅:timespan默认 d\.hh\:mm\:ss
  • 添加年数addYearsNumber可选

    添加指定的年数(整数)

    填写 输入或变量条件 仅:endtime默认 0
  • 添加月数addMonthsNumber可选

    添加指定的月数(整数)结果不跨月,如1月31日增加1个月等于2月28日。

    填写 输入或变量条件 仅:endtime默认 0
  • 添加天数addDaysNumber可选

    添加指定的天数(可以为小数)

    填写 输入或变量条件 仅:endtime默认 0
  • 添加小时数addHoursNumber可选

    添加指定的小时数(可以为小数)

    填写 输入或变量条件 仅:endtime默认 0
  • 添加分钟数addMinutesNumber可选

    添加指定的分钟数(可以为小数)

    填写 输入或变量条件 仅:endtime默认 0
  • 添加秒数addSecondsNumber可选

    添加指定的秒数(可以为小数)

    填写 输入或变量条件 仅:endtime默认 0
  • 失败后停止stopIfFailBoolean可选

    失败后是否停止动作

    填写 固定输入默认 true

输出参数

  • 是否成功isSuccessBoolean

    操作是否成功

  • 结果时间resultTimeDateTime

    计算的结果时间

    条件 仅:endtime, getdate, utcToLocal, localToUtc
  • 总天数totalDaysNumber

    间隔的总天数值

    条件 仅:timespan
  • 总小时数totalHoursNumber

    间隔的总小时数

    条件 仅:timespan
  • 总分钟数totalMinutesNumber

    间隔的总分钟数值

    条件 仅:timespan
  • 总秒数totalSecondsNumber

    间隔的总秒数数值

    条件 仅:timespan
  • 文本值textValueText

    时间间隔的文本结果

    条件 仅:timespan

概述

先选 类型,再填 日期时间 和该类型需要的附加参数。

计算时间

时间相关的计算操作
类型
比较方式
日期时间
 
要计算的时间值
是否成功
-- 选择变量 --
操作是否成功
结果时间
-- 选择变量 --
计算的结果时间

参数说明

类型:点开下拉看当前全部选项。

日期时间:要计算的时间。

失败后停止:失败是否中止动作。默认开启。旧稿未写。

取日期值(去除当天的时间部分)

例如 2020-1-1 12:34:00 去掉时分秒,得到当天 0 点 2020-1-1 0:0:0。结果写入 结果时间

计算时间差(日期时间2 减 日期时间)

日期时间2 减去 日期时间

计算时间

时间相关的计算操作
类型
比较方式
日期时间
currTime
要计算的时间值
日期时间2
endDay
要计算的第二个时间值
格式化字符串
d\.hh\:mm\:ss
时间差转换为文本时的格式化字符串。d:天数,hh:小时,mm:分钟,ss:秒。符号.:需要使用\转义
总天数
totalDays
间隔的总天数值
总小时数
totalHours
间隔的总小时数
总分钟数
totalMinutes
间隔的总分钟数值
总秒数
totalSeconds
间隔的总秒数数值
文本值
timeDiff
时间间隔的文本结果

日期时间2:第二个时间。

格式化字符串:把时间差转成 文本值 时的格式。d 天数、hh 小时、mm 分钟、ss 秒;点号 . 要写成 \.。代号见 自定义 TimeSpan 格式

输出 总天数总小时数总分钟数总秒数文本值

计算结束时间

日期时间 上增加年、月、天、小时、分钟、秒,得到结束时间。一般只填其中一个;可以为负。

计算时间

时间相关的计算操作
类型
比较方式
日期时间
currTime
要计算的时间值
添加天数
700
添加指定的天数(可以为小数)
结果时间
currTime
计算的结果时间

添加年数:整数。

添加月数:整数。结果不跨月,如 1 月 31 日加 1 个月是 2 月 28 日。

添加天数 / 添加小时数 / 添加分钟数 / 添加秒数:可以为小数。

输出 结果时间

本地时间转换为UTC时间 / UTC时间转换为本地时间

在本地时间和 UTC 之间转换。结果写入 结果时间

计算时间

时间相关的计算操作
类型
比较方式
日期时间
currTime
要计算的时间值
结果时间
currTime
计算的结果时间

输出

  • 是否成功:操作是否成功。旧稿未写。
  • 结果时间:取日期、计算结束时间、时区转换时的结果。
  • 总天数 / 总小时数 / 总分钟数 / 总秒数 / 文本值:仅计算时间差。

限制与排障

时间差是「日期时间2 减 日期时间」,填反了会得到负数。格式化字符串里的 :. 常要转义,照默认值 d\.hh\:mm\:ss 改最稳。加月遇到月末会收成当月最后一天,不要按「固定 30 天」去对。

相关链接

更新于