FORMAT
Berlaku untuk: 
Kolom terhitung Tabel terhitung Ukur perhitungan Visual
Mengonversi nilai menjadi teks sesuai dengan format yang ditentukan.
Sintaks
FORMAT(<value>, <format_string>[, <locale_name>])
Parameter
| Term | Definisi |
|---|---|
| value | Nilai atau ekspresi yang mengevaluasi ke satu nilai. |
| format_string | String dengan templat pemformatan. |
| locale_name | (Opsional) Nama lokal yang akan digunakan oleh fungsi . Nilai yang mungkin adalah string yang diterima oleh fungsi Api Windows LocaleNameToLCID(). |
Nilai hasil
String yang berisi nilai yang diformat seperti yang didefinisikan oleh format_string.
Catatan
Jika nilai kosong, fungsi mengembalikan string kosong.
Jika format_string ADALAH BLANK, nilai diformat dengan format "Angka Umum" atau "Tanggal Umum" (sesuai dengan jenis data nilai ).
Keterangan
String format yang telah ditentukan sebelumnya menggunakan properti budaya model saat memformat hasilnya. Secara default, properti budaya model diatur sesuai dengan lokal pengguna komputer. Untuk model Power BI Desktop baru, properti budaya model dapat diubah dalam opsi > bahasa Model Pengaturan > Regional. Untuk Analysis Services, budaya model diatur sesuai dengan properti Bahasa yang awalnya ditentukan oleh instans.
String format yang didukung sebagai argumen ke fungsi FORMAT DAX didasarkan pada string format yang digunakan oleh Visual Basic (OLE Automation), bukan pada string format yang digunakan oleh .NET Framework. Oleh karena itu, Anda mungkin mendapatkan hasil yang tidak terduga atau kesalahan jika argumen tidak cocok dengan string format yang ditentukan. Misalnya, "p" sebagai singkatan untuk "Persen" tidak didukung. String yang Anda berikan sebagai argumen ke fungsi FORMAT yang tidak disertakan dalam daftar string format yang telah ditentukan ditangani sebagai bagian dari string format kustom, atau sebagai string harfiah.
Untuk mempelajari lebih lanjut menentukan lokal dengan FORMAT, lihat video ini.
Menggunakan FORMAT mengubah hasil pengukuran ke tipe data teks. Jika hasil pengukuran awalnya dari jenis data numerik, maka dengan FORMAT, ukuran tidak dapat digunakan pada visual di mana bagian nilai memerlukan jenis data numerik, seperti dengan bagan. Di Power BI, Anda dapat menggunakan string format Dinamis untuk pengukuran menentukan string format bersyarah yang mempertahankan jenis data numerik pengukuran.
Fungsi ini tidak didukung untuk digunakan dalam mode DirectQuery saat digunakan dalam kolom terhitung atau aturan keamanan tingkat baris (RLS).
Contoh
String format
= FORMAT( 12345.67, "General Number")
= FORMAT( 12345.67, "Currency")
= FORMAT( 12345.67, "Fixed")
= FORMAT( 12345.67, "Standard")
= FORMAT( 12345.67, "Percent")
= FORMAT( 12345.67, "Scientific")
Menampilkan:
12345.67 "Angka Umum" menampilkan angka tanpa pemformatan.
$12,345.67 "Currency" menampilkan angka dengan pemformatan lokal mata uang Anda. Sampel di sini menunjukkan pemformatan mata uang Amerika Serikat default.
12345.67 "Tetap" menampilkan setidaknya satu digit di sebelah kiri pemisah desimal dan dua digit di sebelah kanan pemisah desimal.
12.345,67 "Standar" menampilkan setidaknya satu digit di sebelah kiri pemisah desimal dan dua digit di sebelah kanan pemisah desimal, dan menyertakan ribuan pemisah. Sampel di sini memperlihatkan pemformatan angka Amerika Serikat default.
1,234,567.00 % "Percent" menampilkan angka sebagai persentase (dikalikan dengan 100) dengan pemformatan dan tanda persen di sebelah kanan angka yang dipisahkan oleh spasi tunggal.
1.23E+04 "Ilmiah" menampilkan angka dalam notasi ilmiah dengan dua digit desimal.
Tanggalwaktu dengan locale_name opsional
= FORMAT( dt"2020-12-15T12:30:59", BLANK(), "en-US" )
= FORMAT( dt"2020-12-15T12:30:59", BLANK(), "en-GB" )
= FORMAT( dt"2020-12-15T12:30:59", "mm/dd/yyyy", "en-GB" )
Menampilkan:
15/12/2020 12:30:59 PM Di mana bulan mendahului hari dan waktu adalah format 12 jam.
15/12/2020 12:30:59 Di mana hari mendahului bulan dan waktu adalah format 24 jam.
15/12/2020 12:30:59 Di mana bulan mendahului hari dan waktu adalah format 24 jam. Karena string format dependen non-lokal ditentukan, lokal tidak diterapkan dan format non-lokal dikembalikan.
Format numerik yang telah ditentukan sebelumnya
Format numerik yang telah ditentukan sebelumnya berikut dapat ditentukan dalam argumen format_string :
| Format | Deskripsi |
|---|---|
"General Number" |
Menampilkan angka tanpa pemisah ribuan. |
"Currency" |
Menampilkan angka dengan seribu pemisah, jika sesuai; menampilkan dua digit di sebelah kanan pemisah desimal. Output didasarkan pada pengaturan lokal sistem. |
"Fixed" |
Menampilkan setidaknya satu digit di sebelah kiri dan dua digit di sebelah kanan pemisah desimal. |
"Standard" |
Menampilkan angka dengan seribu pemisah, setidaknya satu digit ke kiri dan dua digit di sebelah kanan pemisah desimal. |
"Percent" |
Menampilkan angka yang dikalikan dengan 100 dengan tanda persen (%) ditambahkan segera ke kanan; selalu menampilkan dua digit di sebelah kanan pemisah desimal. |
"Scientific" |
Menggunakan notasi ilmiah standar, menyediakan dua digit signifikan. |
"Yes/No" |
Menampilkan Tidak jika angka adalah 0; jika tidak, menampilkan Ya. |
"True/False" |
Menampilkan False jika angka adalah 0; jika tidak, menampilkan True. |
"On/Off" |
Menampilkan Nonaktif jika angka adalah 0; jika tidak, menampilkan Aktif. |
Format numerik kustom
Ekspresi format kustom untuk angka dapat memiliki satu hingga tiga bagian yang dipisahkan oleh titik koma. Jika argumen string format berisi salah satu format numerik bernama, hanya satu bagian yang diizinkan.
| Jika Anda menggunakan | Hasilnya adalah |
|---|---|
| Hanya satu bagian | Ekspresi format berlaku untuk semua nilai. |
| Dua bagian | Bagian pertama berlaku untuk nilai positif dan nol, nilai kedua ke negatif. |
| Tiga bagian | Bagian pertama berlaku untuk nilai positif, nilai kedua ke negatif, dan yang ketiga hingga nol. |
"$#,##0;($#,##0)"
Jika Anda menyertakan titik koma tanpa apa pun di antaranya, bagian yang hilang ditentukan menggunakan format nilai positif. Misalnya, format berikut menampilkan nilai positif dan negatif menggunakan format di bagian pertama dan menampilkan "Nol" jika nilainya nol.
"$#,##0"
Jika Anda menyertakan titik koma tanpa apa pun di antaranya, bagian yang hilang ditampilkan menggunakan format nilai positif.
Karakter format numerik kustom
Karakter format numerik kustom berikut dapat ditentukan dalam argumen format_string :
| karakter | Deskripsi |
|---|---|
| Tidak | Tampilkan angka tanpa pemformatan. |
| (0) | Tempat penampung digit. Menampilkan digit atau nol. Jika ekspresi memiliki digit di posisi tempat 0 muncul dalam string format, tampilkan; jika tidak, tampilkan nol di posisi tersebut. Jika angka memiliki lebih sedikit digit daripada nol (di kedua sisi desimal) dalam ekspresi format, tampilkan nol di depan atau berikutnya. Jika angka memiliki lebih banyak digit di sebelah kanan pemisah desimal daripada nol di sebelah kanan pemisah desimal dalam ekspresi format, bulatkan 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, tampilkan digit tambahan tanpa modifikasi. |
| Aku akan menemuinya.# | Tempat penampung digit. Menampilkan digit atau tidak sama sekali. Jika ekspresi memiliki digit di posisi di mana # muncul dalam string format, tampilkan; jika tidak, tidak menampilkan apa pun dalam posisi tersebut. Simbol ini berfungsi seperti tempat penampung 0 digit, kecuali bahwa nol di depan dan di belakang tidak ditampilkan jika angka memiliki digit yang sama atau lebih sedikit daripada karakter # di kedua sisi pemisah desimal dalam ekspresi format. |
| (.) | Tempat penampung desimal. Di beberapa lokal, koma digunakan sebagai pemisah desimal. Tempat penampung desimal menentukan berapa banyak digit yang ditampilkan di sebelah kiri dan kanan pemisah desimal. Jika ekspresi format hanya berisi tanda angka di sebelah kiri simbol ini, angka yang lebih kecil dari 1 dimulai dengan pemisah desimal. Untuk menampilkan nol di depan yang ditampilkan dengan angka pecahan, gunakan 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 Anda. |
| (%) | Tempat penampung persentase. Ekspresi dikalikan dengan 100. Karakter persen (%) disisipkan dalam posisi di mana karakter tersebut muncul dalam string format. |
| (,) | Pemisah ribuan. Di beberapa lokal, periode digunakan sebagai pemisah ribuan. Pemisah ribuan 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 dikelilingi oleh tempat penampung digit (0 atau #). Pemisah dua ribuan yang berdekatan atau pemisah ribuan langsung di sebelah kiri pemisah desimal (apakah desimal ditentukan atau tidak) berarti "skalakan angka dengan membandingkannya 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. Pemisah dua ribuan yang berdekatan dalam posisi apa pun selain segera di sebelah kiri pemisah desimal diperlakukan hanya sebagai menentukan penggunaan pemisah ribuan. Karakter aktual yang digunakan sebagai pemisah ribuan dalam output yang diformat tergantung pada Format Angka yang dikenali oleh sistem Anda. |
| (:) | Pemisah waktu. Di beberapa lokal, karakter lain dapat digunakan untuk mewakili pemisah waktu. Pemisah waktu memisahkan jam, menit, dan detik saat nilai waktu diformat. Karakter aktual yang digunakan sebagai pemisah waktu dalam output yang diformat ditentukan oleh pengaturan sistem Anda. |
| Aku akan menemuinya./ | Pemisah tanggal. Di beberapa lokal, karakter lain dapat digunakan untuk mewakili pemisah tanggal. Pemisah tanggal memisahkan hari, bulan, dan tahun saat nilai tanggal diformat. Karakter aktual yang digunakan sebagai pemisah tanggal dalam output yang diformat ditentukan oleh pengaturan sistem Anda. |
| (E- E+ e- e+) | Format ilmiah. Jika ekspresi format berisi setidaknya satu tempat penampung digit (0 atau #) di sebelah kanan E-, E+, e-, atau e+, angka ditampilkan dalam format ilmiah dan E atau e disisipkan antara angka dan eksponennya. Jumlah tempat penampung digit di sebelah kanan menentukan jumlah digit dalam eksponen. Gunakan E- atau e- untuk menempatkan tanda minus di samping eksponen negatif. Gunakan E+ atau e+ untuk menempatkan tanda minus di samping eksponen negatif dan tanda plus di samping eksponen positif. |
| - + $ ( ) | Menampilkan karakter harfiah. Untuk menampilkan karakter selain salah satu karakter yang tercantum, awali dengan garis miring terbalik (\) atau sertakan dalam tanda kutip ganda (" "). |
| Aku akan menemuinya.\ | Menampilkan karakter berikutnya dalam string format. Untuk menampilkan karakter yang memiliki arti khusus sebagai karakter harfiah, awali dengan garis miring terbalik (\). 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 adalah 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), dan karakter pemformatan string (@, &, <, >, dan !). |
| ("ABC") | Tampilkan string di dalam tanda kutip ganda (" "). |
Format tanggal/waktu yang telah ditentukan sebelumnya
Format tanggal/waktu yang telah ditentukan sebelumnya berikut dapat ditentukan dalam argumen format_string . Saat menggunakan format selain format ini, format tersebut ditafsirkan sebagai format tanggal/waktu kustom:
| Format | Deskripsi |
|---|---|
"General Date" |
Menampilkan tanggal dan/atau waktu. Misalnya, 12/3/2008 11:07:31 AM. Tampilan tanggal ditentukan oleh nilai budaya aplikasi Anda saat ini. |
"Long Date" atau "Medium Date" |
Menampilkan tanggal sesuai dengan format tanggal panjang budaya Anda saat ini. Misalnya, Rabu, 12 Maret 2008. |
"Short Date" |
Menampilkan tanggal menggunakan format tanggal pendek budaya Anda saat ini. Misalnya, 12/3/2008. |
"Long Time" atau |
Menampilkan waktu menggunakan format waktu panjang budaya Anda saat ini; biasanya mencakup jam, menit, detik. Misalnya, 11:07:31 AM. |
"Medium Time" |
Menampilkan waktu dalam format 12 jam. Misalnya, pukul 11.07. |
"Short Time" |
Menampilkan waktu dalam format 24 jam. Misalnya, 11:07. |
Format tanggal/waktu kustom
Karakter format berikut dapat ditentukan dalam format_string untuk membuat format tanggal/waktu kustom:
| karakter | Deskripsi |
|---|---|
| (:) | Pemisah waktu. Di beberapa lokal, karakter lain dapat digunakan untuk mewakili pemisah waktu. Pemisah waktu memisahkan jam, menit, dan detik saat nilai waktu diformat. Karakter aktual yang digunakan sebagai pemisah waktu dalam output yang diformat ditentukan oleh pengaturan sistem Anda. |
| Aku akan menemuinya./ | Pemisah tanggal. Di beberapa lokal, karakter lain dapat digunakan untuk mewakili pemisah tanggal. Pemisah tanggal memisahkan hari, bulan, dan tahun saat nilai tanggal diformat. Karakter aktual yang digunakan sebagai pemisah tanggal dalam output yang diformat ditentukan oleh pengaturan sistem Anda. |
| Aku akan menemuinya.\ | Backslash. Menampilkan karakter berikutnya sebagai karakter harfiah. Jadi, ini tidak ditafsirkan sebagai karakter pemformatan. |
| (") | Kutipan ganda. Teks yang diapit dalam tanda kutip ganda ditampilkan. Jadi, ini tidak ditafsirkan sebagai karakter pemformatan. |
| c | Tampilkan tanggal sebagai ddddd dan tampilkan waktu sebagai ttttt, dalam urutan tersebut. Tampilkan hanya informasi tanggal jika tidak ada bagian pecahan ke nomor seri tanggal; tampilkan hanya informasi waktu jika tidak ada bagian bilangan bulat. |
| d | Tampilkan hari sebagai angka tanpa nol di depannya (1-31). |
| dd | Tampilkan hari sebagai angka dengan nol di depannya (01-31). |
| ddd | Tampilkan hari sebagai singkatan (Sun-Sat). Lokal. |
| dddd | Tampilkan hari sebagai nama lengkap (Minggu-Sabtu). Lokal. |
| ddddd | Tampilkan tanggal sebagai tanggal lengkap (termasuk hari, bulan, dan tahun), diformat sesuai dengan pengaturan format tanggal pendek sistem Anda. Format tanggal pendek default adalah mm/dd/yyyy. |
| dddddd | Tampilkan nomor seri tanggal sebagai tanggal lengkap (termasuk hari, bulan, dan tahun) yang diformat sesuai dengan pengaturan tanggal panjang yang dikenali oleh sistem Anda. Format tanggal panjang default adalah dddd, mmmm d, yyyy. |
| w | Tampilkan hari dalam seminggu sebagai angka (1 untuk Minggu hingga 7 untuk Sabtu). |
| ww | Tampilkan minggu dalam setahun sebagai angka (1-54). |
| m | Tampilkan bulan sebagai angka tanpa nol di depannya (1-12). Jika m segera mengikuti h atau hh, menit alih-alih bulan ditampilkan. |
| mm | Tampilkan bulan sebagai angka dengan nol di depannya (01-12). Jika mm segera mengikuti h atau hh, menit alih-alih bulan ditampilkan. |
| mmm | Tampilkan bulan sebagai singkatan (Jan-Dec). Lokal. |
| mmmm | Tampilkan bulan sebagai nama bulan penuh (Januari-Desember). Lokal. |
| q | Tampilkan seperempat tahun sebagai angka (1-4). |
| y | Tampilkan hari dalam setahun sebagai angka (1-366). |
| yy | Tampilkan tahun sebagai angka 2 digit (00-99). |
| yyyy | Tampilkan tahun sebagai angka 4 digit (100-9999). |
| h | Tampilkan jam sebagai angka tanpa nol di depannya (0-23). |
| hh | Tampilkan jam sebagai angka dengan nol di depannya (00-23). |
| n | Tampilkan menit sebagai angka tanpa nol di depannya (0-59). |
| nn | Tampilkan menit sebagai angka dengan nol di depannya (00-59). |
| s | Tampilkan yang kedua sebagai angka tanpa nol di depan (0-59). |
| ss | Tampilkan yang kedua sebagai angka dengan nol di depan (00-59). |
| ttttt | Tampilkan waktu sebagai waktu lengkap (termasuk jam, menit, dan detik), diformat menggunakan pemisah waktu yang ditentukan oleh format waktu yang dikenali oleh sistem Anda. Nol di depan ditampilkan jika opsi nol di depan dipilih dan waktunya sebelum pukul 10:00 A.M. atau P.M. Format waktu default adalah h:mm:ss. |
| AM/PM | Gunakan jam 12 jam dan tampilkan AM huruf besar dengan jam apa pun sebelum siang; tampilkan PM huruf besar dengan jam antara siang dan 11.59 P.M. |
| am/pm | Gunakan jam 12 jam dan tampilkan AM huruf kecil dengan jam sebelum siang; menampilkan PM huruf kecil dengan jam antara siang dan 11:59 P.M. |
| A/P | Gunakan jam 12 jam dan tampilkan huruf besar A dengan jam sebelum siang; menampilkan P huruf besar dengan jam antara siang dan 11:59 P.M. |
| a/p | Gunakan jam 12 jam dan tampilkan huruf kecil A dengan jam sebelum siang; menampilkan P huruf kecil dengan jam antara siang dan 11:59 P.M. |
| AMPM | Gunakan jam 12 jam dan tampilkan string AM literal seperti yang didefinisikan oleh sistem Anda dengan jam sebelum siang; tampilkan literal string PM seperti yang didefinisikan oleh sistem Anda dengan jam apa pun antara siang dan 11:59 P.M. AMPM dapat berupa huruf besar atau huruf kecil, tetapi huruf besar string yang ditampilkan cocok dengan string seperti yang ditentukan oleh pengaturan sistem Anda. Format defaultnya adalah AM/PM. Jika sistem Anda diatur ke jam 24 jam, string biasanya diatur ke string kosong. |
Pemformatan tanggal/waktu menggunakan lokal pengguna saat ini untuk memformat string. Misalnya, pertimbangkan tanggal 25 Juni 2020. Ketika diformat menggunakan string format "m/d/yyyy" itu akan menjadi:
- Lokal pengguna Amerika Serikat Amerika (id-ID): "25/6/2020"
- Lokal pengguna adalah Jerman (de-DE): "6.25.2020"
Contoh format tanggal/waktu kustom
Contoh berikut menggunakan tanggal/waktu Kamis, 25 Juni 2020, pukul 13.23.45 WIB. Jerman (de-DE) menggunakan sistem 24 jam. Tidak ada yang setara dengan AM/PM.
| Format | Hasil (en-US) | Hasil (de-DE) |
|---|---|---|
"c" |
06/25/2020 13:23:45 | 25.06.2020 13:23:45 |
"d" |
25 | 25 |
"dd" |
25 | 25 |
"ddd" |
Kam | Lakukan |
"dddd" |
Kamis | Donnerstag |
"ddddd" |
06/25/2020 | 25.06.2020 |
"dddddd" |
Kamis, 25 Juni 2020 | Donnerstag, 25. Juni 2020 |
"w" |
5 | 5 |
"ww" |
26 | 26 |
"m" |
6 | 6 |
"mm" |
06 | 06 |
"mmm" |
Jun | Jun |
"mmmm" |
Juni | Juni |
"q" |
2 | 2 |
"y" |
177 | 177 |
"yy" |
20 | 20 |
"yyyy" |
2020 | 2020 |
"""Year"" yyyy" |
Tahun 2020 | Tahun 2020 |
"yyyy \Qq" |
Q2 2020 | Q2 2020 |
"dd/mm/yyyy" |
25/06/2020 | 25.06.2020 |
"mm/dd/yyyy" |
06/25/2020 | 06.25.2020 |
"h:nn:ss" |
13:23:45 | 13:23:45 |
"h:nn:ss AMPM" |
13:23:45 PM | 1:23:45 |
"hh:nn:ss" |
13:23:45 | 13:23:45 |
"hh:nn:ss AMPM" |
01:23:45 PM | 01:23:45 |
"ttttt" |
13:23:45 | 13:23:45 |
"ttttt AMPM" |
13:23:45 PM | 13:23:45 |
"mm/dd/yyyy hh:nn:ss AMPM" |
25/06/2020 01:23:45 PM | 6.25.2020 01:23:45 |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk