value_format

Penggunaan

view: view_name {
  dimension: field_name {
    value_format:"$#.00;($#.00)"
  }
}
Hierarki
view
Jenis Kolom
value_format
Kemungkinan Jenis Kolom
Dimensi, Metrik

Menerima
String yang berisi pemformatan bergaya Excel

Definisi

Parameter value_format memungkinkan Anda memformat nilai data di Looker menggunakan format bergaya Excel. Anda dapat menggunakan value_format dengan cara berikut:

  • Sendiri, di tingkat kolom, untuk menerapkan pemformatan bergaya Excel langsung ke dimensi atau metrik tertentu
  • Sebagai subparameter dari parameter named_value_format, di tingkat model, untuk membuat format kustom yang dapat digunakan kembali dan dapat diterapkan ke beberapa kolom

Menerapkan value_format langsung ke dimensi dan metrik

Parameter value_format dapat digunakan pada dimensi dan metrik. Untuk menerapkan pemformatan bergaya Excel ke dimensi melalui value_format, jenis dimensi harus berupa number. Untuk menerapkan pemformatan bergaya Excel ke metrik melalui value_format, pastikan metriknya numerik dan bukan dari type: string. Contoh:

dimension: order_amount {
  type: number
  sql: ${TABLE}.order_amount ;;
  value_format: "$#.00;($#.00)"
}
measure: total_order_amount {
  type: sum
  sql: ${order_amount} ;;
  value_format: "$#.00;($#.00)"
}

Menggunakan value_format untuk menentukan format kustom yang dapat digunakan kembali

Untuk mengetahui informasi tentang cara menggunakan value_format dengan named_value_format untuk menentukan format yang dapat digunakan kembali, lihat halaman dokumentasi parameter named_value_format.

Opsi pemformatan default

Jika Anda lebih suka menerapkan salah satu format nilai bawaan Looker, Anda dapat memilih dari format yang tercantum di bagian Nama Format Default pada halaman dokumentasi parameter value_format_name. Lihat halaman tersebut untuk mengetahui petunjuk tentang cara menggunakan value_format_name untuk menerapkan format bawaan.

String pemformatan umum

value_format menerima string pemformatan bergaya Excel.

Pemformatan yang digunakan dengan parameter value_format sama dengan pemformatan yang digunakan di kolom Format Nilai dalam visualisasi, kecuali bahwa parameter value_format mengharuskan string pemformatan diapit tanda kutip ganda. Lihat halaman dokumentasi Opsi diagram kolom untuk mengetahui informasi tentang format nilai dalam visualisasi.

Anda dapat membaca panduan lengkap Excel tentang cara menentukan format ini dalam dokumentasinya. Namun, saat ini, pemformatan tanggal, pemformatan warna, dan konversi heksadesimal tidak didukung di Looker.

Beberapa opsi pemformatan yang paling umum ditampilkan di sini. Perhatikan bahwa beberapa karakter khusus, seperti simbol mata uang internasional, harus diapit tanda kutip ganda.

value_format: "0"             # Integer (123)
value_format: "*00#"          # Integer zero-padded to 3 places (001)
value_format: "0 \" String\"" # Integer followed by a string (123 String)
                              #   Note \"String\" can be replaced with any other word

value_format: "0.##"          # Number up to 2 decimals (1. or 1.2 or 1.23)
value_format: "0.00"          # Number with exactly 2 decimals (1.23)
value_format: "*00#.00"       # Number zero-padded to 3 places and exactly 2 decimals (001.23)
value_format: "#,##0"         # Number with comma between thousands (1,234)
value_format: "#,##0.00"      # Number with comma between thousands and 2 decimals (1,234.00)
value_format: "0.000,,\" M\"" # Number in millions with 3 decimals (1.234 M)
                              #   Note division by 1 million happens automatically
value_format: "0.000,\" K\""  # Number in thousands with 3 decimals (1.234 K)
                              #   Note division by 1 thousand happens automatically

value_format: "$0"            # Dollars with 0 decimals ($123)
value_format: "$0.00"         # Dollars with 2 decimals ($123.00)
value_format: "\"€\"0"        # Euros with 0 decimals (€123)
value_format: "$#,##0.00"     # Dollars with comma btwn thousands and 2 decimals ($1,234.00)
value_format: "$#.00;($#.00)" # Dollars with 2 decimals, positive values displayed
                              #   normally, negative values wrapped in parenthesis

value_format: "0\%"           # Display as percent with 0 decimals (1 becomes 1%)
value_format: "0.00\%"        # Display as percent with 2 decimals (1 becomes 1.00%)
value_format: "0%"            # Convert to percent with 0 decimals (.01 becomes 1%)
value_format: "0.00%"         # Convert to percent with 2 decimals (.01 becomes 1.00%)

Untuk contoh pemformatan bersyarat yang lebih canggih dengan parameter value_format, lihat halaman Praktik Terbaik Pemformatan bersyarat menggunakan value_format.

Tantangan umum

Kehilangan desimal saat membagi

Salah satu keunikan SQL umum yang muncul saat menggunakan value_format adalah cara SQL menangani matematika bilangan bulat. Jika Anda membagi 5 dengan 2, sebagian besar orang mengharapkan hasilnya adalah 2,5. Namun, banyak dialek SQL akan menampilkan hasil hanya 2, karena saat membagi dua bilangan bulat, hasil yang diberikan juga berupa bilangan bulat. Untuk mengatasi hal ini, Anda dapat mengalikan pembilang dengan angka desimal (seperti 1,0 atau 100,0) untuk memaksa SQL menampilkan hasil desimal. Contoh:

measure: active_users_percent {
  type: number
  sql: 100.000 * ${active_users} / ${users} ;;
  value_format: "0.000"
}

Menggunakan value_format dengan atribut pengguna number_format

Jika Anda menggunakan value_format untuk memformat kolom dalam model, format angka yang dipilih dalam atribut pengguna number_format akan diterapkan di atas format yang diterapkan dengan value_format. Untuk contoh, dan mempelajari lebih lanjut, buka halaman dokumentasi Melokalkan pemformatan angka.