时间控件¶
通过时间控件控制当前查看器的数据展示范围。您可以通过手动输入时间范围、快速选择预设时间范围或自定义设置时间范围来筛选数据。
预设时间范围¶
系统提供了多种预设的快捷时间范围。通过点击“更多”可选择更多时间范围进行数据查看。预设的时间范围包括：
动态时间¶
包括分、天、周、月四种单位，如今日、昨日、本周、上周等。
静态时间¶
包含两种格式：
-
日期
-
时间戳
日期¶
静态的日期时间格式支持多种写法，时间精度到毫秒，间隔符包括 ~、/、- 或 ,，前后允许有空格。例如：
-
2025/08/04 09:30:00~2025/08/04 10:00:00 -
2025/08/04 09:30:00.123-2025/08/04 10:00:00.456 -
2025/08/04 09:30:00,2025/08/04 10:00:00
时间戳¶
时间戳范围支持毫秒级输入，间隔符包括 ~、- 或 ,，前后允许有空格。例如：
-
1659576600000~1659578400000 -
1659576600000-1659578400000 -
1659576600000,1659578400000
注意
-
时间格式必须符合
时:分:秒的标准 -
时间控件的提示框和输入框实时联动。当输入的时间范围超过四位数时（包括时间区间、绝对时间和时间戳），提示框会显示
-
自定义时间范围¶
除预设的时间范围外，您可通过点击“自定义时间”来手写具体的时间范围，支持日期与时间的组合，手写标准如下：
-
日期分隔符：支持 “/ ” 和 “ - ”（例如 2025/10/10 或 2025-10-10）
-
时间格式：支持 HH:MM:SS 或 HH:MM（24 小时制）
-
组合格式：日期和时间可以组合，用空格分隔（例如 2025/10/10 16:14:20）
注意
-
自定义时间范围的开始和结束时间必须按照
时:分:秒的格式输入，如15:01:09； -
自定义时间范围的查询记录可以在自定义时间查询历史中查看，最多支持最近 20 条历史记录。点击任意历史记录即可快速筛选对应的数据。
URL 的时间范围¶
除了通过时间控件选择时间范围外，还可以在浏览器的 URL 中直接修改 time 参数来查询数据。支持秒（s）、分（m）、时（h）、天（d）四种单位，例如：
-
time=30s -
time=20m -
time=6h -
time=2d
在浏览器中修改 time=2h 后，查看器将展示最近 2 小时的数据。
注意
-
每种单位只能独立使用，不可组合；
-
当选择的时间范围大于或等于 1 天时，查看器将自动停止播放模式。
锁定时间范围¶
通过点击时间控件中的 ，您可以设置固定的查询时间范围。设置完成后，所有查看器和仪表板将默认显示当前的时间范围。
例如，如果锁定时间为 “最近 2 小时”，则所有查看器和仪表板都将按照此时间范围展示数据。
时区¶
在时间控件中设置当前显示的时区，以便切换到对应的工作空间时区查看数据。
-
进入时间控件 > 时区设置；
-
在修改时区窗口，默认显示 “浏览器时间”，即本地浏览器检测到的时间；
-
选择时区；
-
确定。
注意
-
仅当前工作空间的 Owner 及 Administrator 拥有工作空间时区的配置权限；
-
如果工作空间的拥有者或管理员设置了“工作空间时区”，成员可以选择配置好的工作空间时区；
-
设置新的时区后，您当前账号所在的所有工作空间都将按照设置后的时区进行显示，请谨慎操作。
工作空间时区¶
为了确保工作空间成员能够在统一的时区下分析数据和排查问题，您可以为工作空间配置一个统一的时区。
-
点击管理 > 空间设置 > 工作空间时区；
-
进入设置弹窗；
-
选择时区；
-
确定。
配置完成后，工作空间的其他成员可以选择已配置的工作空间时区，其时区状态将跟随配置好的时区变化。
注意
-
仅当前工作空间的 Owner 及 Administrator 拥有工作空间时区的配置权限；
-
设置工作空间时区后，不会自动更改成员的时区，成员需要手动选择工作空间时区；
-
如果工作空间时区被删除，已选择该时区的成员将自动切换回浏览器时间。
自动刷新¶
“自动刷新”可让您快速获取实时数据。支持的刷新频率包括：5 秒、10 秒、30 秒、1 分钟、5 分钟、30 分钟和 1 小时。
如果不需要自动刷新，选择关闭（Off）即可。
时间控件 VS 刷新频率
-
“刷新频率”不会影响“时间控件”的变化
-
如果所选时间范围超过 1 小时或为绝对时间，刷新频率可能会受到影响
-
如果重新选择时间范围小于 1 小时的相对时间，刷新频率将自动恢复为上次的配置
-
在选择“相对时间”时，即使刷新频率为 “off”，修改查询条件（如查看器中增减筛选条件、调整搜索框过滤条件，或仪表板/笔记中切换视图变量）仍会触发重新查询
注意
所有查看器共享一个刷新配置。更改刷新频率会影响所有查看器。
播放¶
选定时间范围后，执行查询操作，点击 ▶️ 按钮可快速回到最近指定时间范围。
例如：选中 [40m][2025/10/20 11:30:10 ~ 2025/10/20 12:10:10]，点击“播放”，即可回到 “最近 40 分钟”。
快捷缩放¶
在实际的数据查询场景里，您可能经常需要调整时间范围（timerange）来观察数据的整体趋势或定位特定异常。点击“快捷缩放”，系统会以当前时间范围的中心为基准，一键放大时间范围，从而减少手动调整时间范围的操作步骤。
缩放逻辑
点击“快捷缩放”，timerange 扩大至原来的 3 倍。
-
先以当前的结束时间向后推 1 倍 timerange，最新可到当前时间，得到 EndTime
-
再以 EndTime 向前推 3 倍 timerange，作为 StartTime
-
查询相对时间时，直接扩大 3 倍
应用场景¶
假设当前查看器查询时间为 11:00：
-
场景 1：需查询 10:20-10:30，此时 timerange = 10m，点击“快捷缩放”后，系统查询 10:10-10:40
-
场景 2：需查询 10:30-10:50，此时 timerange = 20m ，点击“快捷缩放”后，系统查询 10:00-11:00
-
场景 3：查询“最近 30 分钟”，点击“快捷缩放”后，系统查询“最近 90 分钟”