Fungsi Nz

Anda dapat menggunakan fungsi Nz untuk mengembalikan nol, string panjang-nol (" "), atau nilai lain yang ditentukan saat Varian adalah Null. Misalnya, Anda bisa menggunakan fungsi ini untuk mengonversi nilai Null ke nilai lain dan mencegahnya terpropagasi melalui ekspresi.

Sintaks

Nz(varian [, valueifnull ] )

Sintaks fungsi Nz memiliki argumen ini:

Argumen	Deskripsi
varian	Diperlukan. Variabel Varian tipe data.
valueifnull	Opsional (kecuali digunakan dalam kueri). Varian yang memasok nilai yang akan dikembalikan jika argumen varian adalah Null. Argumen ini memungkinkan Anda menampilkan nilai selain nol atau string panjang-nol. Catatan: Jika Anda menggunakan fungsi Nz dalam ekspresi dalam kueri tanpa menggunakan argumen valueifnull , hasilnya akan berupa string panjang-nol dalam bidang yang berisi nilai null.

Jika nilai argumen varian adalah Null, fungsi Nz mengembalikan angka nol atau string panjang-nol (selalu mengembalikan string panjang-nol saat digunakan dalam ekspresi kueri), bergantung pada apakah konteks menunjukkan nilai harus berupa angka atau string. Jika argumen valueifnull opsional disertakan, maka fungsi Nz akan mengembalikan nilai yang ditentukan oleh argumen tersebut jika argumen varian adalah Null. Ketika digunakan dalam ekspresi kueri, fungsi NZ harus selalu menyertakan argumen valueifnull ,

Jika nilai varian bukan Null, maka fungsi Nz mengembalikan nilai varian.

Keterangan

Fungsi Nz berguna untuk ekspresi yang mungkin menyertakan nilai Null. Untuk memaksa ekspresi mengevaluasi ke suatu nilai non-Null meski nilai itu mengandung nilai Null, gunakan fungsi Nz untuk mengembalikan strng yang panjangnya nol, atau nilai yang dikembalikan kustom.

Misalnya, ekspresi 2 + varX akan selalu mengembalikan nilai Null saat VarianvarX adalah Null. Namun, 2 + Nz(varX) mengembalikan 2.

Anda bisa sering menggunakan fungsi Nz sebagai alternatif fungsi IIf. Misalnya, dalam kode berikut, dua ekspresi menyertakan fungsi IIf yang diperlukan untuk mengembalikan hasil yang diharapkan. Ekspresi pertama yang menyertakan fungsi IIf digunakan untuk memeriksa nilai suatu variabel dan mengonversinya menjadi nol jika nilai itu adalah Null.

varTemp = IIf(IsNull(varFreight), 0, varFreight)
varResult = IIf(varTemp > 50, "High", "Low")

Dalam contoh berikutnya, fungsi Nz menyediakan fungsionalitas yang sama seperti ekspresi pertama, dan hasil yang diinginkan dicapai dalam satu langkah, bukan dua.

varResult = IIf(Nz(varFreight) > 50, "High", "Low")

Jika Anda memasukkan nilai untuk argumen opsional valueifnull, nilai tersebut akan dikembalikan bila varian adalah Null. Dengan menyertakan argumen opsional ini, Anda mungkin dapat menghindari menggunakan ekspresi yang mengandung fungsi IIf fungsi IIf. Misalnya, ekspresi berikut ini menggunakan fungsi IIf untuk mengembalikan string jika nilainya varFreight adalah Null.

varResult = IIf(IsNull(varFreight), _
    "No Freight Charge", varFreight)

Dalam contoh berikutnya, argumen opsional yang disertakan ke fungsi Nz menyediakan string yang akan dikembalikan jika varFreightNull.

varResult = Nz(varFreight, "No Freight Charge")

Contoh kueri

Ekspresi	Hasil
SELECT ProductID, NZ(Discount,"No Detail Available") AS Expr2 FROM ProductSales;	Mengembalikan "PRODUCTID" dalam kolom Expr1, mengevaluasi nilai 'Null' dalam bidang "Diskon" dan mengembalikan "Tidak Ada Detail Tersedia" untuk semua nilai Null (mengembalikan nilai non-null sebagaimana adanya).
SELECT ProductID, NZ(Discount,"No Detail Available") AS ReplaceNull FROM ProductSales;	Mengembalikan "PRODUCTID" dalam kolom Produk, mengevaluasi nilai 'Null' dalam bidang "Diskon" dan mengembalikan "Tidak Ada Detail Tersedia" untuk semua nilai Null (mengembalikan nilai non-null sebagaimana adanya) dan ditampilkan dalam kolom ReplaceNull.

Contoh VBA

Contoh berikut mengevaluasi sebuah kontrol pada formulir dan mengembalikan salah satu dari dua string berdasarkan nilai kontrol tersebut. Jika nilai dari kontrolnya adalah Null, prosedur menggunakan fungsi Nz untuk mengonversi nilai Null menjadi string yang panjangnya nol.

Public Sub CheckValue()
    Dim frm As Form
    Dim ctl As Control
    Dim varResult As Variant
    ' Return Form object variable 
    ' pointing to Orders form.
    Set frm = Forms!Orders
    ' Return Control object variable 
    ' pointing to ShipRegion.
    Set ctl = frm!ShipRegion
    ' Choose result based on value of control.
    varResult = IIf(Nz(ctl.Value) = vbNullString, _
        "No value.", "Value is " & ctl.Value & ".")
    ' Display result.
    MsgBox varResult, vbExclamation
End Sub