JMeter 内置日期(时间)函数总结
by:授客 QQ：1033553122
1. 测试环境
apache-jmeter-3.3
下载地址：
http://jmeter.apache.org/changes_history.html
win7
2. __time函数
__time函数以各种格式返回当前时间
${__time(Format, variableName)}
说明：
Format 传递给 SimpleDateFormat的格式。参数可选，如果不提供该参数，则默认返回1970-01-01 00:00:00到当前时间的毫秒数。如果Format匹配"/ddd" (这里ddd为小数位数)，那么函数将返回前面所述的时间毫秒数/ddd后的值。例如"/1000"，返回1970-01-01 00:00:00到当前时间的秒数。否则传递当前时间给SimpleDateFormat
variableName 用于存放time函数返回结果值的变量名称，参数可选
例子：
log.info("${__time()}");
log.info("${__time(,)}");
log.info("${__time(/1000,)}"); # 精确到秒
log.info("${__time(, var)}");
log.info("${var}");
log.info("${__time(yyyyMMdd, var)}");
log.info("${__time(YMD,)}");
log.info("${__time(HHmmss,)}");
log.info("${__time(HMS,)}");
log.info("${__time(yyyyMMdd-HHmmss,)}");
log.info("${__time(YMDHMS,)}");
log.info("${__time(dd/MM/yyyy,)}");
log.info("${__time(yyyy-MM-dd HH:mm:ss,)}");
log.info("${__time(yyyy-MM-dd HH:mm:ss:SSS,)}");
注意：格式区分大小写
结果：
参考链接：http://jmeter.apache.org/usermanual/functions.html#__time
3. __timeShift函数
3.3版本开始才内置该函数，类似__time函数，不同之处在于它可以返回按指定时间单位和时间数量偏移后的值。
${__timeShift(Format, DateToShift, valueToShift, LocaleToUseForFormat,variableName)}
说明：
Format 同__time()函数，参数可选
DateToShift 日期(时间)值，格式同Format参数匹配，如果不匹配、未提供该参数值，则默认使用当前日期。偏移是基于该日期(时间)的。参数可选
valueToShift 指要偏移的秒数、分钟数、小时数、天数。参数可选
书写语法参考：
https://docs.oracle.com/javase/8/docs/api/java/time/Duration.html#parse-java.lang.CharSequence-
例子：
PT20.345S 被解析为 20.345 秒，意为在DateToShift 的基础上增加20.345秒
PT15M 被解析为 15分钟，意为在DateToShift 的基础上增加15分钟秒
PT10H 被解析为 10小时，意为在DateToShift 的基础上增加10小时
P2D 被解析为 2 天，意为在DateToShift 的基础上增加2天
-P6H3M 被解析为 -6 小时又-3小时，，意为在DateToShift 的基础上增加6小时3分钟
LocaleToUseForFormat 表示日期(时间)的语言环境，即用于格式化日期(时间)的语言. 语言代码必须小写。国家代码必须大写。分隔符必须为下划线。比如en_EN。参数可选，如果未提供，则模式使用ApacheJMeter 的locale.
参考资料：
http://www.oracle.com/technetwork/java/javase/javase7locales-334809.html
variableName 用于存放time函数返回结果值的变量名称，参数可选
例子：
log.info("${__timeShift(,,,,)}");
log.info("${__timeShift(yyyy-MM-dd HH:mm:ss,,,,)}"); // 使用默认日期时间
log.info("${__timeShift(yyyy-MM-dd HH:mm:ss,2018/11/30 23:59:59,,)}"); // 使用默认日期时间
log.info("${__timeShift(yyyy-MM-dd HH:mm:ss,2018-11-30 23:59:59,,)}");
log.info("${__timeShift(dd/MM/yyyy,21/01/2018,P2D,,)}"); // 返回 23/01/2018
log.info("${__timeShift(dd MMMM yyyy,21 février 2018,P2D,fr_FR,)}"); // 返回 23 février 2018
log.info("${__timeShift(yyyyMMdd,,,,var)}"); // 存储返回值到变量var
log.info("${var}");
运行结果：
参考链接：
http://jmeter.apache.org/usermanual/functions.html#__timeShift
4. __RandomDate
函数返回给定起始日期和结束日期之间的随机日期
${__RandomDate(Format, StartDate, EndDate, LocaleToUseForFormat,variableName)}
)}
Format 同__time()函数，默认值为 yyyy-MM-dd
StartDate 起始日期，默认为now
EndDate 结束日期，参数必填
LocaleToUseForFormat 同__timeShift()函数
variableName 同__time()函数
注意：StartDate 和EndDate 格式必须和Format保持一致
例子：
log.info("${__RandomDate(,,2019-01-01,,)}"); // 返回当前日期到2019-01-01直接的日期
log.info("${__RandomDate(yyyyMMdd,20181117,20181130,,var)}"); // 存储返回值到变量var
log.info("${var}");
log.info("${__RandomDate(dd MM yyyy,,08 07 2050,,)}"); // 自定义格式 // 返回当前日期到2050年7月8号之间的日期
运行结果：
http://jmeter.apache.org/usermanual/functions.html#__RandomDate
