在CodeArts TestPlan中调用时间戳转日期函数

函数名

$timestamp_format(String A, String B)

参数说明

• String A：要转化的时间戳，20位以内的纯数字串，也可使用内置获取当前时间戳函数$timestamp()。
• String B：日期时间值，由年、月、日、时、分、秒、毫秒组成。其中：
  • 年：使用字母“y”表示，共4位字符。
  • 月：使用字母“M”表示，共1~2位字符。
  • 日：使用字母“d”表示，共1~2位字符。
  • 时：使用字母“H”表示，共0~2位字符。
  • 分：使用字母“m”表示，共0~2位字符。
  • 秒：使用字母“s”表示，共0~2位字符。
  • 毫秒：使用字母“S”表示，共3位字符。
  

  1. 各字母与其代表的含义一一对应，请注意大小写格式。
  2. H、m、s中若有一个为0位时，其它两个也必须为0位。

  日期时间值中，连接符允许使用空格，“-”、“/”、“:”，也可以不使用连接符。例如如下格式（包括但不限于）：

  • yyyy-MM-dd HH:mm:ss
  • yyyyMMddHHmmss
  • yyyyMMddHHmmssSSS
  • yyyy-M-d H:m:s
  • MM-dd-yyyy HH:mm:ss
  • MM/dd/yyyy HH/mm/ss
  • MM/d/yyyy H/mm/ss
  • MM/d/yyyy H/mm/ss SSS
  • yyyyMMdd SSS

功能说明

实现将时间戳转化成对应格式的日期。时间戳是指从格林威治时间1970年01月01日00时00分00秒（即北京时间1970年01月01日08时00分00秒）起到指定时间的总毫秒数。

函数中的参数A支持以下几种类型：

• 符合参数说明格式的日期时间值
• 环境参数
• 局部参数
• 其它内置函数

函数中的参数B支持以下几种类型：

• 符合参数说明格式的日期时间值
• 环境参数
• 局部参数
• 其它内置函数

使用场景

接口自动化用例中支持在以下场景中使用时间戳转日期函数：

• 请求url路径
• 请求头
• 请求体
• 检查点属性
• if判断
• for循环中断条件

示例

• 请求url路径

  如下图所示，请求url路径中参数“date”的值为时间戳转日期函数，函数中的参数A为内置获取当前时间戳函数“$timestamp()”，获取当前时间戳内置函数的使用方式请参考在CodeArts TestPlan中调用获取当前时间戳函数，参数B为“yyyy-MM-dd HH:mm:ss”。

  

• 请求头

  如下图所示，请求头中参数“date”的值为时间戳转日期函数，函数中的参数A为环境参数“date”，参数B为“yyyyMMddHHmmss”。环境参数的设置方式请参考设置CodeArts TestPlan接口脚本的环境参数。

  

• 请求体

  如下图所示，请求体中应用了时间戳转日期函数，函数中的参数A为“123456789”，参数B为“yyyyMMddHHmmssSSS”。

  

• 检查点属性

  如下图所示，检查点属性“result”的目标值为时间戳转日期函数，函数中的参数A为内置获取当前时间戳函数“$timestamp()”，参数B为“MM/dd/yyyy HH/mm/ss”。

  

• if判断

  如下图所示，if判断的目标值为时间戳转日期函数，函数中的参数A为内置获取当前时间戳函数“$timestamp()”，参数B为“MM/d/yyyy H/mm/ss SSS”。

  

• for循环中断条件

  如下图所示，for循环中断条件的目标值为时间戳转日期函数，函数中的参数A为内置获取当前时间戳函数“$timestamp()”，参数B为“yyyyMMdd SSS”。