value_format

Penggunaan

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

Menerima
String yang berisi pemformatan gaya Excel

Definisi

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

  • Dengan sendirinya, di tingkat kolom, untuk menerapkan pemformatan bergaya Excel langsung ke dimensi atau ukuran 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 ukuran

Parameter value_format dapat digunakan pada dimensi dan ukuran. Untuk menerapkan format gaya Excel ke dimensi melalui value_format, jenis dimensi harus number. Untuk menerapkan pemformatan gaya Excel ke ukuran melalui value_format, pastikan ukuran bersifat numerik dan bukan 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 penggunaan 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 gaya Excel.

Pemformatan yang digunakan dengan parameter value_format sama dengan pemformatan yang digunakan di kolom Format Nilai dalam visualisasi, kecuali parameter value_format memerlukan string pemformatan yang diapit tanda petik 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 dalam 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 format bersyarat yang lebih canggih dengan parameter value_format, lihat halaman Praktik Terbaik Format 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 akan mengharapkan hasilnya adalah 2,5. Namun, banyak dialek SQL akan menampilkan hasilnya hanya sebagai 2, karena saat membagi dua bilangan bulat, hasilnya 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 di atribut pengguna number_format akan diterapkan di atas format yang diterapkan dengan value_format. Untuk melihat contoh dan mempelajari lebih lanjut, buka halaman dokumentasi Melokalkan pemformatan angka.