Postman中时间参数需在Params填startTime/endTime,值用ISO 8601(如2026-11-04T10:00:00Z)或纯日期格式;推荐用Pre-request Script动态生成,注意时区与后端要求一致,并通过Console核对三处时间值。

Postman Params 里填 startTime 和 endTime 就行
只要后端接口约定用 startTime 和 endTime 做时间区间查询,直接在 Postman 的 Params 标签页里加两行就行。Key 分别写 startTime、endTime,Value 填你想要的时间字符串。
常见错误是填了 2026-11-04 10:00:00 这种带空格和冒号的格式,但没确认后端是否接受——很多后端只认 ISO 8601 格式(2026-11-04T10:00:00Z)或纯日期(2026-11-04)。建议先查接口文档,或者试一次 2026-11-04 看返回是否正常。
- Postman 会自动对空格、
:、+等做 URL 编码,不用手动改%20或%3A - 如果后端报错
Invalid date format,大概率是格式不匹配,不是编码问题 - 起止时间都必须填,否则可能被后端当空值处理,查出全量数据
用 Pre-request Script 动态生成时间范围
硬编码时间只能测固定场景,真要覆盖“最近7天”“上个月”“未来1小时”这类逻辑,得靠脚本。Postman 的 Pre-request Script 是唯一可靠方式。
比如要设“7天前 00:00:00 到现在”,可以这样写:
const now = new Date();
const start = new Date(now);
start.setDate(now.getDate() - 7);
start.setHours(0, 0, 0, 0);
<p>pm.environment.set("startTime", start.toISOString().split('T')[0]);
pm.environment.set("endTime", now.toISOString().split('T')[0]);</p>
注意点:
-
toISOString()返回的是 UTC 时间,如果你的后端按本地时区解析,结果会偏移;保险起见,用new Date().toLocaleDateString()拿本地日期 - 如果后端要求时间戳(秒级),用
Math.floor(start.getTime() / 1000) - 变量名必须和 Params 里的 Key 完全一致,比如 Params 里写的是
beginTime,脚本里就得pm.environment.set("beginTime", ...)
GET 请求拼接 URL 时时间参数容易丢
有人习惯把参数直接敲进 URL 栏,比如:https://api.example.com/log?startTime=2026-11-04&endTime=2026-11-04。这看似简单,但有两个隐患:
Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。
- URL 里中文、空格、冒号等字符若未编码,部分代理或网关会截断请求,导致
endTime参数根本没传过去 - 手敲容易漏掉
&或写错等号,Postman 不报语法错误,只默默发一个缺参请求 - 团队协作时,别人看不到你 URL 里写了啥,复现困难
正确做法:一律走 Params 标签页,让 Postman 控制拼接逻辑。需要看最终 URL,点右下角 Console,发请求后就能看到实际发出的完整地址。
后端收到的时间比预期早/晚 8 小时?检查时区
这是最隐蔽也最常被忽略的问题。你脚本里生成的是本地时间(比如北京时间 2026-11-04T17:33:00),但 toISOString() 默认转成 UTC(即 2026-11-04T09:33:00Z),差正好 8 小时。
解决方案取决于后端怎么处理:
- 如果后端明确要求 UTC 时间,脚本保持
toISOString(),但要在文档里标注清楚 - 如果后端按系统本地时区解析,就别用
toISOString(),改用new Date().toLocaleString('sv-SE')(输出2026-11-04)或手动拼字符串 - 最稳妥的方式:后端统一收毫秒时间戳,前端脚本用
Date.now(),完全规避时区歧义
时间参数看着简单,真正上线前至少得在 Console 里确认三次:脚本生成的值、URL 实际拼出的值、后端日志打印的接收值——三者必须严格一致。









