获取时间

获取当前系统时间或将文本、Unix时间戳转换为时间值,并进行简单计算和信息提取。


image.png


参数

输入

第一部分,初始时间值。

【时间来源】选择初始时间的来源,可选值如下:

  • 当前时间:取Windows的当前时间。 此时可选是否“使用UTC时间”,选中“使用UTC时间”时,返回当前UTC时间,否则返回本地时间。
  • 从文本转换:将文本值转换为时间值(文本值可以接收其他类型参数,因此也可以把时间类型变量作为参数传递进来)。
  • 从Unix时间戳转换:将时间戳转换为时间。此时可选是否“使用UTC时间”,选中“使用UTC时间”时,将时间戳看作UTC的1970年1月1日(UTC/GMT的午夜)开始所经过的秒数,不选的话,表示从本地时间1970年1月1日开始的秒数


第二部分,计算。在获取的初始时间的基础上,增减指定的时间值。

【增加天数】【增加小时数】【增加分钟数】【增加秒数】:正值表示增加,负值表示减少的时间值。可以为小数。

【增加的月数】增加或减少的月数,需要为整数。不会跨月,比如3月31日加1个月等于4月30日。


其他输入参数:

【文本值格式】用于控制输出参数中的“文本值”的日期时间格式。请参考C#日期时间格式化相关内容。

如,使用“yyyy-MM-dd HH:mm:ss”,得到的文本值为“2020-06-16 10:38:32”

image.png

常用格式指令字符:

  符号  说明示例(2016-05-09 13:09:55:2350)
  yy年份后两位16
  yyyy4位年份2016
  MM两位月份;单数月份前面用0填充05

  M

不补0的自然数月份

5

  dd

长日期,前面补0

09

  d

短日期,前面不补0

9

  ddd周几周一
  dddd星期几星期一
  hh12小时制的小时数01

  h

不补0的小时数

1

  HH24小时制的小时数13

  H

不补0的小时数

13

  mm分钟数09

  m

不补0的分钟数

9

  ss秒数55

  s

不补0的秒数

55

  ff毫秒数前2位23
  fff毫秒数前3位235
  ffff毫秒数前4位2350
  分隔符

可使用分隔符来分隔年月日时分秒。

包含的值可为:-、/、:等非关键字符(中文也可以)

yyyy-MM-dd HH:mm:ss:ffff

  => 2016-05-09 13:09:55:2350

yyyy/MM/dd HH:mm:ss:ffff

  => 2016/05/09 13:09:55:2350

yyyy/MM/dd HH:mm:ss:ffff dddd

  => 2016/05/09 13:09:55:2350 星期一

yyyy年MM月dd日 HH时mm分ss秒

=> 2016年05月09日 13时09分55秒



输出

【原始值】计算得到的时间类型变量值。

【文本值】依据输入参数“文本值格式”,将原始值转换成的文本格式,用于输出到文本变量中。

【Unix时间戳】将原始值转换为Unix时间戳。此处不考虑原始值是本地时间还是UTC时间。

【年】【月】【日】【时】【分】【秒】时间值中对应的数据。

【周第几天】是一周中的第几天。周日为0,周一为1,以此类推。

【年第几天】是当年的第几天。


表达式

也可以使用表达式的方式代替本模块的功能。

例如:

  • $= "当前时间是:" + DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")
    • 将一个文本加上当前时间的文本值
  • $=DateTime.Now.Year
    • 得到当前年份数字



示例动作


参考

语雀在语雀上查看