Mengembalikan Varian (String) yang berisi ekspresi yang diformat sesuai dengan instruksi yang terdapat dalam ekspresi format.
|
Peringatan Ada masalah dengan penggunaan fungsi ini. Senin terakhir dalam beberapa tahun kalender dapat dikembalikan sebagai minggu 53 ketika seharusnya minggu 1. Untuk informasi selengkapnya dan solusinya, lihat Memformat atau fungsi DatePart dapat mengembalikan nomor minggu yang salah untuk Senin tahun lalu. |
Sintaks
Format( ekspresi [, format ] [, firstdayofweek ] [, firstweekofyear ] )
Sintaks fungsi Format memiliki argumen ini:
|
Argumen |
Deskripsi |
|
ekspresi |
Diperlukan. Ekspresi apa pun yang valid. |
|
format |
Opsional. Ekspresi format bernama atau yang 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, bergantung 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 |
|
|
Tanggal/waktu |
|
|
Numerik |
|
|
Teks dan memo |
|
|
Ya/Tidak |
Argumen firstdayofweek memiliki pengaturan ini:
|
Konstanta |
Nilai |
Deskripsi |
|
vbUseSystem |
0 |
Gunakan pengaturan API NLS. |
|
VbSunday |
1 |
Minggu (default) |
|
vbMonday |
2 |
Senin |
|
vbTuesday |
3 |
Selasa |
|
vbWednesday |
4 |
Rabu |
|
vb Kamis |
5 |
Kamis |
|
vbFriday |
6 |
Jumat |
|
vbSaturday |
7 |
Sabtu |
Argumen firstweekofyear memiliki pengaturan ini:
|
Konstanta |
Nilai |
Deskripsi |
|
vbUseSystem |
0 |
Gunakan pengaturan API NLS. |
|
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 dalam setahun. |
Keterangan
|
Untuk Memformat |
Lakukan ini |
|
Angka |
Gunakan format numerik bernama yang sudah ditentukan sebelumnya atau buat format numerik yang ditentukan pengguna. |
|
Tanggal dan waktu |
Gunakan format tanggal/waktu bernama yang sudah 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 secara internasional menyadarinya. Namun, angka positif yang diformat sebagai string menggunakan Format tidak menyertakan spasi di depan yang dipesan untuk tanda nilai; yang dikonversi menggunakan Str mempertahankan ruang di depan.
Jika Anda memformat string numerik yang tidak dilokalkan, Anda harus menggunakan format numerik yang ditentukan pengguna untuk memastikan bahwa Anda mendapatkan tampilan yang Anda inginkan.
Catatan: Jika pengaturan properti Kalender adalah Gregorian dan format menentukan pemformatan tanggal, ekspresi yang disediakan harus gregorian. Jika pengaturan properti Kalender Visual Basic adalah Hijriyah, ekspresi yang disediakan harusLah Hijriyah.
Jika kalender adalah Gregorian, arti simbol format ekspresi tidak berubah. Jika kalender adalah Hijriyah, semua simbol format tanggal (misalnya, dddd, mmmm, yyyyy) memiliki arti yang sama tetapi berlaku untuk kalender Hijriyah. Simbol format tetap dalam bahasa Inggris; simbol yang menghasilkan tampilan teks (misalnya, AM dan PM) menampilkan string (Bahasa Inggris atau Arab) yang terkait dengan simbol tersebut. Rentang simbol tertentu berubah ketika kalender adalah Hijriyah.
|
Simbol |
Range |
|
d |
1-30 |
|
dd |
1-30 |
|
ww |
1-51 |
|
mmm |
Menampilkan nama bulan penuh (nama bulan Hijriah tidak memiliki singkatan). |
|
y |
1-355 |
|
yyyy |
100-9666 |
Contoh
Menggunakan fungsi Format dalam ekspresi Anda bisa menggunakan Format di mana pun Anda bisa menggunakan ekspresi. Misalnya, Anda bisa 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 rekaman dari minggu sebelumnya.
Format([Date],"ww")=Format(Now(),"ww")-1
Dalam contoh ini, sumber rekaman laporan memiliki bidang bernama Tanggal, yang berisi tanggal setiap rekaman tertentu diubah, dan yang digunakan pada laporan. Saat Anda menjalankan laporan, hasilnya difilter untuk memperlihatkan hanya rekaman di mana minggu untuk nilai dalam bidang Tanggal (Format([Tanggal],"ww")) sama dengan minggu sebelumnya (Format(Sekarang(),"ww")-1).
Menggunakan fungsi Format dalam kode VBA
Catatan: Contoh yang mengikuti demonstrasi penggunaan fungsi ini dalam modul Visual Basic for Applications (VBA). Untuk informasi selengkapnya tentang bekerja dengan VBA, pilih Referensi Pengembang di daftar turun bawah di samping Cari dan masukkan satu istilah atau lebih di kotak pencarian.
Contoh ini memperlihatkan berbagai penggunaan fungsi Format untuk memformat nilai menggunakan format bernama dan format yang ditentukan pengguna. Untuk pemisah tanggal (/), pemisah waktu (:), dan AM/ PM literal, output aktual yang diformat yang ditampilkan oleh sistem Anda bergantung pada pengaturan lokal komputer tempat kode dijalankan. Ketika waktu dan tanggal ditampilkan dalam lingkungan pengembangan, format waktu pendek dan format tanggal pendek lokal kode digunakan. Ketika ditampilkan dengan kode yang berjalan, format waktu pendek dan format tanggal pendek lokal sistem digunakan, yang mungkin berbeda dari lokal kode. Untuk contoh ini, lokal Bahasa Inggris A.S. diasumsikan.
MyTime dan MyDate ditampilkan dalam 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 panjang-nol
Di Microsoft Access versi 2.0 dan yang lebih lama, Anda dapat menggunakan fungsi Format untuk mengembalikan satu nilai untuk string kosong dan nilai lainnya. Misalnya, Anda dapat menggunakan ekspresi format seperti berikut ini 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 secara terpisah untuk huruf Null , 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 yang bergantung pada apakah itu string panjang-nol atau nilai Null. Ekspresi format lain yang digunakan dengan fungsi Format terus berfungsi seperti dalam versi sebelumnya.
Jika Anda 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 diuji secara terpisah untuk kasus Null.
