Documentation/Calc Functions/ERROR.TYPE

From The Document Foundation Wiki
Jump to: navigation, search


Im-jabber.svg

Under construction.
For now, see the system Help files.


Function name:

ERROR.TYPE

Category:

Spreadsheet

Summary:

Returns a number representing a specific Error type, or the error value #N/A, if there is no error.

Syntax:

ERROR.TYPE(Error_value)

Returns:

Arguments:

Error_value – required argument. The error value or a reference to a cell, whose value needs to be processed.

Error value Returns
Err:511 1
#DIV/0! 2
#VALUE! 3
#REF! 4
#NAME? 5
#NUM! 6
#N/A 7
#N/A #N/A

Additional details:

Examples:

Simple usage

=ERROR.TYPE(#N/A)

Returns 7, because 7 is the index number of the error value #N/A.

=ERROR.TYPE(A3)

If A3 contains an expression equivalent to the division by zero, the function returns 2, because 2 is the index number of the error value #DIV/0!

More advanced way

If in division A1 by A2, A2 can turn to zero, you can handle the situation as follows:

=IF(ISERROR(A1/A2);IF(ERROR.TYPE(A1/A2)=2;"the denominator can't be equal to zero");A1/A2)

The ISERROR function returns TRUE or FALSE depending on whether there is an error or not. If the error takes place, the function IF addresses to the second argument, if there is no error, it returns the result of the division. The second argument checks the index number representing the specific Error type, and if it is equal to 2, it returns the specified text "the denominator can't be zero" or 0 otherwise. Thus, clear text would signify the division by zero, the result of the division would appear when the division is successful, or if there is, for example, an error of another type, zero would be returned.

If the ERROR.TYPE function is used as condition of the IF function and the ERROR.TYPE returns #N/A, the IF function returns #N/A as well. Use ISERROR to avoid it as shown in the example above.

Related LibreOffice functions:

IF
ISERROR
NA

ODF standard:

This function is part of the Open Document Format for Office Applications (OpenDocument) standard Version 1.2. (ISO/IEC 26300:2-2015)

Equivalent Excel functions: