在欄位中加入自訂格式

Looker 開發人員注意事項:本頁顯示的格式與 value_format LookML 參數使用的格式相同,但 value_format 參數要求格式字串必須以雙引號括住。

自訂格式可讓您進一步控管 Looker 結果集中數值資料的顯示方式。您可以使用自訂格式,將 Excel 式格式設定選項套用至圖表中顯示的數值資料,或由自訂欄位或資料表計算產生的數值資料。

在圖表中使用自訂格式

視您使用的是預設探索介面還是傳統版探索,對圖表套用自訂格式的步驟會有所不同。

在預設的「探索」介面中使用自訂格式

在「探索」中,您可以使用基本格式預設設定 (包括精簡數字),或輸入進階自訂格式字串,在「設定」面板的「樣式」分頁中設定值的格式。

如要存取「樣式」分頁中的值格式設定選項,請展開圖表類型的專屬部分:

  • 如果是單一值圖表,請展開「樣式」部分。
  • 如果是柱狀圖、長條圖、折線圖、散布圖、面積圖和瀑布圖,請展開「值」部分,然後啟用「值標籤」。
  • 如果是表格圖表,請展開「系列」部分,然後在「自訂」部分展開要設定格式的資料欄。

設定基本格式

在「值的格式」部分 (或表格圖表的「格式」部分),您可以設定下列任一基本格式選項:

  • 精簡數字:使用標準公制字尾縮寫 1,000 以上的數字:K 代表千、M 代表百萬、B 代表十億、T 代表兆。根據預設,這個選項會停用。
  • 小數位數:指定要顯示的小數位數 (Default、0 或 1 至 8)。啟用「精簡數字」時,「預設」會顯示兩位小數 (例如 1,845 會顯示為 1.85K)。選取 0 會將值四捨五入為整數 (例如 2K)。
  • 顯示格式:套用標準顯示預設設定:
    • 預設:使用基礎資料來源的預設格式顯示數值。
    • 數字:以標準數字顯示值,並加上千位分隔符號。
    • 百分比:以百分比形式顯示值,並加上百分比符號 (%)。
    • 財務:顯示的值會包含當地幣別符號 (例如 $)。

設定進階格式

如要套用 Excel 樣式的自訂格式字串,而非基本預設設定,請按照下列步驟操作:

  1. 在「值格式」部分 (或表格圖表的「格式」部分),按一下「切換至進階格式設定」。
  2. 在「Custom Format Rule」(自訂格式規則) 欄位中,輸入自訂格式字串。

如要返回基本格式設定控制項,請按一下「切換至基本格式設定」。你選取的任何基本格式選項都會覆寫自訂格式規則。

在傳統版探索中使用自訂格式

如要在傳統探索中,為柱狀圖、長條圖、折線圖、散布圖、面積圖、瀑布圖、單一值或時間線圖套用自訂格式,請按照下列步驟操作:

  1. 選取「圖表」列上的「編輯」選單。
  2. 選取「值」分頁標籤 (如果是單一值和時間線圖,則選取「樣式」分頁標籤)。
  3. 在「Value Format」(值格式) 欄位中,輸入自訂格式字串。

如要在傳統探索中,對表格圖表套用自訂格式,請按照下列步驟操作:

  1. 選取「圖表」列上的「編輯」選單。
  2. 選取「系列叢書」分頁標籤。
  3. 在「自訂」部分,選取「格式」下拉式選單,然後選擇「自訂...」。

選取「自訂...」後,系統會顯示新的空白欄位。在空白欄位中輸入自訂格式字串。

使用自訂格式搭配資料表計算和自訂欄位

建立或編輯資料表計算或自訂欄位時,請在「格式」下拉式選單中選取「自訂」選項,然後在空白欄位中輸入自訂格式。

自訂格式範例

如要指定這些格式,請參閱 Excel 的完整指南,詳情請參閱這個說明文件頁面。您也可以使用第三方工具建立自訂格式,例如 Custom Formats Builder。

下表列出一些最常見的格式設定選項。如果數字的位數少於代碼中指定的位數,使用 0 的格式代碼會要求顯示不具意義的零。使用 # 的格式代碼只會顯示有效數字,即使數字少於代碼中指定的數字也一樣。

部分特殊字元 (例如國際貨幣符號) 必須視為字串,並以雙引號括住。

格式結果
0整數 (123)
00#整數補零至 3 位數 (001)
0 "String"整數後方附加字串 (123 字串)

(「String」可替換成任何文字字串)
0.##最多到小數點後 2 位的數值 (1.、1.2 或 1.23)
0.00到小數點後 2 位的數值 (1.23)
00#.00數字補零至 3 位數,且小數點後剛好 2 位數 (001.23)
#,##0千位數之間有逗號的數字 (1,234)
#,##0.00千位數之間有逗號,且到小數點後 2 位 (1,234.00)
0.000,, "M"以百萬為單位的數字,到小數點後 3 位 (1.234 M)

系統會自動除以 100 萬
0.000, "K"以千為單位,到小數點後 3 位 (1.234 K)

系統會自動除以 1,000
$0美元,不含小數 ($123)
$0.00到小數點後 2 位的美元 ($123.00)
"€"0歐元,不含小數 (€123)
$#,##0.00美元,千位數之間有逗號,小數點後有 2 位數 ($1,234.00)
$#.00;($#.00)美元,小數點後 2 位,正值正常顯示,負值以括號括住
0\%以百分比顯示,不含小數 (1 變成 1%)
0.00\%以百分比顯示,並保留 2 位小數 (1 變成 1.00%)
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

如果 Looker 開發人員在 LookML 中使用 value_format 參數,請用雙引號括住格式字串,並逸出內部的雙引號:

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

圖表的時間格式

如果圖表的 X 軸有時間維度,您可以使用圖表選項「X」分頁中的「時間標籤格式」設定,變更 X 軸標籤的格式。您可以使用「圖表的時間格式」頁面上的語法,設定時間值的格式。