Contour中的时区

本页面描述了适用于Contour的时区配置，以及Contour的DateTime类型。

时区配置

Contour有两种不同的时区配置，会影响日期时间的显示方式：

1. 分组时区（面板级设置）： 允许用户以时间分组数据的面板（如图表、直方图或时间序列）要求用户选择时间列的时区。这决定了数据的分组方式。例如，如果选择UTC时区，则数据将按UTC午夜开始和结束的天进行分组。为了确保面板在用户之间显示一致的数据，此设置不能默认设置为用户的本地时区，必须设置为固定的时区。下方展示了图表面板中的配置示例。它指出，由于分析中配置的可视化时区，数据将以UTC显示。

   

2. 可视化时区（分析级设置）： 这是用于在用户界面中可视化日期时间的时区。此设置影响分析中每个面板显示数据的方式。例如，如果一个面板配置为按UTC的天进行分组，而分析配置为在UTC+5中渲染时区，则面板将显示天似乎从UTC+5的凌晨5:00开始和结束。此设置位于设置侧边面板的数据设置部分，可以默认设置为用户的本地时区，以便每个查看分析的用户都能在其自己的时区中查看所有日期时间。此设置可以在设置侧边面板的数据设置部分找到。

   

例如，在上面的图表面板示例中，数据在EDT中分组，而分析配置为在UTC中显示数据。因此，条在EDT中分组但在UTC中显示，导致跨度从晚上8:00到次日晚上8:00的分组。如果此分析使用本地时区作为可视化时区设置，那么对于不同时区的用户，这个图表看起来会略有不同，但分组将代表完全相同的数据。

一些较旧的分析可能没有配置可视化时区设置。在这种情况下，不同的面板在显示日期时间的时区方面会有不同的行为。

Contour中的DateTime类型

您可以使用Mesa语言（一种专有的基于Java的DSL）创建DateTime类型。在Contour中使用此类型时，DateTime类型会自动转换为timestamp列，并创建一个额外的列以标记原始时区。

例如，如果您在原始数据集中有列landing_datetime，您将在Contour中看到两个列：landing_datetime_timestampinUTC，表示原始datetime列为Timestamp类型，以及landing_datetime_originalTimezone，其中包含该列的原始时区，类型为字符串。