summaryrefslogtreecommitdiff
path: root/source/text/scalc/01/func_text.xhp
blob: 0456c86acd943e06ce0aad63e3a6194395153bcf (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
  <!--
    * This file is part of the LibreOffice project.
    *
    * This Source Code Form is subject to the terms of the Mozilla Public
    * License, v. 2.0. If a copy of the MPL was not distributed with this
    * file, You can obtain one at http://mozilla.org/MPL/2.0/.
    *
  -->
  <meta>
    <topic id="calcfunc_text" indexer="include" status="PUBLISH">
      <title id="tit">TEXT Function</title>
      <filename>/text/scalc/01/func_text.xhp</filename>
    </topic>
  </meta>
  <body>
    <bookmark branch="index" id="bm_id3147132">
  <bookmark_value>TEXT function</bookmark_value>
</bookmark>
    <bookmark branch="hid/SC_HID_FUNC_TEXT" id="bm_id3156426" localize="false"/>
    <section id="func_text">
      <h1 id="hd_id3147132">
        <variable id="text_h1">
          <link href="text/scalc/01/func_text.xhp">TEXT</link>
        </variable>
      </h1>
      <paragraph id="par_id3147213" role="paragraph">
        <ahelp hid="HID_FUNC_TEXT">Converts a value into text according to a given format.</ahelp>
      </paragraph>
    </section>
    <embed href="text/scalc/01/common_func.xhp#sectionsyntax"/>
    <paragraph id="par_id3147377" role="code">TEXT(Value; Format)</paragraph>
    <paragraph id="par_id3147389" role="paragraph"> <emph>Value</emph> is the value (numerical or textual) to be converted.</paragraph>
    <paragraph id="par_id3156167" role="paragraph"> <emph>Format</emph> is the text which defines the format. Use decimal and thousands separators according to the language set in the cell format.</paragraph>
    <embed href="text/scalc/01/common_func.xhp#sectionexample"/>
    <paragraph id="par_id9044770" role="paragraph"> <item type="input">=TEXT(12.34567;"###.##")</item> returns the text 12.35</paragraph>
    <paragraph id="par_id3674123" role="paragraph"> <item type="input">=TEXT(12.34567;"000.00")</item> returns the text 012.35</paragraph>
    <paragraph id="par_id3674124" role="paragraph"> <item type="input">=TEXT("xyz";"=== @ ===")</item> returns the text === xyz ===</paragraph>
    <tip id="par_id3145364">See also <link href="text/shared/01/05020301.xhp">Number format codes</link>: custom format codes defined by the user.</tip>
    <section id="relatedtopics">
    <tip id="par_id701677016652715"><link href="https://wiki.documentfoundation.org/Documentation/Calc_Functions/TEXT">TEXT wiki page</link>.</tip>
    <paragraph role="paragraph" id="par_id81634670394769" localize="false"><embedvar href="text/scalc/01/04060110.xhp#head_text"/></paragraph>
    </section>
  </body>
</helpdocument>