# 项目时区
# 一、时区管理的意义
（1）对多时区项目（项目的用户来自不同时区、业务跨时区如出海）中的事件时间做统一识别记录，避免失去偏移信息。
（2）按照统一口径，计算展示特定时区下的数据情况，以保证唯一性。如全球总部汇总数据。
目标：所有上传数据的时间换算成展示时区下的时间查看
如：中东一用户，采用中国服务器，在旧金山总部查看数据，只需将展示时区配置为旧金山时区再查看即可。
# 二、配置项目时区
管理员及以上用户可在「项目管理」→「分析配置」中配置项目时区信息。
（1）默认时区配置为关闭状态，即直接按照上报数据的原始时间进行计算和展示。
（2）点击开启“多时区开关”后，可开始进行项目时区的配置。
（3）设置时区偏移属性
将您上报数据中记录时区信息的属性选择为“时区偏移属性”。请使用数值型数据记录事件时间与 UTC 时间的偏移小时数，该数值的有效范围仅限于-12~14 间的数值。
提示
如果采用客户端 SDK （Android SDK v2.2.0 / iOS SDK v2.2.0 / JS SDK v1.2.0 / Unity SDK v1.4.3 以上或其他客户端 SDK），TA 会默认使用#zone_offset自动采集时区信息。此时，您可以直接选择“默认时区偏移”（#zone_offset属性）作为时区偏移属性。
（4）选择项目展示时区
选择在分析时需要进行时间对齐的时区，可将您最常用使用的统计口径下的时区设置为默认时区，它将作为项目成员在分析时使用的初始默认时区。
比如，总部在旧金山（UTC-08:00），并按照该时区统一全球数据的口径，可将 UTC-08:00 设置为项目展示时区。
（5）时区偏移后展示时间的计算方法
展示时间 = 事件时间+（ 展示时区 - 事件时区 ）
（6）完成设置后，点击“保存配置”，即可在分析模型中使用不同的时区，进行统计分析。
# 三、时区的应用
# 3.1 适用范围
注意
由于仅事件会带有时区偏移属性，因此仅时间类型事件属性适用时区偏移，时间类型用户属性不适用
（1）模型、看板中的分析时段、分析粒度（按天、按周等），会基于偏移后的事件时间计算
（2）模型、看板中的表格、图表、下载数据，展示的是偏移后的事件时间及时间类型事件属性
（3）模型、看板中的筛选条件、分群/标签中的时间条件，都是基于偏移后的事件时间及时间类型事件属性计算
（4）全局筛选基于偏移后的时间类型事件属性计算
（5）用户行为序列中的事件时间，以及展示的时间类型事件属性都是偏移后的结果
（6）按时间类型事件属性分组时，会基于偏移后的时间汇总
（7）预警管理中的统计时间和展示时间（按照默认时区计算和展示）
# 3.2 不适用范围
使用服务器时间(UTC+8)进行显示或定时计算的时间数据不进行时区偏移
（1）报表、看板在计算时的数据更新时间
（2）设置看板定时更新、标签分群定时更新都是基于 UTC+8 下的时间
（3）SQL 报表的计算
（4）虚拟属性的创建规则中带有时间类型属性时
创建虚拟属性的过程中时间类型属性不参与偏移，仍按照原始时间计算；如果虚拟属性是时间类型，则在使用虚拟属性时对该属性值进行偏移
# 四、数据计算准则
# 4.1 事件进行偏移处理的条件
选择某属性作为偏移属性后，对某条事件是否进行偏移处理的方法
| 有该属性，有效 | 有该属性，无效 | 无该属性 | |
|---|---|---|---|
| 选择默认属性 | 使用#zone_offset进行偏移 | 不做偏移 | 不做偏移 |
| 选择某一属性 | 使用该属性进行偏移 | 不做偏移 | 不做偏移 |
有该属性无效，如：上传的数据为非数值，无法解析的情况
- 在显示时区下的时间为：原始数据时间+（偏移时区-原始数据时区）
- 该条原始数据时区信息缺失时，不做偏移处理
# 4.2 事件进行偏移处理的案例
从数据本身、时区配置项、模型中分析时间段 3 个角度来看
（1）某条数据带有的主要信息
| #event_time（事件本地时间） | #zone_offset（相对UTC±00:00时区偏移信息） | X某数值型字段（相对UTC±00:00时区偏移信息） |
|---|---|---|
| 2020-01-01 12:00:00 | 8 | -4 |
这条事件的含义为，事件发生的本地时间为 2020-01-01 12:00:00
按#zone_offset来判断，本地的时区为 UTC+08:00
按 X 来判断，本地的时区为 UTC-04:00
（2）时区配置项：开启后的选项
| 场景1 | 场景2 | |
|---|---|---|
| 设置条件 | 按默认属性偏移至UTC+09:00 | 按X偏移至UTC+09:00 |
| 含义 | 将原始数据按UTC+09:00下的情况来显示 | 将原始数据按UTC+09:00下的情况来显示 |
| 原始数据在显示时区下的触发时间为 | 2020-01-01 13:00:00 | 2020-01-02 01:00:00 |
# 五、最佳实践
# 5.1 使用标准时区统一海外数据
时区设置最大的作用，就是将出海产品产生的全球数据以一个确定的时区来标准化，比如所有数据都偏移到 UTC±00:00，通过这样的偏移，可以统一数据指标，避免因时区产生的数据跨天问题。
# 5.2 解决非自然日活动数据
非自然日活动指的是开始与结束时间不遵循当地的自然日变更时间，比如活动在当地凌晨 3 点开始与结束。在分析时，就有可能需要以 3 点作为分析的日期切割点，此时可以使用时区编辑功能，设置与日期切割点相应的时区，在分析时进行切换，即可完成这类活动的留存/回访分析需求。
# 5.3 海外团队的数据查看
如果您的团队中存在海外团队，那么使用时区设置功能。将这些团队所在时区配置成可选时区，那么在查看数据时，即可切换为对应时区，更符合海外团队的使用习惯。同时将默认时区设置为所有团队在沟通讨论时使用的通用时区，既保持了各自的使用习惯，也保证了合作的高效。