Returns a NULL if two expressions are equivalent.

Syntax

---

NULLIF(<Expression>, <Expression>)

<Expression> =

Type of:

CHARACTER|CHAR
CHARACTER VARYING|VARCHAR
GUID
BYTE
BYTE VARYING|VARBYTE
BINARY LARGE OBJECT|BLOB
CHARACTER LARGE OBJECT|CLOB
BOOLEAN|BOOL
SMALLINT
INTEGER|INT
BIGINT
FLOAT
DECIMAL|NUMERIC
DATE
TIME
TIMESTAMP
INTERVAL YEAR
INTERVAL YEAR TO MONTH
INTERVAL MONTH
INTERVAL DAY
INTERVAL DAY TO HOUR
INTERVAL DAY TO MINUTE
INTERVAL DAY TO SECOND
INTERVAL DAY TO MSECOND
INTERVAL HOUR
INTERVAL HOUR TO MINUTE
INTERVAL HOUR TO SECOND
INTERVAL HOUR TO MSECOND
INTERVAL MINUTE
INTERVAL MINUTE TO SECOND
INTERVAL MINUTE TO MSECOND
INTERVAL SECOND
INTERVAL SECOND TO MSECOND
INTERVAL MSECOND

Returns

---

NULL if both expressions are equal, otherwise same as input

Usage

---

The NULLIF function returns a NULL if two expressions are equal. Both expressions must be type-compatible. Use the CAST function to ensure that both expressions are type-compatible.

Examples

---

SELECT TransDateTime,
NULLIF(Amount, -1) AS Amount
FROM Transactions

SQL 2003 Standard Deviations

---

This function deviates from the SQL 2003 standard in the following ways: