convert_tz

使用状況

表示: view_name {
dimension: field_name {
convert_tz: はい | いいえ
}
}
階層
view
フィールド タイプ
convert_tz
使用可能なフィールドタイプ
ディメンション、ディメンション グループ、メジャー、フィルタ、パラメータ

許可
ブール値（はい / いいえ）

定義

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 を指定すると、時間ベースのデータ値はデータベースのタイムゾーンで表示されますが、クエリのタイムゾーンを使用してフィルタリングされます。

フィルタは常にタイムゾーン変換を行うため、データベースのタイムゾーンとクエリのタイムゾーンが一致しないために、データが予期せず含まれたり、データセットから除外されたりすることがあります。この問題を回避するには、クエリのタイムゾーンがデータベースのタイムゾーンと同じ値に設定されていることを確認してください。

ユーザー固有のタイムゾーンが有効になっている場合は、タイムゾーンのプルダウン メニュー（Explore、Look、ダッシュボードの [Run] ボタンの横）をデータベースのタイムゾーンと同じ値に設定します。ユーザー固有のタイムゾーンが無効になっている場合は、Query Zone を、データベースと同じタイムゾーンに設定します。

カスタム フィルタを使用している場合は、タイムゾーン変換を有効にして、日付比較が正しくなるようにします。convert_tz: no でタイムゾーン変換を無効にして、カスタム フィルタにフィールドを含めると、期間比較が無効になることがあります。

タイムゾーン変換のデータベース言語のサポート

Looker プロジェクトでタイムゾーンを変換するには、データベース言語がタイムゾーン変換をサポートしている必要があります。次の表は、Looker の最新リリースでタイムゾーン変換をサポートしている言語を示しています。