如何让Azure工作簿的时间范围参数使用UTC时间？

一、直接修改参数配置强制识别UTC #

Azure工作簿的时间范围参数（type:4对应时间范围选择器）支持通过typeSettings添加useUtc配置，强制将用户输入的自定义起止时间视为UTC：

修改你的参数JSON配置，在typeSettings中新增"useUtc": true：

...
"content": {
  "version": "KqlParameterItem/1.0",
  "parameters": [
    {
      "id": "ad71f14d-05e5-47d3-9d8a-79ebc1e0fab7",
      "version": "KqlParameterItem/1.0",
      "name": "TimeRange",
      "type": 4,
      "isRequired": true,
      "typeSettings": {
        "selectableValues": [],
        "allowCustom": true,
        "useUtc": true // 强制参数以UTC解析输入时间
      }
    }
  ]
}
...

添加后，参数会直接使用输入的UTC时间执行查询，结果时间戳也会保持UTC显示，不会再做本地时间与UTC的双向转换。

二、参数配置不生效时的KQL查询处理方案 #

如果上述配置无法生效，可在KQL查询中手动处理时间范围，确保使用UTC且显示值不变：

1. 提取时间范围参数的起止时间，转换为UTC格式
2. 查询时使用转换后的UTC范围，同时保持结果时间戳的UTC显示

示例KQL查询：

// 将参数时间转换为UTC
let utcStart = todatetime(TimeRange.start) | datetime_utc();
let utcEnd = todatetime(TimeRange.end) | datetime_utc();
// 用UTC时间范围查询App Insights数据
traces
| where timestamp between (utcStart .. utcEnd)
// 保持结果时间戳为UTC格式显示
| project timestamp, message, severityLevel

同时可在可视化组件的「列设置」中，将时间列（如timestamp）的格式设置为「日期/时间」并勾选「使用UTC」，确保前端显示始终为UTC时间。

三、额外注意事项 #

• 确认App Insights日志默认以UTC存储（默认行为），避免转换逻辑冲突
• 在参数旁添加提示文字（如「请输入UTC格式起止时间」），降低用户输入混淆概率

内容的提问来源于stack exchange，提问作者natashar