Difference between revisions of "Documentation/How Tos/Calc: CONCATENATE function"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Syntax:: & operator added)
(Example:: '&' example, and clarified RAND example)
Line 15: Line 15:
 
<tt>'''CONCATENATE("al"; "tog"; "ether")'''</tt>
 
<tt>'''CONCATENATE("al"; "tog"; "ether")'''</tt>
 
: returns <tt>'''altogether'''</tt>.
 
: returns <tt>'''altogether'''</tt>.
 +
 +
<tt>'''"al" & "tog" & "ether"'''</tt>
 +
: also returns <tt>'''altogether'''</tt>.
  
 
<tt>'''CONCATENATE(A1; A2)'''</tt>
 
<tt>'''CONCATENATE(A1; A2)'''</tt>
Line 20: Line 23:
  
 
<tt>'''CONCATENATE(ROUND(RAND()*10); ROUND(RAND()*10); ROUND(RAND()*10))'''</tt>
 
<tt>'''CONCATENATE(ROUND(RAND()*10); ROUND(RAND()*10); ROUND(RAND()*10))'''</tt>
: returns <tt>'''xyz'''</tt> where <tt>'''x'''</tt>,  <tt>'''y'''</tt>, <tt>'''z'''</tt> are three randomly independent digits, while:
+
: returns the text string <tt>'''xyz'''</tt> where <tt>'''x'''</tt>,  <tt>'''y'''</tt>, <tt>'''z'''</tt> are three randomly independent digits, while:
 
:: <tt>'''REPT(ROUND(RAND()*10); 3)'''</tt>
 
:: <tt>'''REPT(ROUND(RAND()*10); 3)'''</tt>
: returns <tt>'''nnn'''</tt> where <tt>'''n'''</tt> is a random digit repeated three times.
+
: returns <tt>'''nnn'''</tt> where <tt>'''n'''</tt> is a random digit repeated three times.
 +
: Here Calc converts each number given by <tt>'''ROUND(RAND()*10))'''</tt> to text before concatenating.
  
 
<tt>'''CONCATENATE("Print Date: " ; TEXT(TODAY();"dddd, d mmmm yyyy"))</tt>
 
<tt>'''CONCATENATE("Print Date: " ; TEXT(TODAY();"dddd, d mmmm yyyy"))</tt>

Revision as of 17:26, 1 August 2010


CONCATENATE

Combines several text strings into one string.

Syntax:

CONCATENATE(text1; text2; ... text30)

returns up to 30 text strings text1 - text30, joined together.
text1 - text30 may also be single cell references.
The ampersand operator & may also be used to concatenate text.

Example:

CONCATENATE("al"; "tog"; "ether")

returns altogether.

"al" & "tog" & "ether"

also returns altogether.

CONCATENATE(A1; A2)

where cell A1 contains key and cell A2 contains board returns keyboard.

CONCATENATE(ROUND(RAND()*10); ROUND(RAND()*10); ROUND(RAND()*10))

returns the text string xyz where x, y, z are three randomly independent digits, while:
REPT(ROUND(RAND()*10); 3)
returns nnn where n is a random digit repeated three times.
Here Calc converts each number given by ROUND(RAND()*10)) to text before concatenating.

CONCATENATE("Print Date: " ; TEXT(TODAY();"dddd, d mmmm yyyy"))

returns Print Date: Thursday, 1 January 2009 (assuming today's date was Jan 1, 2009). This example serves to demonstrate that you can combine functions in quite complex ways. This example is made up of the date function TODAY() which returns the current date as a number (NOTE: Jan 1, 2009 is represented as 39814) and the text function TEXT() which allows you to format the numeric representation of the date in a [useful] textual format.

Template:Documentation/SeeAlso

Personal tools