named_value_format

Penggunaan

named_value_format: desired_name {
  value_format: "excel formatting string"
  strict_value_format: yes | no
}

Hierarki File Model named_value_format

Nilai Default Tidak ada Menerima Nama untuk format kustom Anda ditambah string pemformatan gaya Excel yang menentukan format dan nilai Boolean untuk subparameter strict_value_format opsional

Definisi

Parameter named_value_format memungkinkan Anda membuat dan menyimpan format kustom yang dapat diterapkan ke beberapa dimensi dan ukuran.

Format kustom di Looker dibuat dan digunakan dalam beberapa langkah:

1. Pertama, Anda menggunakan named_value_format dalam file model untuk mendeklarasikan nama format kustom baru. Nama ini harus berupa string tanpa spasi.
2. Selanjutnya, Anda menggunakan subparameter value_format di bagian named_value_format untuk menentukan pemformatan yang Anda inginkan dengan memberikan string format gaya Excel.
3. Terakhir, terapkan format kustom ini ke dimensi dan ukuran dengan mereferensikannya dalam parameter value_format_name di tingkat kolom.

Anda dapat menentukan lebih dari satu format kustom dalam model, seperti yang ditunjukkan dalam contoh berikut.

String pemformatan value_format umum

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.

Berikut ini beberapa opsi pemformatan yang paling umum. 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)
                              #   Please 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)
                              #   Please note division by 1 million happens automatically
value_format: "0.000,\" K\""  # Number in thousands with 3 decimals (1.234 K)
                              #   Please 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%)

strict_value_format menggantikan atribut pengguna number_format

Biasanya, pemformatan angka yang ditetapkan di atribut pengguna number_format diterapkan di atas format yang dibuat dengan named_value_format. Namun, jika Anda menyetel subparameter strict_number_format opsional ke yes, pemformatan dari number_format tidak akan diterapkan, dan kolom akan mempertahankan pemformatan dari named_value_format. Untuk melihat contoh dan mempelajari lebih lanjut, buka halaman dokumentasi Melokalkan pemformatan angka.

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.

Contoh

Buat format kustom bernama euro_in_thousands yang terlihat seperti €1.23K:

named_value_format: euro_in_thousands {
  value_format: "\"€\"0.000,\" K\""
}

Mencegah atribut pengguna number_formatting memengaruhi format euro_in_thousands:

named_value_format: euro_in_thousands {
  value_format: "\"€\"0.000,\" K\""
  strict_value_format: yes
}

Lihat juga halaman dokumentasi Melokalkan pemformatan angka untuk contoh lainnya.

Buat format kustom bernama usd_in_millions yang terlihat seperti $1,23M dan format bernama phone_number yang terlihat seperti [phone]:

named_value_format: usd_in_millions {
  value_format: "$0.000,,\" M\""
}
named_value_format: phone_number {
  value_format: "(###) ###-####"
}