A6UWV‖

rdDfi‖Information Functions

AhwX7‖This category contains the Information functions.

To access this command...

Insert - Function - Category Information


QhYqp‖The data in the following table serves as the basis for some of the examples in the function descriptions:

C

D

2

kWaVy‖x value

yW4vY‖y value

3

-5

-3

4

-2

0

5

-1

1

6

0

3

7

2

4

8

4

6

9

6

8


mbGC8‖

2V95T‖ISNONTEXT

D3ZKU‖Tests if the cell contents are text or numbers, and returns FALSE if the contents are text.

CPmrb‖If an error occurs, the function returns TRUE.

GSbiK‖Syntax

cFc8d‖ISNONTEXT(Value)

NUkLc‖Value is any value or expression where a test is performed to determine whether it is a text or numbers or a Boolean value.

MiUAf‖Example

Es2Py‖=ISNONTEXT(D2) returns FALSE if cell D2 contains the text abcdef.

itFUp‖=ISNONTEXT(D9) returns TRUE if cell D9 contains the number 8.

WGDrJ‖

3BU4F‖FORMULA

hpK42‖Displays the formula of a formula cell as a text string.

4BGvn‖This function is always recalculated whenever a recalculation occurs.

GSbiK‖Syntax

9shHD‖FORMULA(Reference)

yX4Jk‖Reference is a reference to a cell containing a formula.

Lj4tG‖An invalid reference or a reference to a cell with no formula results in the error value #N/A.

MiUAf‖Example

HkX2F‖If cell A8 contains the formula =SUM(1;2;3) then

UYSii‖=FORMULA(A8) returns the text =SUM(1;2;3).

jfdsG‖

9iQBn‖ISBLANK

fVZgm‖Returns TRUE if the reference to a cell is blank. This function is used to determine if the content of a cell is empty. A cell with a formula inside is not empty.

If an error occurs, the function returns a logical or numerical value.

GSbiK‖Syntax

DkGHv‖ISBLANK(Value)

xsDtT‖Value is the content to be tested.

MiUAf‖Example

q8tvF‖=ISBLANK(D2) returns FALSE as a result.

6CehE‖

Auh6F‖N

vFmMG‖Returns the numeric value of the given parameter. Returns 0 if parameter is text or FALSE.

wa6oF‖If an error occurs the function returns the error value.

GSbiK‖Syntax

fBDGC‖N(Value)

GvFBi‖Value is the parameter to be converted into a number. N() returns the numeric value if it can. It returns the logical values TRUE and FALSE as 1 and 0 respectively. It returns text as 0.

MiUAf‖Example

6ELat‖=N(123) returns 123

DT5F5‖=N(TRUE()) returns 1

MJvod‖=N(FALSE()) returns 0

AaBho‖=N("abc") returns 0

Dex3d‖=N(1/0) returns #DIV/0!

DA5yF‖

C5F8v‖TYPE

kB3G2‖Returns the type of value, where 1 = number, 2 = text, 4 = Boolean value, 8 = formula, 16 = error value, 64 = array.

If an error occurs, the function returns a logical or numerical value.

GSbiK‖Syntax

wEzA3‖TYPE(Value)

rArix‖Value is a specific value for which the data type is determined.

pVYZE‖Example (see example table above)

sm7gT‖=TYPE(C2) returns 2 as a result.

AnCMi‖=TYPE(D9) returns 1 as a result.

C53ym‖

CwKgU‖CURRENT

zPadK‖This function returns the result to date of evaluating the formula of which it is a part (in other words the result as far as that evaluation has got). Its main use is together with the STYLE() function to apply selected styles to a cell depending on the cell contents.

GSbiK‖Syntax

VVH9p‖CURRENT()

MiUAf‖Example

J5rkB‖=1+2+CURRENT()

zCD7r‖The example returns 6. The formula is calculated from left to right as: 1 + 2 equals 3, giving the result to date when CURRENT() is encountered; CURRENT() therefore yields 3, which is added to the original 3 to give 6.

3LWfB‖=A2+B2+STYLE(IF(CURRENT()>10;"Red";"Default"))

fNamE‖The example returns A2 + B2 (STYLE returns 0 here). If this sum is greater than 10, the style Red is applied to the cell. See the STYLE function for more explanation.

bF4GC‖="choo"&CURRENT()

h64Yd‖The example returns choochoo.

XAFa7‖Technical information

7AVhU‖This function is not part of the Open Document Format for Office Applications (OpenDocument) Version 1.3. Part 4: Recalculated Formula (OpenFormula) Format standard. The name space is

ORG.OPENOFFICE.CURRENT

FAiDC‖

DWG3v‖IFERROR

AXmEw‖Returns the value if the cell does not contain an error value, or the alternative value if it does.

tip

VJxhP‖This function is available since LibreOfficeDev 4.0.


GSbiK‖Syntax

LREwJ‖IFERROR(Value; Alternate_value)

wJRYc‖Value is the value or expression to be returned if it is not equal or results in an error.

YndHN‖Alternate_value is the value or expression to be returned if the expression or value of Value is equal or results in an error.

MiUAf‖Example

P5A9v‖=IFERROR(C8;C9) where cell C8 contains =1/0 returns the value of C9, because 1/0 is an error.

GCAeY‖=IFERROR(C8;C9) where cell C8 contains 13 returns 13, the value of C8, which is not an error.

uxFQT‖

EYAcE‖ISLOGICAL

jxjCe‖Tests for a logical value (TRUE or FALSE).

ucKHh‖If an error occurs, the function returns FALSE.

GSbiK‖Syntax

V2ukf‖ISLOGICAL(Value)

nzMeE‖Returns TRUE if Value is a logical value (TRUE or FALSE), and returns FALSE otherwise.

MiUAf‖Example

njbrg‖=ISLOGICAL(99) returns FALSE, because 99 is a number, not a logical value.

RKxzG‖=ISLOGICAL(ISNA(D4)) returns TRUE whatever the contents of cell D4, because ISNA() returns a logical value.

eGnko‖

Eu8CA‖ISNA

37cBk‖Returns TRUE if a cell contains the #N/A (value not available) error value.

29huD‖If an error occurs, the function returns FALSE.

GSbiK‖Syntax

Atn9F‖ISNA(Value)

UfAek‖Value is the value or expression to be tested.

MiUAf‖Example

UyzSk‖=ISNA(D3) returns FALSE as a result.

sDf32‖

HJa2h‖NA

McXEX‖Returns the error value #N/A.

GSbiK‖Syntax

BLWEq‖NA()

MiUAf‖Example

jKbRF‖=NA() converts the contents of the cell into #N/A.

QHjPC‖

KYhTp‖ISEVEN

EprYg‖Returns TRUE if the value is an even integer, or FALSE if the value is odd.

GSbiK‖Syntax

HCBiF‖ISEVEN(Value)

AkijZ‖Value is the value to be checked.

e26nV‖If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored.

MiUAf‖Example

DVFRc‖=ISEVEN(48) returns TRUE

DAs9F‖=ISEVEN(33) returns FALSE

HEEEF‖=ISEVEN(0) returns TRUE

WYyKu‖=ISEVEN(-2.1) returns TRUE

CqTmy‖=ISEVEN(3.999) returns FALSE

nDUJo‖

KjFXB‖ISODD_ADD

kTH52‖Returns TRUE (1) if the number does not return a whole number when divided by 2.

note

gGXZq‖The functions whose names end with _ADD or _EXCEL2003 return the same results as the corresponding Microsoft Excel 2003 functions without the suffix. Use the functions without suffix to get results based on international standards.


GSbiK‖Syntax

hekk5‖ISODD_ADD(Number)

VBwDe‖Number is the number to be tested.

MiUAf‖Example

SD8TH‖=ISODD_ADD(5) returns 1.

eWiZW‖

R2rRu‖ISERR

x5VGW‖Tests for error conditions, except the #N/A error value, and returns TRUE or FALSE.

If an error occurs, the function returns a logical or numerical value.

GSbiK‖Syntax

objAY‖ISERR(Value)

CmaCg‖Value is any value or expression which is tested to see whether an error value other than #N/A is present.

MiUAf‖Example

Vt6nx‖=ISERR(C8) where cell C8 contains =1/0 returns TRUE, because 1/0 is an error.

SCkC9‖=ISERR(C9) where cell C9 contains =NA() returns FALSE, because ISERR() ignores the #N/A error.

EPMG4‖

UbDEA‖ISTEXT

tkiro‖Returns TRUE if the cell contents refer to text.

KZrLf‖If an error occurs, the function returns FALSE.

GSbiK‖Syntax

Fuvo6‖ISTEXT(Value)

mQNoM‖Value is a value, number, Boolean value, or an error value to be tested.

MiUAf‖Example

RmeYe‖=ISTEXT(D9) returns TRUE if cell D9 contains the text abcdef.

i33gE‖=ISTEXT(C3) returns FALSE if cell C3 contains the number 3.

8Y3LT‖

WyZEe‖ISERROR

GeByF‖Tests for error conditions, including the #N/A error value, and returns TRUE or FALSE.

If an error occurs, the function returns a logical or numerical value.

GSbiK‖Syntax

FCc6b‖ISERROR(Value)

Usvv4‖Value is or refers to the value to be tested. ISERROR() returns TRUE if there is an error and FALSE if not.

MiUAf‖Example

RrzQ7‖=ISERROR(C8) where cell C8 contains =1/0 returns TRUE, because 1/0 is an error.

CCX3g‖=ISERROR(C9) where cell C9 contains =NA() returns TRUE.

AUBFT‖

bLFTJ‖ISFORMULA

AA9Ac‖Returns TRUE if a cell is a formula cell.

If an error occurs, the function returns a logical or numerical value.

GSbiK‖Syntax

Aid2Q‖ISFORMULA(Reference)

KMuHY‖Reference indicates the reference to a cell in which a test will be performed to determine if it contains a formula.

MiUAf‖Example

2sRxo‖=ISFORMULA(C4) returns FALSE if the cell C4 contains the number 5.

6LE9A‖

eny2i‖ISNUMBER

hYfMi‖Returns TRUE if the value refers to a number.

If an error occurs, the function returns a logical or numerical value.

GSbiK‖Syntax

TCEAQ‖ISNUMBER(Value)

BtoLC‖Value is any expression to be tested to determine whether it is a number or text.

MiUAf‖Example

wfxHG‖=ISNUMBER(C3) returns TRUE if the cell C3 contains the number 4.

bmnwv‖=ISNUMBER(C2) returns FALSE if the cell C2 contains the text abcdef.

PPqkS‖

ewksB‖CELL

vL4Bk‖Returns information on address, formatting or contents of a cell.

GSbiK‖Syntax

Vwajg‖CELL("InfoType" [; Reference])

wjBKt‖InfoType is the character string that specifies the type of information. The character string is always in English. Upper or lower case is optional.

8mfxR‖InfoType

swfVF‖Meaning

COL

FA2AL‖Returns the number of the referenced column.

GVZP9‖=CELL("COL";D2) returns 4.

ROW

HARvL‖Returns the number of the referenced row.

puDDA‖=CELL("ROW";D2) returns 2.

SHEET

DfyBE‖Returns the number of the referenced sheet.

bPZDC‖=CELL("Sheet";Sheet3.D2) returns 3.

ADDRESS

bPrEF‖Returns the absolute address of the referenced cell.

pFWQT‖=CELL("ADDRESS";D2) returns $D$2.

wPMW4‖=CELL("ADDRESS";Sheet3.D2) returns $Sheet3.$D$2.

pwLQs‖=CELL("ADDRESS";'X:\dr\test.ods'#$Sheet1.D2) returns 'file:///X:/dr/test.ods'#$Sheet1.$D$2.

FILENAME

TYtiD‖Returns the file name and the sheet number of the referenced cell.

9F2Fs‖=CELL("FILENAME";D2) returns 'file:///X:/dr/own.ods'#$Sheet1, if the formula in the current document X:\dr\own.ods is located in Sheet1.

CM45L‖=CELL("FILENAME";'X:\dr\test.ods'#$Sheet1.D2) returns 'file:///X:/dr/test.ods'#$Sheet1.

COORD

GJsAD‖Returns the complete cell address in Lotus™ notation.

a8afR‖=CELL("COORD"; D2) returns $A:$D$2.

SzfBm‖=CELL("COORD"; Sheet3.D2) returns $C:$D$2.

CONTENTS

gBkWA‖Returns the contents of the referenced cell, without any formatting.

TYPE

umGSc‖Returns the type of cell contents.

uXUWK‖b = blank. empty cell

EYMEH‖l = label. Text, result of a formula as text

CZQw8‖v = value. Value, result of a formula as a number

WIDTH

jwaDG‖Returns the width of the referenced column. The unit is the number of zeros (0) that fit into the column in the default text and the default size.

PREFIX

aWBBj‖Returns the alignment of the referenced cell.

JPwrF‖' = align left or left-justified

HCW2A‖" = align right

ffq7b‖^ = centered

ESasA‖\ = repeating (currently inactive)

PROTECT

jG9Lm‖Returns the status of the cell protection for the cell.

9pzWU‖1 = cell is protected

Ldrgg‖0 = cell is not protected

FORMAT

PjRCh‖Returns a character string that indicates the number format.

CAkDF‖, = number with thousands separator

nFzRU‖F = number without thousands separator

E75LA‖C = currency format

g9F6q‖S = exponential representation, for example, 1.234+E56

MExhx‖P = percentage

wFKNg‖In the above formats, the number of decimal places after the decimal separator is given as a number. Example: the number format #,##0.0 returns ,1 and the number format 00.000% returns P3

cC9zV‖D1 = MMM-D-YY, MM-D-YY and similar formats

VXSyz‖D2 = DD-MM

hz4ig‖D3 = MM-YY

gbGFa‖D4 = DD-MM-YYYY HH:MM:SS

EP3zz‖D5 = MM-DD

JvGDB‖D6 = HH:MM:SS AM/PM

tbyFR‖D7 = HH:MM AM/PM

kyM2i‖D8 = HH:MM:SS

F2aSg‖D9 = HH:MM

gPDCV‖G = All other formats

2VcnA‖- (Minus) at the end = negative numbers are formatted in color

6uTvC‖() (brackets) at the end = there is an opening bracket in the format code

COLOR

PWRH8‖Returns 1, if negative values have been formatted in color, otherwise 0.

PARENTHESES

a4fCE‖Returns 1 if the format code contains an opening bracket (, otherwise 0.


LZnbE‖Reference (list of options) is the position of the cell to be examined. If Reference is a range, the cell moves to the top left of the range. If Reference is missing, LibreOfficeDev Calc uses the position of the cell in which this formula is located. Microsoft Excel uses the reference of the cell in which the cursor is positioned.

HPHaH‖

koPGN‖ISREF

QBxWV‖Tests if the argument is a reference. Returns TRUE if the argument is a reference, returns FALSE otherwise. When given a reference this function does not examine the value being referenced.

If an error occurs, the function returns a logical or numerical value.

GSbiK‖Syntax

rMqmV‖ISREF(Value)

YGA2X‖Value is the value to be tested, to determine whether it is a reference.

MiUAf‖Example

rBp4F‖=ISREF(C5) returns the result TRUE because C5 is a valid reference.

2BeJJ‖=ISREF("abcdef") returns always FALSE because a text can never be a reference.

DR9wL‖=ISREF(4) returns FALSE.

4isXS‖=ISREF(INDIRECT("A6")) returns TRUE, because INDIRECT is a function that returns a reference.

iJ4DD‖=ISREF(ADDRESS(1; 1; 2;"Sheet2")) returns FALSE, because ADDRESS is a function that returns a text, although it looks like a reference.

vC6A4‖

oBwBv‖INFO

DDRBQ‖Returns specific information about the current working environment. The function receives a single text argument and returns data depending on that parameter.

4BGvn‖This function is always recalculated whenever a recalculation occurs.

GSbiK‖Syntax

LvKWH‖INFO("Type")

hf5Jp‖The following table lists the values for the text parameter Type and the return values of the INFO function.

VKBSE‖Value for "Type"

8B8jf‖Return value

"osversion"

Qb9m8‖Always "Windows (32-bit) NT 5.01", for compatibility reasons

"system"

sF4B5‖The type of the operating system:
"ANDROID" for Google mobile operating system
"DRAGONFLY" for DragonFly operating system forked from FreeBSD
"EMSCRIPTEN" for browser WebAssembly system
"FREEBSD", "OPENBSD" or "NETBSD" for operating systems based on the Berkeley Software Distribution (BSD)
"HAIKU" for BeOS compatible operating system
"iOS" for Apple mobile operating system
"LINUX" for GNU/Linux based operating systems
"MACOSX" for Apple macOS
"SOLARIS" for Oracle Solaris operating system
"WNT" for Microsoft Windows

"release"

zcvAx‖The product release identifier, for example "300m25(Build:9876)"

"numfile"

zBCAC‖Always 1, for compatibility reasons

"recalc"

WyTya‖Current formula recalculation mode, either "Automatic" or "Manual" (localized into LibreOfficeDev language)


note

E9799‖Other spreadsheet applications may accept localized values for the Type parameter, but LibreOfficeDev Calc will only accept the English values.


MiUAf‖Example

nyAKb‖=INFO("release") returns the product release number of the LibreOfficeDev in use.

DTRsf‖=INFO(D5) with cell D5 containing a text string system returns the operation system type.

TEYb4‖

vNz2E‖ISODD

LogcS‖Returns TRUE if the value is odd, or FALSE if the number is even.

GSbiK‖Syntax

ScQLv‖ISODD(value)

FhQJC‖Value is the value to be checked.

J2P4u‖If Value is not an integer any digits after the decimal point are ignored. The sign of Value is also ignored.

MiUAf‖Example

iXWnD‖=ISODD(33) returns TRUE

JvVBB‖=ISODD(48) returns FALSE

26rpB‖=ISODD(3.999) returns TRUE

HCx9g‖=ISODD(-3.1) returns TRUE

BEYhG‖

vdEm2‖IFNA

Mq9qJ‖Returns the value if the cell does not contain the #N/A (value not available) error value, or the alternative value if it does.

tip

VJxhP‖This function is available since LibreOfficeDev 4.0.


GSbiK‖Syntax

hQbWy‖IFNA(Value; Alternate_value)

6oj7E‖Value is the value or expression to be returned if it is not equal or results in an #N/A error.

CM9Ds‖Alternate_value is the value or expression to be returned if the expression or value of Value is equal or results in an #N/A error.

MiUAf‖Example

ZyKiX‖=IFNA(D3;D4) returns the value of D3 if D3 does not result in an #N/A error, or D4 if it does.

naG5c‖

yBceo‖ISEVEN_ADD

uhPW4‖Tests for even numbers. Returns 1 if the number divided by 2 returns a whole number.

note

gGXZq‖The functions whose names end with _ADD or _EXCEL2003 return the same results as the corresponding Microsoft Excel 2003 functions without the suffix. Use the functions without suffix to get results based on international standards.


GSbiK‖Syntax

xSABe‖ISEVEN_ADD(Number)

MS24X‖Number is the number to be tested.

MiUAf‖Example

TRGCF‖=ISEVEN_ADD(5) returns 0.

AASDZ‖=ISEVEN_ADD(A1) returns 1 if cell A1 contains the number 2.