フィールドにカスタム書式設定を追加する

Looker デベロッパー向け: このページに表示される形式は、value_format LookML パラメータで使用される形式と同じです。ただし、value_format パラメータでは書式設定する文字列を二重引用符で囲む必要があります。

カスタム書式設定を使うことによって、Looker 結果セットでの数値データの表示方法を、さらにコントロールすることができます。カスタム書式設定を使用すると、ビジュアリゼーショで表示される数値データ、またはカスタム フィールドや表計算によって生成される数値データに、Excel スタイルの書式設定オプションを適用できます。

ビジュアリゼーションでカスタム書式設定を使用する

ビジュアリゼーションにカスタム書式を適用する手順は、デフォルトの Explore インターフェースと従来の Explore のどちらを使用しているかによって異なります。

デフォルトの Explore インターフェースでカスタム書式設定を使用する

[データ探索] では、[設定] パネルの [スタイル] タブで、基本的な書式設定プリセット(コンパクトな数値を含む)を使用するか、高度なカスタム書式設定文字列を入力して、値を書式設定できます。

[スタイル] タブの値の書式設定オプションにアクセスするには、ビジュアリゼーション タイプのセクションを開きます。

  • 単一値グラフの場合は、[スタイル] セクションを開きます。
  • 縦棒グラフ、横棒グラフ、折れ線グラフ、散布図、面グラフ、滝グラフの場合は、[値] セクションを開いて [値ラベル] を有効にします。
  • 表グラフの場合は、[系列] セクションを開き、[カスタマイズ] セクションで書式設定する列を開きます。

基本的な書式設定を構成する

[値の形式] セクション(またはテーブルグラフの [形式] セクション)では、次の基本的な形式オプションを構成できます。

  • コンパクトな数値: 1,000 以上の数値を標準的な指標の接尾辞で省略します。K は千、M は百万、B は十億、T は兆を表します。デフォルトではこのオプションは無効になっています。
  • 小数点精度: 表示する小数点以下の桁数を指定します(Default、0、1~8)。[数値を短縮表示] が有効になっている場合、[デフォルト] では小数点以下 2 桁が表示されます(例: 1,845 は 1.85K と表示されます)。0 を選択すると、値が整数に丸められます(例: 2K)。
  • 表示形式: 標準の表示プリセットを適用します。
    • デフォルト: 基になるデータソースのデフォルトの形式を使用して数値を表示します。
    • 数値: 値を桁区切り記号付きの標準的な数値として表示します。
    • パーセント: 値をパーセント記号(%)付きのパーセンテージとして表示します。
    • 財務: ローカライズされた現地通貨記号($ など)を含む値を表示します。

高度な書式設定の構成

基本的なプリセットではなく、Excel スタイルのカスタム書式設定文字列を適用する手順は次のとおりです。

  1. [値の形式] セクション(またはテーブルグラフの [形式] セクション)で、[高度な書式設定に切り替える] をクリックします。
  2. [カスタム書式ルール] フィールドに、カスタム書式設定文字列を入力します。

基本的な書式設定コントロールに戻るには、[基本的な書式設定に切り替え] をクリックします。選択した基本的な書式設定オプションは、カスタム書式ルールをオーバーライドします。

従来の Explore でカスタム書式設定を使用する

従来の Explore で、縦棒グラフ、横棒グラフ、折れ線グラフ、散布図、面グラフ、ウォーターフォール グラフ、単一値グラフ、タイムライン グラフにカスタム書式を適用する手順は次のとおりです。

  1. [Visualization] バーの [Edit] メニューを選択します。
  2. [値] タブ(単一値グラフとタイムライン グラフの場合は [スタイル] タブ)を選択します。
  3. [値の書式設定] フィールドに、カスタム書式設定文字列を入力します。

従来の Explore でテーブル ビジュアリゼーションにカスタム書式を適用する手順は次のとおりです。

  1. [Visualization] バーの [Edit] メニューを選択します。
  2. [Series] タブを選択します。
  3. [Customizations] セクションで、[Format] プルダウンを選択し、[Custom...] を選択します。

[Custom...] を選択すると、新しい空白フィールドが表示されます。空白のフィールドに、カスタム書式設定文字列を入力します。

表計算とカスタムフィールドでカスタム書式設定を使用する

表計算やカスタム フィールドを作成または編集するときは、[Format] プルダウンで [Custom] オプションを選択し、空白フィールドにカスタム形式を入力します。

カスタム書式設定の例

Excel の完全ガイドを参照して、数値形式コードのドキュメント ページにあるこうした形式を指定するか、サードパーティのツール(Custom Formats Builder など)を使用してカスタム形式を作成できます。

下の表に、最も一般的な書式設定オプションを示します。0 を使用する書式設定コードは、数字の桁数がコードで指定した桁数に満たない場合、上位の桁にゼロの表示を求めます。# を使用する書式設定コードでは、コードで指定した桁数に満たない場合、有効桁のみが表示されます。

国際通貨記号などのいくつかの特殊文字は、文字列として扱い、二重引用符で囲む必要があります。

形式結果
0整数(123)
00#百の位までゼロパディングされた整数(001)
0 "String"文字列(123 文字列)が続く整数

(「文字列」は任意のテキスト文字列に置き換え可能)
0.##小数点以下 2 桁までの数字(1、1.2、または 1.23)
0.00小数点以下 2 桁の数字(1.23)
00#.00百の位までゼロパディングされた整数と、小数点以下 2 桁の数字(001.23)
#,##0千区切りのコンマのある数字(1,234)
#,##0.00千区切りのコンマがあり、小数点以下 2 桁の数字(1,234.00)
0.000,, "M"小数点以下 3 桁の 100 万単位の数字(1.234 M)

100 万の区切りは自動的に行われます。
0.000, "K"小数点以下 3 桁 1000 単位の数字(1.234 M)

1000 の区切りは自動的に行われます。
$0小数点以下 0 桁のドル($123)
$0.00小数点以下 2 桁のドル($123.00)
"€"0小数点以下0桁のユーロ(€123)
$#,##0.00千区切りのある数字と小数点以下 2 桁のドル($1,234.00)
$#.00;($#.00)小数点以下 2 桁で、プラスの数値は正常に表示され、マイナスの数値は括弧の中に収められるドル
0\%小数点以下 0 桁のパーセントとして表示(1 は 1%)
0.00\%小数点以下 2 桁のパーセントとして表示(1 は 1.00%)
0%小数点以下 0 桁のパーセントに変換(.01 は 1%)
0.00%小数点以下 2 桁のパーセントに変換(.01 は 1.00%)

カスタムの桁区切り記号と条件付き書式

Looker では、Excel 形式の書式設定ルールが使用されます。Looker はカンマを桁区切り記号として認識しますが、スイスフラン(CHF)に使用されるアポストロフィなどの他の文字はリテラル文字として扱います。

アポストロフィを桁区切り記号として直接使用すると(例: "CHF "#'##0.00)、書式設定エンジンはアポストロフィをリテラル文字として扱い、1,000 未満の値でも出力文字列に強制的に挿入します(例: CHF 20.00 ではなく CHF '20.00)。

1,000 以上の数値にのみカスタムの桁区切り記号を適用するには、書式設定文字列内で条件付き書式を使用します。1,000 以上の数値と 1,000 未満の数値に対して、セミコロンで区切って異なる書式設定ルールを指定できます。

[>=1000]"CHF "#'##0.00;[<1000]"CHF "0.00

LookML で value_format パラメータを使用する Looker デベロッパーは、書式設定文字列を二重引用符で囲み、内部の二重引用符をエスケープします。

value_format: "[>=1000]\"CHF \"#'##0.00;[<1000]\"CHF \"0.00"

グラフにおける時間のフォーマット

グラフの X 軸に時間ディメンションがある場合は、可視化オプションの [X] タブにある [時間ラベルの形式] 設定を使用して、X 軸ラベルの形式を変更できます。時間値の書式設定には、グラフの時間形式ページの構文を使用します。