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