使用状況
dimension: field_name {
convert_tz: はい | いいえ
}
}
階層
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 の最新リリースでタイムゾーン変換をサポートしている言語を示しています。