# 在CodeArts TestPlan中调用日期转时间戳函数
#### 函数名
$dateFormat(String A)
 #### 参数说明
String A：日期时间值，支持以下几种格式：
- yyyy-MM-dd HH:mm:ss或MM-dd-yyyy HH:mm:ss格式。
- yyyy MM dd HH:mm:ss或MM dd yyyy HH:mm:ss格式。
- yyyy.MM.dd HH:mm:ss或MM.dd.yyyy HH:mm:ss格式。
- yyyy/MM/dd HH:mm:ss或MM/dd/yyyy HH:mm:ss格式。
 
#### 功能说明
实现将字符串转化成对应的时间戳。时间戳是指从格林威治时间1970年01月01日00时00分00秒（即北京时间1970年01月01日08时00分00秒）起到指定时间的总毫秒数。
函数中的参数A支持以下几种类型：
- 符合[参数说明]格式的日期时间值
- 局部参数
- 其它内置函数
 
#### 使用场景
接口自动化用例中支持在以下场景中使用日期转时间戳函数：
- 请求url路径
- 请求头
- 请求体
- 检查点属性
- if判断
- for循环中断条件
 
#### 示例
- 请求url路径 如下图所示，请求url路径中参数"test"的值为日期转时间戳函数，函数中的参数A为环境参数"date"。环境参数的设置方式请参考[设置CodeArts TestPlan接口脚本的环境参数](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0052.html)。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001979263173.png "点击放大")
  
  
- 请求头 如下图所示，请求头中参数"date"的值为日期转时间戳函数，函数中的参数A为环境参数"date"。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001979423031.png "点击放大")
  
  
- 请求体 如下图所示，请求体中应用了日期转时间戳函数，函数中的参数A为"2020.09.11 11:00:00"。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001949303618.png)
  
- 检查点属性 如下图所示，检查点属性"result"的目标值为日期转时间戳函数，函数中的参数A为环境参数"test"。局部参数的设置方式请参考[局部参数](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0016.html#cloudtest_01_0016__section1911995744510)。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001979423035.png "点击放大")
  
  
- if判断 如下图所示，if判断的目标值为日期转时间戳函数，函数中的参数A为"2020-09-11 11:00:00"。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001949303622.png "点击放大")
  
  
- for循环中断条件 如下图所示，for循环中断条件的目标值为日期转时间戳函数，函数中的参数A为"2020-09-11 11:00:00"。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000001979263185.png "点击放大")