[comment]: # ({639de728-b282f075})
# 13 时间段和主机选择器

[comment]: # ({/639de728-b282f075})

[comment]: # ({e6286d40-f37e3a77})
#### 概述

本页介绍仪表板上可用的时间段选择器和主机选择器。  
这些选择器可用于动态调整所有兼容的[仪表板小部件](/manual/web_interface/frontend_sections/dashboards/widgets)中显示的数据，而无需编辑各个小部件的设置。

[comment]: # ({/e6286d40-f37e3a77})

[comment]: # ({94514871-880861c5})
#### 时间段选择器

时间段选择器允许通过一次鼠标单击选择常用的时间段。
可通过单击仪表板右上角的时间段选择器按钮将其展开或折叠。

![](../../../assets/en/manual/web_interface/time_period_selector.png){width="600"}

诸如 *Today*、*This week* 等选项会显示整个时间段，包括未来的小时/天数。
诸如 *Today so far*、*This week so far* 等选项则只显示已经过去的小时数。

选择某个时间段后，可以通过单击
![](../../../assets/en/manual/config/visualization/arrow_left.png) ![](../../../assets/en/manual/config/visualization/arrow_right.png) 箭头按钮在时间上前后移动该时间段。
*Zoom out* 按钮可将该时间段向两个方向各缩小 50%。

::: noteclassic
对于 [graphs](/manual/config/visualization/graphs)（*Custom* [time period](/manual/web_interface/frontend_sections/dashboards/widgets/graph/#time-period) 的图形除外），也可以通过鼠标左键在图形中高亮一个区域来选择显示的时间段。
释放鼠标左键后，图形将缩放到高亮区域。
也可以通过在图形中双击来缩小显示范围。
:::

*From/To* 字段以绝对时间语法（格式为 `Y-m-d H:i:s`）或相对时间语法显示所选时间段。
相对时间段可以包含一个或多个数学运算（- 或 +），例如 `now-1d` 或 `now-1d-2h+5m`。

支持以下相对时间缩写：

-   `now`
-   `s`（秒）
-   `m`（分钟）
-   `h`（小时）
-   `d`（天）
-   `w`（周）
-   `M`（月）
-   `y`（年）

时间段选择器支持精度设置（例如，`now-1d/M` 中的 `/M`）。精度详情如下：

|精度|From|To|
|--|----|----|
|`m`|Y-m-d H:m:00|Y-m-d H:m:59|
|`h`|Y-m-d H:00:00|Y-m-d H:59:59|
|`d`|Y-m-d 00:00:00|Y-m-d 23:59:59|
|`w`|该周的星期一 00:00:00|该周的星期日 23:59:59|
|`M`|该月第一天 00:00:00|该月最后一天 23:59:59|
|`y`|该年 1 月 1 日 00:00:00|该年 12 月 31 日 23:59:59|

也可以使用日期选择器来选择时间段。
要打开它，请单击 *From/To* 字段旁边的日历图标。

![](../../../assets/en/manual/config/date_picker.png)

::: noteclassic
在日期选择器中，可以使用 `Tab`、`Shift+Tab` 和键盘方向键在年/月/日期之间导航。
按 `Enter` 确认选择。
:::

[comment]: # ({/94514871-880861c5})

[comment]: # ({867eae11-f6a303da})
示例：

|From|To|所选时间段|
|--|--|------|
|`now/d`|`now/d`|今天 00:00 - 23:59|
|`now/d`|`now/d+1d`|今天 00:00 - 明天 23:59|
|`now/w`|`now/w`|本周一 00:00:00 - 本周日 23:59:59|
|`now-1y/w`|`now-1y/w`|一年前该周的周一 00:00:00 - 周日 23:59:59|

::: noteimportant
对 *To* 参数使用 "now/M+1M" 可能会增加 31 天，这可能导致日期根据月份天数不同而偏移 1-3 天。例如，如果在 1 月使用，结果可能是 3 月 2 日，而不是预期的 2 月 28 日。为避免此问题，请使用 "now/M-3d+1M/M"，这样可以准确根据月份长度进行调整。类似地，如果配置向后回溯的 *From*，请使用 "now/M+3d-1M/M"。
:::

[comment]: # ({/867eae11-f6a303da})

[comment]: # ({d8a21cc4-6b1a1126})
#### 主机选择器

主机选择器允许您选择一个主机，以便其数据显示在兼容的仪表板小部件中。

如果至少有一个小部件配置了 *Override host* 参数，并将仪表板用作[数据源](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters)，则在[编辑并保存](/manual/web_interface/frontend_sections/dashboards#editing-a-dashboard)仪表板后，此选择器将可用。

![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/dynamic_selection.png){width="600"}

[comment]: # ({/d8a21cc4-6b1a1126})