Fungsi Format

Mengembalikan varian (string) yang berisi ekspresi diformat sesuai instruksi yang dimuat dalam ekspresi format.

Perhatian    Ada masalah dengan penggunaan fungsi ini. Hari Senin yang lalu dalam beberapa tahun kalender bisa dikembalikan sebagai minggu 53 saat harus seminggu 1. Untuk informasi lebih lanjut dan solusi, lihat format atau fungsi DatePart bisa mengembalikan nomor minggu yang salah untuk Senin terakhir dalam setahun.

Lihat beberapa contoh

Sintaks

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

Sintaks fungsi format memiliki argumen ini:

Argumen

Deskripsi

ekspresi

Diperlukan. Ekspresi yang valid.

format

Optional. Ekspresi format bernama yang valid atau yang ditentukan pengguna.

firstdayofweek

Optional. konstanta yang menentukan hari pertama dalam seminggu.

firstdayofyear

Optional. Konstanta yang menentukan minggu pertama dalam setahun.


Pengaturan

Argumen format bisa menggunakan berbagai pengaturan, tergantung pada tipe data dari 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 ini:

Konstanta

Nilai

Deskripsi

vbUseSystem

0

Gunakan pengaturan API NLS.

Vbminggu

1

Minggu (default)

vbMonday

2

Senin

vbTuesday

3

Selasa

Vbrabu

4

Rabu

Vbkamis

5

Kamis

vbFriday

6

Jumat

Vbsabtu

7

Sabtu


Argumen firstweekofyear memiliki pengaturan ini:

Konstanta

Nilai

Deskripsi

vbUseSystem

0

Gunakan pengaturan API NLS.

vbFirstJan1

1

Mulai dengan minggu di mana January 1 terjadi (default).

vbFirstFourDays

2

Mulai dengan minggu pertama yang setidaknya memiliki empat hari dalam setahun.

vbFirstFullWeek

3

Mulai dengan minggu penuh pertama dalam setahun.


Keterangan

Untuk memformat

Lakukan ini

Angka

Gunakan format numerik yang ditentukan sebelumnya atau buat format numerik yang ditentukan pengguna.

Tanggal dan waktu

Gunakan format tanggal/waktu yang ditentukan sebelumnya atau buat format tanggal/waktu yang ditentukan pengguna.

Nomor seri tanggal dan waktu

Gunakan format tanggal dan waktu atau format numerik.

Busur

Buat format string yang ditentukan pengguna Anda sendiri.


Jika Anda mencoba memformat angka tanpa menentukan format, format menyediakan fungsionalitas yang sama dengan fungsi Str , meskipun sangat internasional. Namun, bilangan positif yang diformat sebagai string menggunakan format tidak menyertakan ruang utama yang dicadangkan untuk tanda nilai; konversi menggunakan Str mempertahankan ruang utama.

Jika Anda memformat string numerik non-lokal, 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 Hijriah, ekspresi yang disertakan harus berupa Hijriah.

Jika kalender adalah Gregorian, artinya simbol ekspresi format tidak berubah. Jika kalender adalah Hijriah, simbol format tanggal (misalnya, DDDD, mmmm, yyyy) memiliki arti yang sama tetapi diterapkan ke 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

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 ([tanggal], "WW") = format (sekarang (), "WW")-1

Dalam contoh ini, sumber rekaman laporan memiliki bidang bernama tanggal, yang berisi tanggal setiap catatan tertentu dimodifikasi, dan yang digunakan pada laporan. Saat Anda menjalankan laporan, hasilnya difilter untuk hanya memperlihatkan catatan di mana minggu untuk nilai dalam bidang tanggal (format ([date], "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 format aktual yang ditampilkan oleh sistem Anda tergantung pada pengaturan lokal komputer tempat kode berjalan. Ketika waktu dan tanggal ditampilkan dalam lingkungan pengembangan, format waktu singkat dan format tanggal pendek dari lokal kode digunakan. Saat ditampilkan dengan menjalankan kode, format waktu singkat dan format tanggal pendek dari 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 bisa menggunakan fungsi format untuk mengembalikan satu nilai untuk string kosong dan nilai lainnya. Misalnya, Anda bisa 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 hasil. Misalnya, Anda dapat menggunakan fungsi IIF dalam ekspresi dengan fungsi format seperti berikut ini:

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

Perubahan ini hanya berlaku ketika Anda menggunakan fungsi format untuk memformat string yang bergantung pada apakah nilai string panjang nol atau nilai null. Ekspresi format lainnya yang digunakan dengan fungsi format tetap berfungsi seperti yang dilakukan 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 menguji secara terpisah untuk kasus null.

Lihat Juga

Fungsi string dan cara menggunakannya

Kembangkan keterampilan Office Anda
Jelajahi pelatihan
Dapatkan fitur baru terlebih dahulu
Gabung ke Office Insiders

Apakah informasi ini bermanfaat?

Terima kasih atas umpan balik Anda!

Terima kasih atas umpan balik Anda! Sepertinya menghubungkan Anda ke salah satu agen dukungan Office kami akan sangat membantu.

×