Fungsi FormatCurrency di MS Access

Di Access, fungsi FormatCurrency digunakan untuk memformat angka dengan nilai simbol mata uang seperti yang diatur dalam regional setting di Control Panel. Simbol mata uang itu misalnya $ untuk dollar, Rp untuk rupiah,€ untuk euro, dan seterusnya. Nilai yang dihasilkan dari fungsi FormatCurrency adalah string.

Argumen pada fungsi FormatCurrency

Sintaks penulisan fungsi FormatCurrency adalah sebagai berikut:

FormatCurrency ( Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )

Keterangan:

Argumen atau Variabel	Keterangan
Expression (ekspresi)	Wajib diisi, bisa berupa angka atau text yang berupa angka, misal: 1000,"1000",-1000, dan "-1000"
NumDigitsAfterDecimal (jumlah digit dibelakang koma)	Opsional, tidak wajib diisi. Berupa angka yang menunjukkan berapa digit harus ditampilkan di belakang koma. Nilai defaultnya adalah  –1, yang mengacu pada pengaturan regional di Control Panel.
IncludeLeadingDigit (menampilkan 0 pada pecahan)	Opsional, tidak wajib diisi. Terdiri dari tiga pilihan konstanta yang digunakan untuk menambahkan 0 di depan angka pecahan. Misalnya .9 menjadi 0.9.
UseParensForNegativeNumbers (menggunakan tanda kurung buka dan tutup sebagai pengganti tanda -)	Opsional, tidak wajib diisi. Terdiri dari tiga pilihan konstanta yang digunakan untuk menampilkan angka negatif dalam bentuk kurung terbuka dan tertutup ("( )") atau tanda negatif ("-").
GroupDigits (digit dikelompokkan)	Opsional, tidak wajib diisi. Terdiri dari tiga pilihan konstanta yang digunakan untuk memberi tanda bahwa angka dikelompokkan menggunakan pemisah kelompok yang diatur melalui regional di Control Panel. Misalya dalam ribuan (1000 menjadi 1.000), jutaan (1000000 menjadi 1.000.000) , dan seterusnya.

IncludeLeadingDigit, UseParensForNegativeNumbers, dan GroupDigits diatur sebagai berikut:

Konstanta	Nilai	Keterangan
vbTrue	–1	TRUE
vbFalse	0	FALSE
vbUseDefault	–2	Pengaturan sesuai dengan regional di Control Panel.

Argumen pada fungsi FormatCurrency untuk leading zero (IncludeLeadingDigit)

Bila salah satu argumen atau variabel tidak ada nilainya, maka nilai dari argumen itu mengambil nilai dari pengaturan yang sesuai dengan regional di Control Panel. Selain itu, penempatan simbol mata uang ditentukan secara relatif menggunakan pengaturan yang sesuai dengan regional di Control Panel.

Berikut ini beberapa contoh penggunaan fungsi FormatCurrency:

? FormatCurrency (1000)
$1,000.00

Format angka 1000 menggunakan pengaturan yang sesuai dengan regional di Control Panel

? FormatCurrency (1000,3)
$1,000.000

Format angka 1000 menggunakan 3 angka di belakang koma dan pengaturan lain yang sesuai dengan regional di Control Panel.

? FormatCurrency (.92,3)
$0.920

Format angka 0.92 menggunakan 3 angka di belakang koma dan pengaturan lain yang sesuai dengan regional di Control Panel.

? FormatCurrency (".92",,vbFalse)
$.92

Format angka 0.92 tanpa menambahkan 0 sebagai leading zero di angka pecahan, dan pengaturan lain yang sesuai dengan regional di Control Panel.

? FormatCurrency (-.92,3,vbFalse,vbFalse)
-$.920

Format angka 0.92 menggunakan 3 angka di belakang koma, tanpa menambahkan 0 sebagai leading zero di angka pecahan, menggunakan tanda "-" sebagai angka negatif, dan pengaturan lain yang sesuai dengan regional di Control Panel.

? FormatCurrency (-1000000,3,,vbFalse)
-$1,000,000.000

Format angka -1000000 menggunakan 3 angka di belakang koma, menggunakan tanda "-" sebagai angka negatif, dan pengaturan lain yang sesuai dengan regional di Control Panel.

? FormatCurrency (-1000000,3,,vbFalse,vbFalse)
-$1000000.000

Format angka -1000000 menggunakan 3 angka di belakang koma, menggunakan tanda "-" sebagai angka negatif, tidak ada pengelompokkan digit, dan pengaturan lain yang sesuai dengan regional di Control Panel.