Fungsi Format

Mengembalikan Varian (String) yang berisi ekspresi yang diformat menurut instruksi yang terdapat di ekspresi format.

Peringatan Ada masalah dengan penggunaan fungsi ini. Senin terakhir dalam beberapa tahun kalender dapat dikembalikan sebagai minggu ke-53 ketika seharusnya minggu 1. Untuk informasi selengkapnya dan solusi sementara, lihat Fungsi Format atau DatePart dapat mengembalikan nomor minggu yang salah untuk Senin terakhir dalam Tahun.

Lihat beberapa contoh

Sintaks

Format( *ekspresi [, format ] [, firstdayofweek ] [, firstweekofyear ] )

Sintaks fungsi Format memiliki argumen berikut:

Argumen	Deskripsi
ekspresi	Diperlukan. Ekspresi apa pun yang valid.
memformat	Opsional. Ekspresi format bernama atau ditentukan pengguna yang valid.
firstdayofweek	Opsional. Konstanta yang menentukan hari pertama dalam seminggu.
firstdayofyear	Opsional. Konstanta yang menentukan minggu pertama dalam setahun.

    

Pengaturan

Argumen format dapat menggunakan berbagai pengaturan, tergantung pada tipe data argumen ekspresi . Lihat artikel yang tercantum dalam tabel berikut ini untuk informasi selengkapnya tentang ekspresi format yang valid.

Untuk ekspresi yang menggunakan tipe data ini...	Lihat artikel
Tipe apa pun	Properti Format
Tanggal/waktu	Memformat bidang tanggal dan waktu
Numerik	Memformat bidang angka atau mata uang
Teks dan memo	Memformat bidang teks
Ya/Tidak	Properti Format - Tipe Data Ya/Tidak

    

Argumen firstdayofweek memiliki pengaturan berikut:

Konstanta	Value	Deskripsi
vbUseSystem	0	Gunakan pengaturan NLS API.
VbSunday	1	Minggu (default)
vbMonday	2	Senin
vbSelasa	3	Selasa
vbWednesday	4	Rabu
vbKamis	5	Kamis
vbFriday	6	Jumat
vbSaturday	7	Sabtu

    

Argumen firstweekofyear memiliki pengaturan berikut:

Konstanta	Value	Deskripsi
vbUseSystem	0	Gunakan pengaturan NLS API.
vbFirstJan1	1	Mulai dengan minggu di mana 1 Januari terjadi (default).
vbFirstFourDays	2	Mulailah dengan minggu pertama yang memiliki setidaknya empat hari dalam setahun.
vbFirstFullWeek	3	Mulailah dengan minggu penuh pertama tahun ini.

    

Keterangan

Untuk memformat	Lakukan ini
Angka	Gunakan format numerik bernama yang telah ditentukan sebelumnya atau buat format numerik yang ditentukan pengguna.
Tanggal dan waktu	Gunakan format tanggal/waktu bernama yang telah ditentukan sebelumnya atau buat format tanggal/waktu yang ditentukan pengguna.
Nomor seri tanggal dan waktu	Gunakan format tanggal dan waktu atau format numerik.
String	Buat format string yang ditentukan pengguna Anda sendiri.

    

Jika Anda mencoba memformat angka tanpa menentukan format, Format menyediakan fungsionalitas yang mirip dengan fungsi Str , meskipun dikenal secara internasional. Namun, angka positif yang diformat sebagai string menggunakan Format tidak menyertakan spasi di depan yang dicadangkan untuk tanda nilai; yang dikonversi menggunakan Str mempertahankan ruang terdepan.

Jika memformat string numerik yang tidak dilokalkan, Anda harus menggunakan format numerik yang ditentukan pengguna untuk memastikan bahwa Anda mendapatkan tampilan yang diinginkan.

Jika kalender adalah Gregorian, arti format simbol ekspresi tidak berubah. Jika kalender adalah Hijriah, semua simbol format tanggal (misalnya, dddd, mmmm, yyyy) memiliki arti yang sama tetapi berlaku untuk kalender Hijriah. Simbol format tetap dalam bahasa Inggris; Simbol yang menghasilkan tampilan teks (misalnya, AM dan PM) menampilkan string (Inggris atau Arab) yang terkait dengan simbol tersebut. Rentang simbol tertentu berubah ketika kalender adalah Hijriah.

Simbol	Rentang
d	1-30
dd	1-30
ww	1-51
mmm	Menampilkan nama bulan lengkap (nama bulan Hijriah tidak memiliki singkatan).
y	1-355
yyyy	100-9666

Contoh

Menggunakan fungsi Format dalam ekspresi Anda dapat menggunakan Format di mana pun Anda dapat menggunakan ekspresi. Misalnya, Anda dapat menggunakannya dalam kueri sebagai bagian dari alias bidang, atau dalam properti Sumber Kontrol kotak teks pada formulir atau laporan. Contoh berikut ini memperlihatkan ekspresi yang mungkin Anda gunakan dalam properti Filter laporan untuk membatasi output ke catatan dari minggu sebelumnya.

format([tanggal],"ww")=format(sekarang(),"ww")-1

Dalam contoh ini, sumber rekaman laporan memiliki bidang bernama Tanggal, yang berisi tanggal setiap rekaman tertentu diubah, dan yang digunakan dalam laporan. Saat Anda menjalankan laporan, hasilnya difilter untuk hanya menampilkan rekaman tersebut di mana minggu untuk nilai dalam bidang Tanggal (Format([Tanggal],"ww")) sama dengan minggu sebelumnya (Format(Now(),"ww")-1).

Gunakan fungsi Format dalam kode VBA 

Contoh ini memperlihatkan berbagai penggunaan fungsi Format untuk memformat nilai dengan menggunakan format bernama dan format yang ditentukan pengguna. Untuk pemisah tanggal (/), pemisah waktu (:), dan literal AM/ PM, output diformat aktual yang ditampilkan oleh sistem Anda bergantung pada pengaturan lokal komputer tempat kode berjalan. Saat waktu dan tanggal ditampilkan di lingkungan pengembangan, format waktu pendek dan format tanggal pendek dari lokal kode digunakan. Ketika ditampilkan dengan menjalankan kode, format waktu singkat dan format tanggal pendek lokal sistem digunakan, yang mungkin berbeda dari kode lokal. Untuk contoh ini, lokasi bahasa Inggris A.S. diasumsikan.

MyTime dan MyDate ditampilkan di lingkungan pengembangan menggunakan pengaturan waktu singkat sistem saat ini dan pengaturan tanggal pendek.

Dim MyTime, MyDate, MyStr
MyTime = #17:04:23#
MyDate = #January 27, 1993#
' Returns current system time in the system-defined long time format.
MyStr = Format(Time, "Long Time")
' Returns current system date in the system-defined long date format.
MyStr = Format(Date, "Long Date")
MyStr = Format(MyTime, "h:m:s")    ' Returns "17:4:23".
MyStr = Format(MyTime, "hh:mm:ss AMPM")    ' Returns "05:04:23 PM".
MyStr = Format(MyDate, "dddd, mmm d yyyy")    ' Returns "Wednesday,
    ' Jan 27 1993".
' If format is not supplied, a string is returned.
MyStr = Format(23)    ' Returns "23".
' User-defined formats.
MyStr = Format(5459.4, "##,##0.00")    ' Returns "5,459.40".
MyStr = Format(334.9, "###0.00")    ' Returns "334.90".
MyStr = Format(5, "0.00%")    ' Returns "500.00%".
MyStr = Format("HELLO", "<")    ' Returns "hello".
MyStr = Format("This is it", ">")    ' Returns "THIS IS IT".

      

Menggunakan Format dengan string kosong

Di Microsoft Access versi 2.0 dan yang lebih lama, Anda dapat menggunakan fungsi Format untuk mengembalikan satu nilai untuk string dengan panjang nol dan satu lagi untuk sebuah nilai. Misalnya, Anda dapat menggunakan ekspresi format seperti berikut dengan fungsi Format untuk mengembalikan nilai string yang sesuai dari kode:

Dim varX As Variant
Dim varStrX As Variant
' Assign some value to varStrX and pass to Format function.
varX = Format(varStrX, "@;ZLS;Null")

Di Microsoft Access versi 97 dan yang lebih baru, Anda harus menguji huruf kecil Null secara terpisah, lalu mengembalikan nilai yang sesuai berdasarkan hasilnya. Misalnya, Anda dapat menggunakan fungsi IIf dalam ekspresi dengan fungsi Format seperti berikut:

varX = IIf(IsNull(varStrX),"Null", Format(varStrX, "@;ZLS"))

Perubahan ini hanya berlaku ketika Anda menggunakan fungsi Format untuk memformat string, tergantung pada apakah string tersebut memiliki panjang nol atau nilai Null. Ekspresi format lain yang digunakan dengan fungsi Format terus berfungsi seperti di versi sebelumnya.

Jika mengonversi database dari Microsoft Access versi 2.0 dan yang lebih lama ke Microsoft Access 2002 atau yang lebih baru, Anda harus mengubah kode untuk menguji huruf kecil Null secara terpisah.

Fungsi string dan cara menggunakannya