Properti Sel MDX - Konten FORMAT_STRING

Berlaku untuk: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Properti sel FORMAT_STRING memformat properti sel VALUE , membuat nilai untuk properti sel FORMATTED_VALUE . Properti sel FORMAT_STRING menangani nilai string dan mentah numerik, menerapkan ekspresi format terhadap nilai untuk mengembalikan nilai yang diformat untuk properti sel FORMATTED_VALUE . Tabel berikut merinci sintaksis dan karakter pemformatan yang digunakan untuk menangani nilai string dan numerik.

Nilai String

Ekspresi format untuk string dapat memiliki satu atau dua bagian yang dipisahkan oleh titik koma (;).

Penggunaan	Hasil
Satu bagian	Format berlaku untuk semua nilai string.
Dua bagian	Bagian pertama berlaku untuk data string, sedangkan bagian kedua berlaku untuk nilai null dan string panjang nol ("").

Karakter yang dijelaskan dalam tabel berikut ini bisa muncul dalam string format untuk string karakter.

Karakter	Deskripsi
@	Mewakili tempat penampung karakter yang menampilkan karakter atau spasi. Jika string memiliki karakter di posisi di mana tanda (@) muncul dalam string format, string yang diformat akan menampilkan karakter. Jika tidak, string yang diformat menampilkan spasi dalam posisi tersebut. Tempat penampung diisi dari kanan ke kiri kecuali ada tanda seru (!) dalam string format.
&	Mewakili tempat penampung karakter yang menampilkan karakter atau tidak sama sekali. Jika string memiliki karakter di posisi tempat ampersand (&) muncul, string yang diformat akan menampilkan karakter. Jika tidak, string yang diformat tidak menampilkan apa pun. Tempat penampung diisi dari kanan ke kiri kecuali ada tanda seru (!) dalam string format.
<	Memaksa huruf kecil. String yang diformat menampilkan semua karakter dalam format huruf kecil.
>	Paksa huruf besar. String yang diformat menampilkan semua karakter dalam format huruf besar.
!	Memaksa pengisian tempat penampung kiri-ke-kanan. (Defaultnya adalah mengisi tempat penampung dari kanan ke kiri.)

Nilai Numerik

Ekspresi format yang ditentukan pengguna untuk angka dapat memiliki di mana saja dari satu hingga empat bagian yang dipisahkan oleh titik koma. Jika argumen format berisi salah satu format numerik bernama, hanya satu bagian yang diizinkan.

Penggunaan	Hasil
Satu bagian	Ekspresi format berlaku untuk semua nilai.
Dua bagian	Bagian pertama berlaku untuk nilai positif dan nol, nilai kedua hingga negatif.
Tiga bagian	Bagian pertama berlaku untuk nilai positif, nilai kedua ke negatif, dan yang ketiga hingga nol.
Empat bagian	Bagian pertama berlaku untuk nilai positif, nilai kedua ke negatif, yang ketiga hingga nol, dan nilai keempat hingga null.

Contoh berikut memiliki dua bagian. Bagian pertama menentukan format untuk nilai positif dan nol, dan bagian kedua menentukan format untuk nilai negatif.

"$#,##0;($#,##0)"  

Jika Anda menyertakan titik koma tanpa apa pun di antaranya, bagian yang hilang akan dicetak menggunakan format nilai positif. Misalnya, format berikut menampilkan nilai positif dan negatif menggunakan format di bagian pertama dan menampilkan "Nol" jika nilainya nol:

"$#,##0;;\Z\e\r\o"  

Tabel berikut mengidentifikasi karakter yang bisa muncul dalam string format untuk format numerik.

Karakter	Deskripsi
Tidak ada	Menampilkan angka tanpa pemformatan apa pun.
0	Mewakili tempat penampung digit yang menampilkan digit atau nol (0). Jika angka memiliki digit di posisi di mana nol muncul dalam string format, nilai yang diformat menampilkan digit . Jika tidak, nilai yang diformat menampilkan nol dalam posisi tersebut. Jika angka memiliki digit yang lebih sedikit daripada nol (di salah satu sisi desimal) dalam string format, nilai yang diformat menampilkan nol di depan atau di akhir. Jika angka memiliki lebih banyak digit di sebelah kanan pemisah desimal daripada nol di sebelah kanan pemisah desimal dalam ekspresi format, nilai yang diformat membulatkan angka ke tempat desimal sebanyak nol. Jika angka memiliki lebih banyak digit di sebelah kiri pemisah desimal daripada nol di sebelah kiri pemisah desimal dalam ekspresi format, nilai yang diformat menampilkan digit tambahan tanpa modifikasi.
#	Mewakili tempat penampung digit yang menampilkan digit atau tidak sama sekali. Jika ekspresi memiliki digit di posisi di mana tanda angka (#) muncul dalam string format, nilai yang diformat akan menampilkan digit. Jika tidak, nilai yang diformat tidak menampilkan apa pun dalam posisi tersebut. Tempat penampung tanda angka (#) berfungsi seperti tempat penampung digit nol (0) kecuali bahwa nol di depan dan di belakang tidak ditampilkan jika angka memiliki digit yang sama atau lebih sedikit daripada ada # karakter di kedua sisi pemisah desimal dalam ekspresi format.
.	Mewakili tempat penampung desimal yang menentukan berapa banyak digit yang ditampilkan di sebelah kiri dan kanan pemisah desimal. Jika ekspresi format hanya berisi karakter tanda angka (#) di sebelah kiri titik (.), angka yang lebih kecil dari 1 dimulai dengan pemisah desimal. Untuk menampilkan nol di depan yang ditampilkan dengan angka pecahan, gunakan nol (0) sebagai tempat penampung digit pertama di sebelah kiri pemisah desimal. Karakter aktual yang digunakan sebagai tempat penampung desimal dalam output yang diformat tergantung pada format angka yang dikenali oleh sistem komputer. Catatan: Di beberapa lokal, koma digunakan sebagai pemisah desimal.
%	Mewakili tempat penampung persentase. Ekspresi dikalikan dengan 100. Karakter persen (%) disisipkan dalam posisi di mana persentase muncul dalam string format.
,	Mewakili seribu pemisah yang memisahkan ribuan dari ratusan dalam angka yang memiliki empat atau lebih tempat di sebelah kiri pemisah desimal. Penggunaan standar pemisah seribu ditentukan jika format berisi seribu pemisah yang diapit dalam tempat penampung digit (0 atau #). Dua pemisah ribu yang berdekatan, atau seribu pemisah segera di sebelah kiri pemisah desimal (apakah desimal ditentukan atau tidak), berarti "menskalakan angka dengan membandingkan angka dengan 1000, membulatkan sesuai kebutuhan." Misalnya, Anda dapat menggunakan string format "##0," untuk mewakili 100 juta sebagai 100. Angka yang lebih kecil dari 1 juta ditampilkan sebagai 0. Dua pemisah ribu yang berdekatan dalam posisi apa pun selain segera di sebelah kiri pemisah desimal diperlakukan sebagai menentukan penggunaan seribu pemisah. Karakter aktual yang digunakan sebagai pemisah ribuan dalam output yang diformat tergantung pada format angka yang dikenali oleh sistem komputer. Catatan: Di beberapa lokal, periode digunakan sebagai pemisah seribu.
:	Mewakili pemisah waktu yang memisahkan jam, menit, dan detik saat nilai waktu diformat. Catatan: Di beberapa lokal, karakter lain dapat digunakan sebagai pemisah waktu. Karakter aktual yang digunakan sebagai pemisah waktu dalam output yang diformat ditentukan oleh pengaturan sistem pada komputer.
/	Mewakili pemisah tanggal yang memisahkan hari, bulan, dan tahun saat nilai tanggal diformat. Karakter aktual yang digunakan sebagai pemisah tanggal dalam output yang diformat ditentukan oleh pengaturan sistem pada komputer. Catatan: Di beberapa lokal, karakter lain dapat digunakan sebagai pemisah tanggal.
E- E+ e- e+	Mewakili format ilmiah. Jika ekspresi format berisi setidaknya satu digit tempat penampung (0 atau #) di sebelah kanan E-, E+, e-, atau e+, nilai yang diformat ditampilkan dalam format ilmiah dan E atau e disisipkan antara angka dan eksponen angka. Jumlah tempat penampung digit di sebelah kanan menentukan jumlah digit dalam eksponen. Gunakan E- atau e- untuk menyertakan tanda minus di samping eksponen negatif. Gunakan E+ atau e+ untuk menyertakan tanda minus di samping eksponen negatif dan tanda plus di samping eksponen positif.
- + $ ( )	Menampilkan karakter harfiah. Untuk menampilkan karakter selain salah satu yang tercantum, letakkan garis miring terbalik (\) sebelum karakter atau sertakan karakter dalam tanda kutip ganda (" ").
\	Menampilkan karakter berikutnya dalam string format. Untuk menampilkan karakter yang memiliki arti khusus sebagai karakter harfiah, letakkan garis miring terbalik (\) di depan karakter. Garis miring terbelakang itu sendiri tidak ditampilkan. Menggunakan garis miring terbalik sama dengan mengapit karakter berikutnya dalam tanda kutip ganda. Untuk menampilkan garis miring terbelakang, gunakan dua garis miring terbelakang (\\). Contoh karakter yang tidak dapat ditampilkan sebagai karakter harfiah meliputi karakter berikut: Karakter pemformatan tanggal dan pemformatan waktu-a, c, d, h, m, n, p, q, s, t, w, y, /, dan : Karakter pemformatan numerik-#, 0, %, E, e, koma, dan titik Karakter pemformatan string-@, &, , <>, dan !
"ABC"	Menampilkan string di dalam tanda kutip ganda (" "). Untuk menyertakan string dalam format dari dalam kode, gunakan Chr(34) untuk mengapit teks. (Kode karakter untuk tanda kutip ganda adalah 34.)

Format Numerik Bernama

Tabel berikut mengidentifikasi nama format numerik yang telah ditentukan sebelumnya:

Nama format	Deskripsi
General Number	Menampilkan angka tanpa pemisah ribuan.
Currency	Menampilkan angka dengan pemisah seribu, jika sesuai. Menampilkan dua digit di sebelah kanan pemisah desimal. Output didasarkan pada pengaturan lokal sistem.
Fixed	Menampilkan setidaknya satu digit ke kiri dan dua digit di sebelah kanan pemisah desimal.
Standard	Menampilkan angka dengan pemisah ribuan, setidaknya satu digit ke kiri dan dua digit di sebelah kanan pemisah desimal.
Percent	Menampilkan angka yang dikalikan dengan 100 dengan tanda persen (%) ditambahkan ke kanan. Selalu menampilkan dua digit di sebelah kanan pemisah desimal.
Scientific	Menggunakan notasi ilmiah standar.
Yes/No	Menampilkan Tidak jika angka adalah 0; jika tidak, menampilkan Ya.
True/False	Menampilkan False jika angkanya adalah 0; jika tidak, menampilkan True.
On/Off	Menampilkan Nonaktif jika angkanya adalah 0; jika tidak, menampilkan Aktif.

Nilai Tanggal

Tabel berikut mengidentifikasi karakter yang bisa muncul dalam string format untuk format tanggal/waktu.

Karakter	Deskripsi
:	Mewakili pemisah waktu yang memisahkan jam, menit, dan detik saat nilai waktu diformat. Karakter aktual yang digunakan sebagai pemisah waktu dalam output yang diformat ditentukan oleh pengaturan sistem komputer. Catatan: Di beberapa lokal, karakter lain dapat digunakan sebagai pemisah waktu.
/	Mewakili pemisah tanggal yang memisahkan hari, bulan, dan tahun saat nilai tanggal diformat. Karakter aktual yang digunakan sebagai pemisah tanggal dalam output yang diformat ditentukan oleh pengaturan sistem komputer. Catatan: Di beberapa lokal, karakter lain dapat digunakan untuk mewakili pemisah tanggal
C	Menampilkan tanggal sebagai ddddd dan menampilkan waktu sebagai ttttt, dalam urutan tersebut. Hanya menampilkan informasi tanggal jika tidak ada bagian pecahan ke nomor seri tanggal. Hanya menampilkan informasi waktu jika tidak ada bagian bilangan bulat.
-d	Menampilkan hari sebagai angka tanpa nol di depannya (1-31).
dd	Menampilkan hari sebagai angka dengan nol di depannya (01-31).
Ddd	Menampilkan hari sebagai singkatan (Min-Sab).
dddd	Menampilkan hari sebagai nama lengkap (Minggu-Sabtu).
ddddd	Menampilkan tanggal sebagai tanggal lengkap (termasuk hari, bulan, dan tahun), yang diformat sesuai dengan pengaturan format tanggal pendek sistem Anda. Untuk Microsoft Windows, format tanggal pendek default adalah m/d/yy.
dddddd	Menampilkan nomor seri tanggal sebagai tanggal lengkap (termasuk hari, bulan, dan tahun), diformat sesuai dengan pengaturan tanggal panjang yang dikenali oleh sistem komputer. Untuk Windows, format tanggal panjang default adalah mmmm dd, yyyy.
W	Menampilkan hari dalam seminggu sebagai angka (1 untuk Minggu hingga 7 untuk Sabtu).
Ww	Menampilkan minggu dalam setahun sebagai angka (1-54).
m	Menampilkan bulan sebagai angka tanpa nol di depannya (1-12). Jika m segera mengikuti h atau hh, menit alih-alih bulan ditampilkan.
mm	Menampilkan bulan sebagai angka dengan nol di depannya (01-12). Jika m segera mengikuti h atau hh, menit alih-alih bulan ditampilkan.
mmm	Menampilkan bulan sebagai singkatan (Jan-Dec).
mmmm	Menampilkan bulan sebagai nama bulan penuh (Januari-Desember).
T	Menampilkan seperempat tahun sebagai angka (1-4).
y	Menampilkan hari dalam setahun sebagai angka (1-366).
yy	Menampilkan tahun sebagai angka dua digit (00-99).
yyyy	Menampilkan tahun sebagai angka empat digit (100-9999).
h	Menampilkan jam sebagai angka tanpa di depan nol (0-23).
hh	Menampilkan jam sebagai angka dengan nol di depannya (00-23).
n	Menampilkan menit sebagai angka tanpa di depan nol (0-59).
nn	Menampilkan menit sebagai angka dengan nol di depannya (00-59).
s	Menampilkan yang kedua sebagai angka tanpa nol di depannya (0-59).
ss	Menampilkan yang kedua sebagai angka dengan nol di depannya (00-59).
t t t t t t	Menampilkan waktu sebagai waktu lengkap (termasuk jam, menit, dan detik), diformat menggunakan pemisah waktu yang ditentukan oleh format waktu yang dikenali oleh sistem komputer. Nol di depan ditampilkan jika opsi nol di depan dipilih, dan waktu lebih awal dari pukul 10.00 dalam siklus A.M. atau P.M. . Misalnya, 09:59, Untuk Windows, format waktu default adalah h:mm:ss.
AM/PM	Menampilkan AM huruf besar dengan jam apa pun dari tengah malam hingga siang; menampilkan PM huruf besar dengan jam apa pun dari siang hingga tengah malam. Catatan: Menggunakan jam 12 jam.
am/pm	Menampilkan huruf kecil am dengan jam apa pun dari tengah malam hingga siang; menampilkan pm huruf kecil dengan jam dari siang hingga tengah malam. Catatan: Menggunakan jam 12 jam.
A/P	Menampilkan huruf besar A dengan jam apa pun dari tengah malam hingga siang; menampilkan P huruf besar dengan jam apa pun dari siang hingga tengah malam. Catatan: Menggunakan jam 12 jam.
a/p	Menampilkan huruf kecil dengan jam apa pun dari tengah malam hingga siang; menampilkan huruf kecil p dengan jam apa pun dari siang hingga tengah malam. Catatan: Menggunakan jam 12 jam.
AMPM	Menampilkan literal string AM seperti yang didefinisikan oleh sistem komputer dengan jam apa pun dari tengah malam hingga siang; menampilkan literal string PM seperti yang didefinisikan oleh sistem komputer dengan jam apa pun dari siang hingga tengah malam. AMPM dapat berupa huruf besar atau huruf kecil, tetapi kasus string yang ditampilkan cocok dengan string seperti yang didefinisikan oleh pengaturan sistem komputer. Untuk Windows, format defaultnya adalah AM/PM. Catatan: Menggunakan jam 12 jam.

Format Tanggal Bernama

Tabel berikut mengidentifikasi nama format tanggal dan waktu yang telah ditentukan sebelumnya:

Nama Format	Deskripsi
General Date	Menampilkan tanggal dan/atau waktu. Untuk angka riil, menampilkan tanggal dan waktu, misalnya, 4/3/93 17:34. Jika tidak ada bagian pecahan, hanya menampilkan tanggal, misalnya, 3/4/93. Jika tidak ada bagian bilangan bulat, hanya menampilkan waktu, misalnya, 17:34. Format tampilan tanggal ditentukan oleh pengaturan sistem Anda.
Long Date	Menampilkan tanggal sesuai dengan format tanggal panjang sistem Anda.
Medium Date	Menampilkan tanggal menggunakan format tanggal sedang yang sesuai untuk versi bahasa aplikasi host.
Short Date	Menampilkan tanggal menggunakan format tanggal pendek sistem Anda.
Long Time	Menampilkan waktu menggunakan format waktu panjang sistem Anda; termasuk jam, menit, dan detik.
Medium Time	Menampilkan waktu dalam format 12 jam menggunakan jam dan menit dan penunjuk AM/PM.
Short Time	Menampilkan waktu menggunakan format 24 jam, misalnya, 17:45.

Lihat juga

BAHASA dan FORMAT_STRING di FORMATTED_VALUE
Menggunakan Properti Sel (MDX)
Membuat dan Menggunakan Nilai Properti (MDX)
Dasar-Dasar Kueri MDX (Analysis Services)