Syntax
=TEXTJOIN(delimiter, ignore_empty, text1, [text2], ...)Arguments
| Argument | Required | Description |
|---|---|---|
delimiter | Required | Text to put between the values (a range or array of delimiters is used in turn) |
ignore_empty | Required | TRUE to skip empty values |
text1 | Required | A text, value or range |
text2 | Optional | More texts, values or ranges |
How to use TEXTJOIN
TEXTJOIN takes 3 required arguments and 1 optional argument, and accepts more values in the same pattern. Type =TEXTJOIN( in a cell and SheetsBat shows the arguments as you go. Optional arguments are shown in square brackets; leave them out to use their default.
Examples
Each result below was calculated by the SheetsBat formula engine.
=TEXTJOIN(", ", TRUE, "a", "", "b")Result =TEXTJOIN("-", FALSE, "a", "", "b")Result =TEXTJOIN(" ", TRUE, {"The","sun";"will","rise"})Result Related text functions
- TReturns the value if it is text, otherwise empty text.
- TEXTFormats a number as text with a number format code, like "$#,##0.00" or "yyyy-mm-dd".
- TEXTAFTERReturns the text that comes after a delimiter.
- TEXTBEFOREReturns the text that comes before a delimiter.
- TEXTSPLITSplits text into columns and rows at the delimiters you give.
- TO_DATEReturns a number as a date value (the number itself; text and other values are returned unchanged).
- TO_DOLLARSReturns a number as a currency value (the number itself; other values are returned unchanged).
- TO_PERCENTReturns a number as a percentage value (the number itself; other values are returned unchanged).
- TO_PURE_NUMBERReturns a value as a plain number without date, percent or currency meaning; numeric text is converted.