用法
view: view_name {
dimension: field_name {
convert_tz: yes | no
}
}
|
层次结构
convert_tz |
可能的字段类型
维度、维度组、测量、过滤条件、参数
接受
布尔值（yes 或 no）
|
定义
Looker 具有各种时区设置，可在不同时区之间转换基于时间的数据。Looker 默认会进行时区转换。如果您不希望 Looker 针对特定 dimension、dimension_group（具有 type: time）或 filter 字段执行时区转换，则可以使用 convert_tz 参数。此参数适用于已转换为适当的时区的字段，或在某些高级情况下，您需要避免进行两次时区转换。
一般来说，只有在对全部转换为同一时区的时间值进行操作时，时间计算（差值、时长等）才能正常进行。在编写 LookML 时，请务必注意时区。
示例
不为 local_created 维度组执行时区转换：
dimension_group: local_created {
type: time
timeframes: [time, date, week, month]
sql: ${TABLE}.local_created_at ;;
convert_tz: no
}
注意事项
convert_tz: no 仅适用于维度，不适用于使用该维度的过滤条件。换句话说，过滤条件始终会执行时区转换。指定 convert_tz: no 后，基于时间的数据值会以数据库时区显示，但会使用查询时区进行过滤。
由于过滤条件始终会进行时区转换，因此数据库时区与查询时区之间的差异可能会导致数据意外包含在数据集中或从数据集中排除。为避免这种情况，请确保将查询时区设置为与数据库时区相同的值。
如果用户自选时区已启用，请将时区下拉菜单（位于“探索”、Look 和信息中心内的运行按钮旁边）设置为与数据库时区相同的值。如果用户自选时区处于停用状态，请将查询时区设置为与数据库时区相同的值。
如果您使用的是自定义过滤条件，请保持启用时区转换，以确保日期比较有效。如果您使用 convert_tz: no 关闭时区转换，并在自定义过滤条件中添加该字段，则日期比较可能会无效。
支持时区转换的数据库方言
为了让 Looker 在 Looker 项目中转换时区，您的数据库方言必须支持时区转换。下表显示了在最新版 Looker 中，哪些方言支持时区转换：
| 方言 | 是否支持？ |
|---|---|
| Actian Avalanche | |
| Amazon Athena | |
| Amazon Aurora MySQL | |
| Amazon Redshift | |
| Amazon Redshift 2.1+ | |
| Amazon Redshift Serverless 2.1+ | |
| Apache Druid | |
| Apache Druid 0.13.x - 0.17.x | |
| Apache Druid 0.18+ | |
| Apache Hive 2.3+ | |
| Apache Hive 3.1.2+ | |
| Apache Spark 3+ | |
| ClickHouse | |
| ClickHouse 26+ | |
| Cloudera Impala 3.1+ | |
| Cloudera Impala 3.1+ with Native Driver | |
| Cloudera Impala with Native Driver | |
| DataVirtuality | |
| Databricks | |
| Denodo 7 | |
| Denodo 8 & 9 | |
| Dremio | |
| Dremio 11+ | |
| Dremio 26+ with Arrow Flight SQL | |
| Exasol | |
| Google BigQuery Legacy SQL | |
| Google BigQuery Standard SQL | |
| Google Cloud AlloyDB for PostgreSQL | |
| Google Cloud PostgreSQL | |
| Google Cloud SQL | |
| Google Spanner | |
| Greenplum | |
| HyperSQL | |
| IBM Netezza | |
| MariaDB | |
| Microsoft Azure PostgreSQL | |
| Microsoft Azure SQL Database | |
| Microsoft Azure Synapse Analytics | |
| Microsoft SQL Server 2008+ | |
| Microsoft SQL Server 2012+ | |
| Microsoft SQL Server 2016 | |
| Microsoft SQL Server 2017+ | |
| MongoBI | |
| MongoSQL | |
| MySQL | |
| MySQL 8.0.12+ | |
| Oracle | |
| Oracle ADWC | |
| PostgreSQL 9.5+ | |
| PostgreSQL pre-9.5 | |
| PrestoDB | |
| PrestoSQL | |
| SAP HANA | |
| SAP HANA 2+ | |
| SingleStore | |
| SingleStore 7+ | |
| Snowflake | |
| Teradata | |
| Trino | |
| Vector | |
| Vertica |