VALUETOTEXT function
VALUETOTEXT converts any value into text and returns it. Strict mode adds quotes so you can tell text from numbers, and errors are converted to text instead of propagating.
Example
Read it as a sentence: turn the value in F5, which holds the result of 1/0, into text, which gives #DIV/0!.
Excel shows #DIV/0!
F
1
2
'123
3
2024-02-29
4
TRUE
5
=1/0
Data
Syntax
VALUETOTEXT(value, [format])
Arguments in [square brackets] are optional.
-
value(required) - The value to convert.
-
format(optional) - 0 concise (default); 1 strict, with quotes around text.
Returns: The value as text.
What Excel actually returns
Each formula below was run in desktop Excel. The result is exactly what the cell showed, errors included.
| Formula | Excel shows | Case |
|---|---|---|
=VALUETOTEXT("abc") | abc | Concise text |
=VALUETOTEXT("abc",1) | "abc" | Strict text |
=VALUETOTEXT(12.5) | 12.5 | Number |
=VALUETOTEXT(TRUE,1) | TRUE | Bool strict |
=VALUETOTEXT({1,"a"},1) | 1 | Array spills |
=VALUETOTEXT(Data!F5) | #DIV/0! | Error |
=VALUETOTEXT(Data!F1) | Blank | |
=VALUETOTEXT(1,2) | #VALUE! | Bad format |
The Data sheet these formulas read
A cell that starts with = holds that formula.
F
1
2
'123
3
2024-02-29
4
TRUE
5
=1/0
Data
Watch out for
- Errors are converted to text instead of propagating.
Where it works
- Excel
- VALUETOTEXT arrived in Excel 2021. Older versions do not have it.
- Google Sheets
- No direct equivalent. Use TO_TEXT for a similar result.
Part of Text functions. Every result on this page was measured in desktop Excel, build 16.0.20527. Last updated .