1<?xml version="1.0" encoding="UTF-8"?> 2 3<!--*********************************************************** 4 * 5 * Licensed to the Apache Software Foundation (ASF) under one 6 * or more contributor license agreements. See the NOTICE file 7 * distributed with this work for additional information 8 * regarding copyright ownership. The ASF licenses this file 9 * to you under the Apache License, Version 2.0 (the 10 * "License"); you may not use this file except in compliance 11 * with the License. You may obtain a copy of the License at 12 * 13 * http://www.apache.org/licenses/LICENSE-2.0 14 * 15 * Unless required by applicable law or agreed to in writing, 16 * software distributed under the License is distributed on an 17 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 18 * KIND, either express or implied. See the License for the 19 * specific language governing permissions and limitations 20 * under the License. 21 * 22 ***********************************************************--> 23 24<helpdocument version="1.0"> 25<meta> 26<topic id="textscalc0104060110xml" indexer="include"> 27<title xml-lang="en-US" id="tit">Text Functions</title> 28<filename>/text/scalc/01/04060110.xhp</filename> 29</topic> 30</meta> 31<body> 32<bookmark xml-lang="en-US" branch="index" id="bm_id3145389"> 33<bookmark_value>text in cells; functions</bookmark_value> 34<bookmark_value>functions; text functions</bookmark_value> 35<bookmark_value>Function Wizard;text</bookmark_value> 36</bookmark> 37<paragraph xml-lang="en-US" id="hd_id3145389" role="heading" level="1" l10n="U" oldref="1">Text Functions</paragraph> 38<paragraph xml-lang="en-US" id="par_id3152986" role="paragraph" l10n="CHG" oldref="2"><variable id="texttext">This section contains descriptions of the <emph>Text</emph> functions. 39</variable></paragraph> 40<section id="howtoget"> 41<embed href="text/scalc/00/00000404.xhp#eikatext"/> 42</section> 43<sort order="asc"> 44<section id="arabic"> 45<bookmark xml-lang="en-US" branch="index" id="bm_id3149384"> 46<bookmark_value>ARABIC function</bookmark_value> 47</bookmark> 48<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ARABISCH" id="bm_id3145359" localize="false"/> 49<paragraph xml-lang="en-US" id="hd_id3149384" role="heading" level="2" l10n="U" 50oldref="239">ARABIC</paragraph> 51<paragraph xml-lang="en-US" id="par_id3153558" role="paragraph" l10n="U" oldref="240"><ahelp hid="HID_FUNC_ARABISCH">Calculates the value of a Roman number. The value range must be between 0 and 3999.</ahelp></paragraph> 52<paragraph xml-lang="en-US" id="hd_id3153011" role="heading" level="3" l10n="U" 53oldref="241">Syntax</paragraph> 54<paragraph xml-lang="en-US" id="par_id3155523" role="code" l10n="U" oldref="242">ARABIC("Text")</paragraph> 55<paragraph xml-lang="en-US" id="par_id3151193" role="paragraph" l10n="U" oldref="243"> 56<emph>Text</emph> is the text that represents a Roman number.</paragraph> 57<paragraph xml-lang="en-US" id="hd_id3155758" role="heading" level="3" l10n="U" 58oldref="244">Example</paragraph> 59<paragraph xml-lang="en-US" id="par_id3154621" role="paragraph" l10n="U" oldref="245"> 60<item type="input">=ARABIC("MXIV")</item> returns 1014</paragraph> 61<paragraph xml-lang="en-US" id="par_id3147553" role="paragraph" l10n="U" oldref="246"> 62<item type="input">=ARABIC("MMII")</item> returns 2002</paragraph> 63</section> 64<section id="asc"> 65<bookmark xml-lang="en-US" branch="index" id="bm_id8796349"> 66<bookmark_value>ASC function</bookmark_value> 67</bookmark><comment>i79585</comment> 68<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ASC" id="bm_id3187353" localize="false"/> 69<paragraph xml-lang="en-US" id="hd_id7723929" role="heading" level="2" l10n="NEW">ASC</paragraph> 70<paragraph xml-lang="en-US" id="par_id8455153" role="paragraph" l10n="NEW"><ahelp hid=".">The ASC function converts full-width to half-width ASCII and katakana characters. Returns a text string.</ahelp></paragraph> 71<paragraph xml-lang="en-US" id="par_id9912411" role="paragraph" l10n="NEW">See <link href="https://wiki.openoffice.org/wiki/Calc/Features/JIS_and_ASC_functions">JIS and ASC Spreadsheet Functions</link> for a conversion table.</paragraph> 72<paragraph xml-lang="en-US" id="hd_id9204992" role="heading" level="3" l10n="NEW">Syntax</paragraph> 73<paragraph xml-lang="en-US" id="par_id1993774" role="code" l10n="NEW">ASC("Text")</paragraph> 74<paragraph xml-lang="en-US" id="par_id2949919" role="paragraph" l10n="NEW"> 75<emph>Text</emph> is the text that contains characters to be converted.</paragraph> 76<paragraph xml-lang="en-US" id="par_id2355113" role="paragraph" l10n="NEW">See also JIS function.</paragraph> 77</section> 78<section id="bahttext"> 79<bookmark xml-lang="en-US" branch="index" id="bm_id9323709"> 80<bookmark_value>BAHTTEXT function</bookmark_value> 81</bookmark> 82<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BAHTTEXT" id="bm_id744346" localize="false"/><comment>i66350</comment> 83<paragraph xml-lang="en-US" id="hd_id6695455" role="heading" level="2" l10n="NEW">BAHTTEXT</paragraph> 84<paragraph xml-lang="en-US" id="par_id354014" role="paragraph" l10n="NEW">Converts a number to Thai text, including the Thai currency names.</paragraph> 85<paragraph xml-lang="en-US" id="hd_id9942014" role="heading" level="3" l10n="NEW">Syntax</paragraph> 86<paragraph xml-lang="en-US" id="par_id8780785" role="code" l10n="NEW">BAHTTEXT(Number)</paragraph> 87<paragraph xml-lang="en-US" id="par_id1539353" role="paragraph" l10n="NEW"> 88<emph>Number</emph> is any number. "Baht" is appended to the integral part of the number, and "Satang" is appended to the decimal part of the number.</paragraph> 89<paragraph xml-lang="en-US" id="hd_id9694814" role="heading" level="3" l10n="NEW">Example</paragraph> 90<paragraph xml-lang="en-US" id="par_id3289284" role="paragraph" l10n="NEW"> 91<item type="input">=BAHTTEXT(12.65)</item> returns a string in Thai characters with the meaning of "Twelve Baht and sixty five Satang".</paragraph> 92</section> 93<section id="base"> 94<bookmark xml-lang="en-US" branch="index" id="bm_id3153072"> 95<bookmark_value>BASE function</bookmark_value> 96</bookmark> 97<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_BASIS" id="bm_id3150957" localize="false"/> 98<paragraph xml-lang="en-US" id="hd_id3153072" role="heading" level="2" l10n="U" 99oldref="213">BASE</paragraph> 100<paragraph xml-lang="en-US" id="par_id3153289" role="paragraph" l10n="U" oldref="214"><ahelp hid="HID_FUNC_BASIS">Converts a positive integer to a specified base into a text from the <link href="text/shared/00/00000005.xhp#zahlensystem" name="numbering system">numbering system</link>.</ahelp> The digits 0-9 and the letters A-Z are used.</paragraph> 101<paragraph xml-lang="en-US" id="hd_id3146097" role="heading" level="3" l10n="U" 102oldref="215">Syntax</paragraph> 103<paragraph xml-lang="en-US" id="par_id3155743" role="code" l10n="U" oldref="216">BASE(Number; Radix; [MinimumLength])</paragraph> 104<paragraph xml-lang="en-US" id="par_id3151339" role="paragraph" l10n="U" oldref="217"> 105<emph>Number</emph> is the positive integer to be converted.</paragraph> 106<paragraph xml-lang="en-US" id="par_id3159262" role="paragraph" l10n="U" oldref="218"> 107<emph>Radix</emph> indicates the base of the number system. It may be any positive integer between 2 and 36.</paragraph> 108<paragraph xml-lang="en-US" id="par_id3148746" role="paragraph" l10n="U" oldref="219"> 109<emph>MinimumLength</emph> (optional) determines the minimum length of the character sequence that has been created. If the text is shorter than the indicated minimum length, zeros are added to the left of the string.</paragraph> 110<paragraph xml-lang="en-US" id="hd_id3146323" role="heading" level="3" l10n="U" 111oldref="220">Example</paragraph> 112<bookmark xml-lang="en-US" branch="index" id="bm_id3156399"> 113<bookmark_value>decimal system; converting to</bookmark_value> 114</bookmark> 115<paragraph xml-lang="en-US" id="par_id3156399" role="paragraph" l10n="U" oldref="221"> 116<item type="input">=BASE(17;10;4)</item> returns 0017 in the decimal system.</paragraph> 117<bookmark xml-lang="en-US" branch="index" id="bm_id3157871"> 118<bookmark_value>binary system; converting to</bookmark_value> 119</bookmark> 120<paragraph xml-lang="en-US" id="par_id3157871" role="paragraph" l10n="U" oldref="222"> 121<item type="input">=BASE(17;2)</item> returns 10001 in the binary system.</paragraph> 122<bookmark xml-lang="en-US" branch="index" id="bm_id3145226"> 123<bookmark_value>hexadecimal system; converting to</bookmark_value> 124</bookmark> 125<paragraph xml-lang="en-US" id="par_id3145226" role="paragraph" l10n="U" oldref="223"> 126<item type="input">=BASE(255;16;4)</item> returns 00FF in the hexadecimal system.</paragraph> 127</section> 128<section id="char"> 129<bookmark xml-lang="en-US" branch="index" id="bm_id3149321"> 130<bookmark_value>CHAR function</bookmark_value> 131</bookmark> 132<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ZEICHEN" id="bm_id3159128" localize="false"/> 133<paragraph xml-lang="en-US" id="hd_id3149321" role="heading" level="2" l10n="U" 134oldref="201">CHAR</paragraph> 135<paragraph xml-lang="en-US" id="par_id3149150" role="paragraph" l10n="U" oldref="202"><ahelp hid="HID_FUNC_ZEICHEN">Converts a number into a character according to the current code table.</ahelp> The number can be a two-digit or three-digit integer number.</paragraph> 136<embed href="text/scalc/00/00000004.xhp#codes"/> 137<paragraph xml-lang="en-US" id="hd_id3149945" role="heading" level="3" l10n="U" 138oldref="203">Syntax</paragraph> 139<paragraph xml-lang="en-US" id="par_id3145634" role="code" l10n="U" oldref="204">CHAR(Number)</paragraph> 140<paragraph xml-lang="en-US" id="par_id3155906" role="paragraph" l10n="U" oldref="205"> 141<emph>Number</emph> is a number between 1 and 255 representing the code value for the character.</paragraph> 142<paragraph xml-lang="en-US" id="hd_id3152982" role="heading" level="3" l10n="U" 143oldref="207">Example</paragraph> 144<paragraph xml-lang="en-US" id="par_id3149890" role="paragraph" l10n="CHG" oldref="208"> 145<item type="input">=CHAR(100)</item> returns the character d.</paragraph> 146<paragraph xml-lang="en-US" id="par_id0907200910283297" role="paragraph" l10n="NEW">="abc" & CHAR(10) & "def" inserts a newline character into the string.</paragraph> 147</section> 148<section id="clean"> 149<bookmark xml-lang="en-US" branch="index" id="bm_id3149009"> 150<bookmark_value>CLEAN function</bookmark_value> 151</bookmark> 152<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SAEUBERN" id="bm_id3148729" localize="false"/> 153<paragraph xml-lang="en-US" id="hd_id3149009" role="heading" level="2" l10n="U" 154oldref="132">CLEAN</paragraph> 155<paragraph xml-lang="en-US" id="par_id3150482" role="paragraph" l10n="U" oldref="133"><ahelp hid="HID_FUNC_SAEUBERN">All non-printing characters are removed from the string.</ahelp></paragraph> 156<paragraph xml-lang="en-US" id="hd_id3146880" role="heading" level="3" l10n="U" 157oldref="134">Syntax</paragraph> 158<paragraph xml-lang="en-US" id="par_id3147472" role="code" l10n="U" oldref="135">CLEAN("Text")</paragraph> 159<paragraph xml-lang="en-US" id="par_id3150695" role="paragraph" l10n="U" oldref="136"> 160<emph>Text</emph> refers to the text from which to remove all non-printable characters.</paragraph> 161</section> 162<section id="code"> 163<bookmark xml-lang="en-US" branch="index" id="bm_id3155498"> 164<bookmark_value>CODE function</bookmark_value> 165</bookmark> 166<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_CODE" id="bm_id3159084" localize="false"/> 167<paragraph xml-lang="en-US" id="hd_id3155498" role="heading" level="2" l10n="U" oldref="3">CODE</paragraph> 168<paragraph xml-lang="en-US" id="par_id3152770" role="paragraph" l10n="U" oldref="4"><ahelp hid="HID_FUNC_CODE">Returns a numeric code for the first character in a text string.</ahelp></paragraph> 169<paragraph xml-lang="en-US" id="hd_id3155830" role="heading" level="3" l10n="U" oldref="5">Syntax</paragraph> 170<paragraph xml-lang="en-US" id="par_id3149188" role="code" l10n="U" oldref="6">CODE("Text")</paragraph> 171<paragraph xml-lang="en-US" id="par_id3154383" role="paragraph" l10n="U" oldref="7"> 172<emph>Text</emph> is the text for which the code of the first character is to be found.</paragraph> 173<embed href="text/scalc/00/00000004.xhp#codes"/> 174<paragraph xml-lang="en-US" id="hd_id3154394" role="heading" level="3" l10n="U" oldref="8">Example</paragraph> 175<paragraph xml-lang="en-US" id="par_id3159209" role="paragraph" l10n="U" oldref="9"> 176<item type="input">=CODE("Hieronymus")</item> returns 72, <item type="input">=CODE("hieroglyphic")</item> returns 104.</paragraph> 177<paragraph xml-lang="en-US" id="par_id3150280" role="note" l10n="U" oldref="211">The code used here does not refer to ASCII, but to the code table currently loaded.</paragraph> 178</section> 179<section id="concatenate"> 180<bookmark xml-lang="en-US" branch="index" id="bm_id3149688"> 181<bookmark_value>CONCATENATE function</bookmark_value> 182</bookmark> 183<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_VERKETTEN" id="bm_id3153084" localize="false"/> 184<paragraph xml-lang="en-US" id="hd_id3149688" role="heading" level="2" l10n="U" 185oldref="167">CONCATENATE</paragraph> 186<paragraph xml-lang="en-US" id="par_id3154524" role="paragraph" l10n="U" oldref="168"><ahelp hid="HID_FUNC_VERKETTEN">Combines several text strings into one string.</ahelp></paragraph> 187<paragraph xml-lang="en-US" id="hd_id3149542" role="heading" level="3" l10n="U" 188oldref="169">Syntax</paragraph> 189<paragraph xml-lang="en-US" id="par_id3155954" role="code" l10n="U" oldref="170">CONCATENATE("Text1"; ...; "Text30")</paragraph> 190<paragraph xml-lang="en-US" id="par_id3146847" role="paragraph" l10n="U" oldref="171"> 191<emph>Text 1; Text 2; ...</emph> represent up to 30 text passages which are to be combined into one string.</paragraph> 192<paragraph xml-lang="en-US" id="hd_id3153110" role="heading" level="3" l10n="U" 193oldref="172">Example</paragraph> 194<paragraph xml-lang="en-US" id="par_id3150008" role="paragraph" l10n="U" oldref="173"> 195<item type="input">=CONCATENATE("Good ";"Morning ";"Mrs. ";"Doe")</item> returns: Good Morning Mrs. Doe.</paragraph> 196</section> 197<section id="decimal"> 198<bookmark xml-lang="en-US" branch="index" id="bm_id3145166"> 199<bookmark_value>DECIMAL function</bookmark_value> 200</bookmark> 201<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DEZIMAL" id="bm_id3150338" localize="false"/> 202<paragraph xml-lang="en-US" id="hd_id3145166" role="heading" level="2" l10n="U" 203oldref="225">DECIMAL</paragraph> 204<paragraph xml-lang="en-US" id="par_id3156361" role="paragraph" l10n="U" oldref="226"><ahelp hid="HID_FUNC_DEZIMAL">Converts text with characters from a <link href="text/shared/00/00000005.xhp#zahlensystem" name="number system">number system</link> to a positive integer in the base radix given.</ahelp> The radix must be in the range 2 to 36. Spaces and tabs are ignored. The <emph>Text</emph> field is not case-sensitive.</paragraph> 205<paragraph xml-lang="en-US" id="par_id3157994" role="paragraph" l10n="U" oldref="227">If the radix is 16, a leading x or X or 0x or 0X, and an appended h or H, is disregarded. If the radix is 2, an appended b or B is disregarded. Other characters that do not belong to the number system generate an error.</paragraph> 206<paragraph xml-lang="en-US" id="hd_id3150014" role="heading" level="3" l10n="U" 207oldref="228">Syntax</paragraph> 208<paragraph xml-lang="en-US" id="par_id3154328" role="code" l10n="U" oldref="229">DECIMAL("Text"; Radix)</paragraph> 209<paragraph xml-lang="en-US" id="par_id3150128" role="paragraph" l10n="U" oldref="230"> 210<emph>Text</emph> is the text to be converted. To differentiate between a hexadecimal number, such as A1 and the reference to cell A1, you must place the number in quotation marks, for example, "A1" or "FACE".</paragraph> 211<paragraph xml-lang="en-US" id="par_id3145241" role="paragraph" l10n="U" oldref="231"> 212<emph>Radix</emph> indicates the base of the number system. It may be any positive integer between 2 and 36.</paragraph> 213<paragraph xml-lang="en-US" id="hd_id3156062" role="heading" level="3" l10n="U" 214oldref="232">Example</paragraph> 215<paragraph xml-lang="en-US" id="par_id3145355" role="paragraph" l10n="U" oldref="233"> 216<item type="input">=DECIMAL("17";10)</item> returns 17.</paragraph> 217<paragraph xml-lang="en-US" id="par_id3155622" role="paragraph" l10n="U" oldref="234"> 218<item type="input">=DECIMAL("FACE";16)</item> returns 64206.</paragraph> 219<paragraph xml-lang="en-US" id="par_id3151015" role="paragraph" l10n="U" oldref="235"> 220<item type="input">=DECIMAL("0101";2)</item> returns 5.</paragraph> 221</section> 222<section id="dollar"> 223<bookmark xml-lang="en-US" branch="index" id="bm_id3148402"> 224<bookmark_value>DOLLAR function</bookmark_value> 225</bookmark> 226<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_DM" id="bm_id3149532" localize="false"/> 227<paragraph xml-lang="en-US" id="hd_id3148402" role="heading" level="2" l10n="U" 228oldref="11">DOLLAR</paragraph> 229<paragraph xml-lang="en-US" id="par_id3153049" role="paragraph" l10n="U" oldref="12"><ahelp hid="HID_FUNC_DM">Converts a number to an amount in the currency format, rounded to a specified decimal place.</ahelp> In the <item type="literal">Value</item> field enter the number to be converted to currency. Optionally, you may enter the number of decimal places in the <item type="literal">Decimals</item> field. If no value is specified, all numbers in currency format will be displayed with two decimal places.</paragraph> 230<paragraph xml-lang="en-US" id="par_id3151280" role="paragraph" l10n="U" oldref="263">You set the currency format in your system settings.</paragraph> 231<paragraph xml-lang="en-US" id="hd_id3150569" role="heading" level="3" l10n="U" 232oldref="13">Syntax</paragraph> 233<paragraph xml-lang="en-US" id="par_id3154188" role="code" l10n="U" oldref="14">DOLLAR(Value; Decimals)</paragraph> 234<paragraph xml-lang="en-US" id="par_id3145299" role="paragraph" l10n="U" oldref="15"> 235<emph>Value</emph> is a number, a reference to a cell containing a number, or a formula which returns a number.</paragraph> 236<paragraph xml-lang="en-US" id="par_id3145629" role="paragraph" l10n="CHG" oldref="16"> 237<emph>Decimals</emph> is the optional number of decimal places.</paragraph> 238<paragraph xml-lang="en-US" id="hd_id3149030" role="heading" level="3" l10n="U" 239oldref="17">Example</paragraph> 240<paragraph xml-lang="en-US" id="par_id3153546" role="paragraph" l10n="U" oldref="18"> 241<item type="input">=DOLLAR(255)</item> returns $255.00.</paragraph> 242<paragraph xml-lang="en-US" id="par_id3154635" role="paragraph" l10n="U" oldref="19"> 243<item type="input">=DOLLAR(367.456;2)</item> returns $367.46. Use the decimal separator that corresponds to the <link href="text/shared/optionen/01140000.xhp" name="current locale setting">current locale setting</link>.</paragraph> 244</section> 245<section id="exact"> 246<bookmark xml-lang="en-US" branch="index" id="bm_id3150685"> 247<bookmark_value>EXACT function</bookmark_value> 248</bookmark> 249<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_IDENTISCH" id="bm_id3155081" localize="false"/> 250<paragraph xml-lang="en-US" id="hd_id3150685" role="heading" level="2" l10n="U" 251oldref="78">EXACT</paragraph> 252<paragraph xml-lang="en-US" id="par_id3158413" role="paragraph" l10n="U" oldref="79"><ahelp hid="HID_FUNC_IDENTISCH">Compares two text strings and returns TRUE if they are identical.</ahelp> This function is case-sensitive.</paragraph> 253<paragraph xml-lang="en-US" id="hd_id3152817" role="heading" level="3" l10n="U" 254oldref="80">Syntax</paragraph> 255<paragraph xml-lang="en-US" id="par_id3148594" role="code" l10n="U" oldref="81">EXACT("Text1"; "Text2")</paragraph> 256<paragraph xml-lang="en-US" id="par_id3153224" role="paragraph" l10n="U" oldref="82"> 257<emph>Text1</emph> refers to the first text to compare.</paragraph> 258<paragraph xml-lang="en-US" id="par_id3148637" role="paragraph" l10n="U" oldref="83"> 259<emph>Text2</emph> is the second text to compare.</paragraph> 260<paragraph xml-lang="en-US" id="hd_id3149777" role="heading" level="3" l10n="U" 261oldref="84">Example</paragraph> 262<paragraph xml-lang="en-US" id="par_id3156263" role="paragraph" l10n="U" oldref="85"> 263<item type="input">=EXACT("microsystems";"Microsystems")</item> returns FALSE.</paragraph> 264</section> 265<section id="find"> 266<bookmark xml-lang="en-US" branch="index" id="bm_id3152589"> 267<bookmark_value>FIND function</bookmark_value> 268</bookmark> 269<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FINDEN" id="bm_id3147482" localize="false"/> 270<paragraph xml-lang="en-US" id="hd_id3152589" role="heading" level="2" l10n="U" 271oldref="44">FIND</paragraph> 272<paragraph xml-lang="en-US" id="par_id3146149" role="paragraph" l10n="U" oldref="45"><ahelp hid="HID_FUNC_FINDEN">Looks for a string of text within another string.</ahelp> You can also define where to begin the search. The search term can be a number or any string of characters. The search is case-sensitive.</paragraph> 273<paragraph xml-lang="en-US" id="hd_id3083284" role="heading" level="3" l10n="U" 274oldref="46">Syntax</paragraph> 275<paragraph xml-lang="en-US" id="par_id3083452" role="code" l10n="U" oldref="47">FIND("FindText"; "Text"; Position)</paragraph> 276<paragraph xml-lang="en-US" id="par_id3150608" role="paragraph" l10n="U" oldref="48"> 277<emph>FindText</emph> refers to the text to be found.</paragraph> 278<paragraph xml-lang="en-US" id="par_id3152374" role="paragraph" l10n="U" oldref="49"> 279<emph>Text</emph> is the text where the search takes place.</paragraph> 280<paragraph xml-lang="en-US" id="par_id3152475" role="paragraph" l10n="U" oldref="50"> 281<emph>Position</emph> (optional) is the position in the text from which the search starts.</paragraph> 282<paragraph xml-lang="en-US" id="hd_id3154812" role="heading" level="3" l10n="U" 283oldref="51">Example</paragraph> 284<paragraph xml-lang="en-US" id="par_id3156375" role="paragraph" l10n="U" oldref="52"> 285<item type="input">=FIND(76;998877665544)</item> returns 6.</paragraph> 286</section> 287<section id="fixed"> 288<bookmark xml-lang="en-US" branch="index" id="bm_id3149268"> 289<bookmark_value>FIXED function</bookmark_value> 290</bookmark> 291<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_FEST" id="bm_id3149450" localize="false"/> 292<paragraph xml-lang="en-US" id="hd_id3149268" role="heading" level="2" l10n="U" 293oldref="34">FIXED</paragraph> 294<paragraph xml-lang="en-US" id="par_id3155833" role="paragraph" l10n="CHG" oldref="35"><ahelp hid="HID_FUNC_FEST">Returns a number as text with a specified number of decimal places and optional thousands separators.</ahelp></paragraph> 295<paragraph xml-lang="en-US" id="hd_id3152470" role="heading" level="3" l10n="U" 296oldref="36">Syntax</paragraph> 297<paragraph xml-lang="en-US" id="par_id3147567" role="code" l10n="U" oldref="37">FIXED(Number; Decimals; NoThousandsSeparators)</paragraph> 298<paragraph xml-lang="en-US" id="par_id3151272" role="paragraph" l10n="U" oldref="38"> 299<emph>Number</emph> refers to the number to be formatted.</paragraph> 300<paragraph xml-lang="en-US" id="par_id3156322" role="paragraph" l10n="U" oldref="39"> 301<emph>Decimals</emph> refers to the number of decimal places to be displayed.</paragraph> 302<paragraph xml-lang="en-US" id="par_id3150877" role="paragraph" l10n="U" oldref="40"> 303<emph>NoThousandsSeparators</emph> (optional) determines whether the thousands separator is used. If the parameter is a number not equal to 0, the thousands separator is suppressed. If the parameter is equal to 0 or if it is missing altogether, the thousands separators of your <link href="text/shared/optionen/01140000.xhp" name="current locale setting">current locale setting</link> are displayed.</paragraph> 304<paragraph xml-lang="en-US" id="hd_id3149040" role="heading" level="3" l10n="U" 305oldref="41">Example</paragraph> 306<paragraph xml-lang="en-US" id="par_id3145208" role="paragraph" l10n="CHG" oldref="42"> 307<item type="input">=FIXED(1234567.89;3)</item> returns 1,234,567.890 as a text string.</paragraph> 308<paragraph xml-lang="en-US" id="par_id5282143" role="paragraph" l10n="NEW"> 309<item type="input">=FIXED(1234567.89;3;1)</item> returns 1234567.890 as a text string.</paragraph> 310</section> 311<section id="jis"> 312<bookmark xml-lang="en-US" branch="index" id="bm_id7319864"> 313<bookmark_value>JIS function</bookmark_value> 314</bookmark> 315<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_JIS" id="bm_id3818475" localize="false"/> 316<paragraph xml-lang="en-US" id="hd_id3666188" role="heading" level="2" l10n="NEW">JIS</paragraph> 317<paragraph xml-lang="en-US" id="par_id964384" role="paragraph" l10n="NEW"><ahelp hid=".">The JIS function converts half-width to full-width ASCII and katakana characters. Returns a text string.</ahelp></paragraph> 318<paragraph xml-lang="en-US" id="par_id1551561" role="paragraph" l10n="NEW">See <link href="https://wiki.openoffice.org/wiki/Calc/Features/JIS_and_ASC_functions">JIS and ASC Spreadsheet Functions</link> for a conversion table.</paragraph> 319<paragraph xml-lang="en-US" id="hd_id2212897" role="heading" level="3" l10n="NEW">Syntax</paragraph> 320<paragraph xml-lang="en-US" id="par_id2504654" role="code" l10n="NEW">JIS("Text")</paragraph> 321<paragraph xml-lang="en-US" id="par_id5292519" role="paragraph" l10n="NEW"> 322<emph>Text</emph> is the text that contains characters to be converted.</paragraph> 323<paragraph xml-lang="en-US" id="par_id3984496" role="paragraph" l10n="NEW">See also ASC function.</paragraph> 324</section> 325<section id="left"> 326<bookmark xml-lang="en-US" branch="index" id="bm_id3147083"> 327<bookmark_value>LEFT function</bookmark_value> 328</bookmark> 329<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LINKS" id="bm_id3154645" localize="false"/> 330<paragraph xml-lang="en-US" id="hd_id3147083" role="heading" level="2" l10n="U" 331oldref="95">LEFT</paragraph> 332<paragraph xml-lang="en-US" id="par_id3153622" role="paragraph" l10n="CHG" oldref="96"><ahelp hid="HID_FUNC_LINKS">Returns the first character or characters of a text.</ahelp></paragraph> 333<paragraph xml-lang="en-US" id="hd_id3156116" role="heading" level="3" l10n="U" 334oldref="97">Syntax</paragraph> 335<paragraph xml-lang="en-US" id="par_id3146786" role="code" l10n="U" oldref="98">LEFT("Text"; Number)</paragraph> 336<paragraph xml-lang="en-US" id="par_id3147274" role="paragraph" l10n="U" oldref="99"> 337<emph>Text</emph> is the text where the initial partial words are to be determined.</paragraph> 338<paragraph xml-lang="en-US" id="par_id3153152" role="paragraph" l10n="U" oldref="100"> 339<emph>Number</emph> (optional) specifies the number of characters for the start text. If this parameter is not defined, one character is returned.</paragraph> 340<paragraph xml-lang="en-US" id="hd_id3150260" role="heading" level="3" l10n="U" 341oldref="101">Example</paragraph> 342<paragraph xml-lang="en-US" id="par_id3149141" role="paragraph" l10n="U" oldref="102"> 343<item type="input">=LEFT("output";3)</item> returns “out”.</paragraph> 344</section> 345<section id="len"> 346<bookmark xml-lang="en-US" branch="index" id="bm_id3156110"> 347<bookmark_value>LEN function</bookmark_value> 348</bookmark> 349<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_LAENGE" id="bm_id3154050" localize="false"/> 350<paragraph xml-lang="en-US" id="hd_id3156110" role="heading" level="2" l10n="U" 351oldref="104">LEN</paragraph> 352<paragraph xml-lang="en-US" id="par_id3150147" role="paragraph" l10n="U" oldref="105"><ahelp hid="HID_FUNC_LAENGE">Returns the length of a string including spaces.</ahelp></paragraph> 353<paragraph xml-lang="en-US" id="hd_id3155108" role="heading" level="3" l10n="U" 354oldref="106">Syntax</paragraph> 355<paragraph xml-lang="en-US" id="par_id3154063" role="code" l10n="U" oldref="107">LEN("Text")</paragraph> 356<paragraph xml-lang="en-US" id="par_id3146894" role="paragraph" l10n="U" oldref="108"> 357<emph>Text</emph> is the text whose length is to be determined.</paragraph> 358<paragraph xml-lang="en-US" id="hd_id3153884" role="heading" level="3" l10n="U" 359oldref="109">Example</paragraph> 360<paragraph xml-lang="en-US" id="par_id3156008" role="paragraph" l10n="U" oldref="110"> 361<item type="input">=LEN("Good Afternoon")</item> returns 14.</paragraph> 362<paragraph xml-lang="en-US" id="par_id3154300" role="paragraph" l10n="U" oldref="111"> 363<item type="input">=LEN(12345.67)</item> returns 8.</paragraph> 364</section> 365<section id="lower"> 366<bookmark xml-lang="en-US" branch="index" id="bm_id3153983"> 367<bookmark_value>LOWER function</bookmark_value> 368</bookmark> 369<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_KLEIN" id="bm_id3151173" localize="false"/> 370<paragraph xml-lang="en-US" id="hd_id3153983" role="heading" level="2" l10n="U" 371oldref="87">LOWER</paragraph> 372<paragraph xml-lang="en-US" id="par_id3152791" role="paragraph" l10n="U" oldref="88"><ahelp hid="HID_FUNC_KLEIN">Converts all uppercase letters in a text string to lowercase.</ahelp></paragraph> 373<paragraph xml-lang="en-US" id="hd_id3155902" role="heading" level="3" l10n="U" 374oldref="89">Syntax</paragraph> 375<paragraph xml-lang="en-US" id="par_id3150121" role="code" l10n="U" oldref="90">LOWER("Text")</paragraph> 376<paragraph xml-lang="en-US" id="par_id3153910" role="paragraph" l10n="U" oldref="91"> 377<emph>Text</emph> refers to the text to be converted.</paragraph> 378<paragraph xml-lang="en-US" id="hd_id3159343" role="heading" level="3" l10n="U" 379oldref="92">Example</paragraph> 380<paragraph xml-lang="en-US" id="par_id3155329" role="paragraph" l10n="U" oldref="93"> 381<item type="input">=LOWER("Sun")</item> returns sun.</paragraph> 382</section> 383<section id="mid"> 384<bookmark xml-lang="en-US" branch="index" id="bm_id3154589"> 385<bookmark_value>MID function</bookmark_value> 386</bookmark> 387<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TEIL" id="bm_id3155392" localize="false"/> 388<paragraph xml-lang="en-US" id="hd_id3154589" role="heading" level="2" l10n="U" 389oldref="148">MID</paragraph> 390<paragraph xml-lang="en-US" id="par_id3154938" role="paragraph" l10n="CHG" oldref="149"><ahelp hid="HID_FUNC_TEIL">Returns a text string of a text. The parameters specify the starting position and the number of characters.</ahelp></paragraph> 391<paragraph xml-lang="en-US" id="hd_id3148829" role="heading" level="3" l10n="U" 392oldref="150">Syntax</paragraph> 393<paragraph xml-lang="en-US" id="par_id3150526" role="code" l10n="U" oldref="151">MID("Text"; Start; Number)</paragraph> 394<paragraph xml-lang="en-US" id="par_id3148820" role="paragraph" l10n="U" oldref="152"> 395<emph>Text</emph> is the text containing the characters to extract.</paragraph> 396<paragraph xml-lang="en-US" id="par_id3150774" role="paragraph" l10n="U" oldref="153"> 397<emph>Start</emph> is the position of the first character in the text to extract.</paragraph> 398<paragraph xml-lang="en-US" id="par_id3153063" role="paragraph" l10n="U" oldref="154"> 399<emph>Number</emph> specifies the number of characters in the part of the text.</paragraph> 400<paragraph xml-lang="en-US" id="hd_id3150509" role="heading" level="3" l10n="U" 401oldref="155">Example</paragraph> 402<paragraph xml-lang="en-US" id="par_id3158407" role="paragraph" l10n="U" oldref="156"> 403<item type="input">=MID("office";2;2)</item> returns ff.</paragraph> 404</section> 405<section id="proper"> 406<bookmark xml-lang="en-US" branch="index" id="bm_id3159143"> 407<bookmark_value>PROPER function</bookmark_value> 408</bookmark> 409<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GROSS2" id="bm_id3154897" localize="false"/> 410<paragraph xml-lang="en-US" id="hd_id3159143" role="heading" level="2" l10n="U" 411oldref="70">PROPER</paragraph> 412<paragraph xml-lang="en-US" id="par_id3149768" role="paragraph" l10n="U" oldref="71"><ahelp hid="HID_FUNC_GROSS2">Capitalizes the first letter in all words of a text string.</ahelp></paragraph> 413<paragraph xml-lang="en-US" id="hd_id3153573" role="heading" level="3" l10n="U" 414oldref="72">Syntax</paragraph> 415<paragraph xml-lang="en-US" id="par_id3154260" role="code" l10n="U" oldref="73">PROPER("Text")</paragraph> 416<paragraph xml-lang="en-US" id="par_id3147509" role="paragraph" l10n="U" oldref="74"> 417<emph>Text</emph> refers to the text to be converted.</paragraph> 418<paragraph xml-lang="en-US" id="hd_id3147529" role="heading" level="3" l10n="U" 419oldref="75">Example</paragraph> 420<paragraph xml-lang="en-US" id="par_id3155364" role="paragraph" l10n="U" oldref="76"> 421<item type="input">=PROPER("open office")</item> returns Open Office.</paragraph> 422</section> 423<section id="replace"> 424<bookmark xml-lang="en-US" branch="index" id="bm_id3149171"> 425<bookmark_value>REPLACE function</bookmark_value> 426</bookmark> 427<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ERSETZEN" id="bm_id3149990" localize="false"/> 428<paragraph xml-lang="en-US" id="hd_id3149171" role="heading" level="2" l10n="U" 429oldref="22">REPLACE</paragraph> 430<paragraph xml-lang="en-US" id="par_id3148925" role="paragraph" l10n="U" oldref="23"><ahelp hid="HID_FUNC_ERSETZEN">Replaces part of a text string with a different text string.</ahelp> This function can be used to replace both characters and numbers (which are automatically converted to text). The result of the function is always displayed as text. If you intend to perform further calculations with a number which has been replaced by text, you will need to convert it back to a number using the <link href="text/scalc/01/04060110.xhp" name="VALUE">VALUE</link> function.</paragraph> 431<paragraph xml-lang="en-US" id="par_id3158426" role="paragraph" l10n="U" oldref="24">Any text containing numbers must be enclosed in quotation marks if you do not want it to be interpreted as a number and automatically converted to text.</paragraph> 432<paragraph xml-lang="en-US" id="hd_id3149159" role="heading" level="3" l10n="U" 433oldref="25">Syntax</paragraph> 434<paragraph xml-lang="en-US" id="par_id3147286" role="code" l10n="U" oldref="26">REPLACE("Text"; Position; Length; "NewText")</paragraph> 435<paragraph xml-lang="en-US" id="par_id3149797" role="paragraph" l10n="U" oldref="27"> 436<emph>Text</emph> refers to text of which a part will be replaced.</paragraph> 437<paragraph xml-lang="en-US" id="par_id3166451" role="paragraph" l10n="U" oldref="28"> 438<emph>Position</emph> refers to the position within the text where the replacement will begin.</paragraph> 439<paragraph xml-lang="en-US" id="par_id3156040" role="paragraph" l10n="U" oldref="29"> 440<emph>Length</emph> is the number of characters in <emph>Text</emph> to be replaced.</paragraph> 441<paragraph xml-lang="en-US" id="par_id3159188" role="paragraph" l10n="U" oldref="30"> 442<emph>NewText</emph> refers to the text which replaces <emph>Text</emph>.</paragraph> 443<paragraph xml-lang="en-US" id="hd_id3146958" role="heading" level="3" l10n="U" 444oldref="31">Example</paragraph> 445<paragraph xml-lang="en-US" id="par_id3154096" role="paragraph" l10n="U" oldref="32"> 446<item type="input">=REPLACE("1234567";1;1;"444")</item> returns "444234567". One character at position 1 is replaced by the complete <item type="literal">NewText</item>.</paragraph> 447</section> 448<section id="rept"> 449<bookmark xml-lang="en-US" branch="index" id="bm_id3149741"> 450<bookmark_value>REPT function</bookmark_value> 451</bookmark> 452<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WIEDERHOLEN" id="bm_id3155582" localize="false"/> 453<paragraph xml-lang="en-US" id="hd_id3149741" role="heading" level="2" l10n="U" 454oldref="193">REPT</paragraph> 455<paragraph xml-lang="en-US" id="par_id3153748" role="paragraph" l10n="U" oldref="194"><ahelp hid="HID_FUNC_WIEDERHOLEN">Repeats a character string by the given <emph>number</emph> of copies.</ahelp></paragraph> 456<paragraph xml-lang="en-US" id="hd_id3152884" role="heading" level="3" l10n="U" 457oldref="195">Syntax</paragraph> 458<paragraph xml-lang="en-US" id="par_id3150494" role="code" l10n="U" oldref="196">REPT("Text"; Number)</paragraph> 459<paragraph xml-lang="en-US" id="par_id3154859" role="paragraph" l10n="U" oldref="197"> 460<emph>Text</emph> is the text to be repeated.</paragraph> 461<paragraph xml-lang="en-US" id="par_id3150638" role="paragraph" l10n="U" oldref="198"> 462<emph>Number</emph> is the number of repetitions.</paragraph> 463<paragraph xml-lang="en-US" id="par_id3149922" role="paragraph" l10n="U" oldref="212">The result can be a maximum of 255 characters.</paragraph> 464<paragraph xml-lang="en-US" id="hd_id3156213" role="heading" level="3" l10n="U" 465oldref="199">Example</paragraph> 466<paragraph xml-lang="en-US" id="par_id3148626" role="paragraph" l10n="U" oldref="200"> 467<item type="input">=REPT("Good morning";2)</item> returns Good morningGood morning.</paragraph> 468</section> 469<section id="right"> 470<bookmark xml-lang="en-US" branch="index" id="bm_id3149805"> 471<bookmark_value>RIGHT function</bookmark_value> 472</bookmark> 473<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_RECHTS" id="bm_id3154602" localize="false"/> 474<paragraph xml-lang="en-US" id="hd_id3149805" role="heading" level="2" l10n="U" 475oldref="113">RIGHT</paragraph> 476<paragraph xml-lang="en-US" id="par_id3145375" role="paragraph" l10n="CHG" oldref="114"><ahelp hid="HID_FUNC_RECHTS">Returns the last character or characters of a text.</ahelp></paragraph> 477<paragraph xml-lang="en-US" id="hd_id3150837" role="heading" level="3" l10n="U" 478oldref="115">Syntax</paragraph> 479<paragraph xml-lang="en-US" id="par_id3154344" role="code" l10n="U" oldref="116">RIGHT("Text"; Number)</paragraph> 480<paragraph xml-lang="en-US" id="par_id3149426" role="paragraph" l10n="U" oldref="117"> 481<emph>Text</emph> is the text of which the right part is to be determined.</paragraph> 482<paragraph xml-lang="en-US" id="par_id3153350" role="paragraph" l10n="U" oldref="118"> 483<emph>Number</emph> (optional) is the number of characters from the right part of the text.</paragraph> 484<paragraph xml-lang="en-US" id="hd_id3148661" role="heading" level="3" l10n="U" 485oldref="119">Example</paragraph> 486<paragraph xml-lang="en-US" id="par_id3151132" role="paragraph" l10n="U" oldref="120"> 487<item type="input">=RIGHT("Sun";2)</item> returns un.</paragraph> 488</section> 489<section id="roman"> 490<bookmark xml-lang="en-US" branch="index" id="bm_id3153534"> 491<bookmark_value>ROMAN function</bookmark_value> 492</bookmark> 493<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_ROEMISCH" id="bm_id3144755" localize="false"/> 494<paragraph xml-lang="en-US" id="hd_id3153534" role="heading" level="2" l10n="U" 495oldref="248">ROMAN</paragraph> 496<paragraph xml-lang="en-US" id="par_id3151256" role="paragraph" l10n="U" oldref="249"><ahelp hid="HID_FUNC_ROEMISCH">Converts a number into a Roman numeral. The value range must be between 0 and 3999, the modes can be integers from 0 to 4.</ahelp></paragraph> 497<paragraph xml-lang="en-US" id="hd_id3149299" role="heading" level="3" l10n="U" 498oldref="250">Syntax</paragraph> 499<paragraph xml-lang="en-US" id="par_id3150593" role="code" l10n="U" oldref="251">ROMAN(Number; Mode)</paragraph> 500<paragraph xml-lang="en-US" id="par_id3156139" role="paragraph" l10n="U" oldref="252"> 501<emph>Number</emph> is the number that is to be converted into a Roman numeral.</paragraph> 502<paragraph xml-lang="en-US" id="par_id3153318" role="paragraph" l10n="U" oldref="253"> 503<emph>Mode</emph> (optional) indicates the degree of simplification. The higher the value, the greater is the simplification of the Roman number.</paragraph> 504<paragraph xml-lang="en-US" id="hd_id3145306" role="heading" level="3" l10n="U" 505oldref="254">Example</paragraph> 506<paragraph xml-lang="en-US" id="par_id3151371" role="paragraph" l10n="U" oldref="255"> 507<item type="input">=ROMAN(999)</item> returns CMXCIX</paragraph> 508<paragraph xml-lang="en-US" id="par_id3153938" role="paragraph" l10n="U" oldref="256"> 509<item type="input">=ROMAN(999;0)</item> returns CMXCIX</paragraph> 510<paragraph xml-lang="en-US" id="par_id3148412" role="paragraph" l10n="U" oldref="257"> 511<item type="input">=ROMAN (999;1)</item> returns LMVLIV</paragraph> 512<paragraph xml-lang="en-US" id="par_id3155421" role="paragraph" l10n="U" oldref="258"> 513<item type="input">=ROMAN(999;2)</item> returns XMIX</paragraph> 514<paragraph xml-lang="en-US" id="par_id3149235" role="paragraph" l10n="U" oldref="259"> 515<item type="input">=ROMAN(999;3)</item> returns VMIV</paragraph> 516<paragraph xml-lang="en-US" id="par_id3150624" role="paragraph" l10n="U" oldref="260"> 517<item type="input">=ROMAN(999;4)</item> returns IM</paragraph> 518</section> 519<section id="search"> 520<bookmark xml-lang="en-US" branch="index" id="bm_id3151005"> 521<bookmark_value>SEARCH function</bookmark_value> 522</bookmark> 523<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_SUCHEN" id="bm_id3149484" localize="false"/> 524<paragraph xml-lang="en-US" id="hd_id3151005" role="heading" level="2" l10n="U" 525oldref="122">SEARCH</paragraph> 526<paragraph xml-lang="en-US" id="par_id3148692" role="paragraph" l10n="U" oldref="123"><ahelp hid="HID_FUNC_SUCHEN">Returns the position of a text segment within a character string.</ahelp> You can set the start of the search as an option. The search text can be a number or any sequence of characters. The search is not case-sensitive.</paragraph> 527<embed href="text/shared/00/00000001.xhp#regulaer"/> 528<paragraph xml-lang="en-US" id="hd_id3152964" role="heading" level="3" l10n="U" 529oldref="124">Syntax</paragraph> 530<paragraph xml-lang="en-US" id="par_id3154671" role="code" l10n="U" oldref="125">SEARCH("FindText"; "Text"; Position)</paragraph> 531<paragraph xml-lang="en-US" id="par_id3146080" role="paragraph" l10n="U" oldref="126"> 532<emph>FindText</emph> is the text to be searched for.</paragraph> 533<paragraph xml-lang="en-US" id="par_id3154111" role="paragraph" l10n="U" oldref="127"> 534<emph>Text</emph> is the text where the search will take place.</paragraph> 535<paragraph xml-lang="en-US" id="par_id3149559" role="paragraph" l10n="U" oldref="128"> 536<emph>Position</emph> (optional) is the position in the text where the search is to start.</paragraph> 537<paragraph xml-lang="en-US" id="hd_id3147322" role="heading" level="3" l10n="U" 538oldref="129">Example</paragraph> 539<paragraph xml-lang="en-US" id="par_id3154564" role="paragraph" l10n="U" oldref="130"> 540<item type="input">=SEARCH(54;998877665544)</item> returns 10.</paragraph> 541</section> 542<section id="substitute"> 543<bookmark xml-lang="en-US" branch="index" id="bm_id3154830"> 544<bookmark_value>SUBSTITUTE function</bookmark_value> 545</bookmark> 546<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WECHSELN" id="bm_id3147090" localize="false"/> 547<paragraph xml-lang="en-US" id="hd_id3154830" role="heading" level="2" l10n="U" 548oldref="174">SUBSTITUTE</paragraph> 549<paragraph xml-lang="en-US" id="par_id3153698" role="paragraph" l10n="U" oldref="175"><ahelp hid="HID_FUNC_WECHSELN">Substitutes new text for old text in a string.</ahelp></paragraph> 550<paragraph xml-lang="en-US" id="hd_id3150994" role="heading" level="3" l10n="U" 551oldref="176">Syntax</paragraph> 552<paragraph xml-lang="en-US" id="par_id3147582" role="code" l10n="U" oldref="177">SUBSTITUTE("Text"; "SearchText"; "NewText"; Occurrence)</paragraph> 553<paragraph xml-lang="en-US" id="par_id3153675" role="paragraph" l10n="U" oldref="178"> 554<emph>Text</emph> is the text in which text segments are to be exchanged.</paragraph> 555<paragraph xml-lang="en-US" id="par_id3156155" role="paragraph" l10n="U" oldref="179"> 556<emph>SearchText</emph> is the text segment that is to be replaced (a number of times).</paragraph> 557<paragraph xml-lang="en-US" id="par_id3145779" role="paragraph" l10n="U" oldref="180"> 558<emph>NewText</emph> is the text that is to replace the text segment.</paragraph> 559<paragraph xml-lang="en-US" id="par_id3150348" role="paragraph" l10n="CHG" oldref="181"> 560<emph>Occurrence</emph> (optional) indicates which occurrence of the search text is to be replaced. If this parameter is missing the search text is replaced throughout.</paragraph> 561<paragraph xml-lang="en-US" id="hd_id3150946" role="heading" level="3" l10n="U" 562oldref="182">Example</paragraph> 563<paragraph xml-lang="en-US" id="par_id3150412" role="paragraph" l10n="U" oldref="183"> 564<item type="input">=SUBSTITUTE("123123123";"3";"abc")</item> returns 12abc12abc12abc.</paragraph> 565<paragraph xml-lang="en-US" id="par_id3154915" role="paragraph" l10n="U" oldref="238"> 566<item type="input">=SUBSTITUTE("123123123";"3";"abc";2)</item> returns 12312abc123.</paragraph> 567</section> 568<section id="t"> 569<bookmark xml-lang="en-US" branch="index" id="bm_id3148977"> 570<bookmark_value>T function</bookmark_value> 571</bookmark> 572<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_T" id="bm_id3156051" localize="false"/> 573<paragraph xml-lang="en-US" id="hd_id3148977" role="heading" level="2" l10n="U" 574oldref="140">T</paragraph> 575<paragraph xml-lang="en-US" id="par_id3154359" role="paragraph" l10n="CHG" oldref="141"><ahelp hid="HID_FUNC_T">This function returns the target text, or a blank text string if the target is not text.</ahelp></paragraph> 576<paragraph xml-lang="en-US" id="hd_id3155858" role="heading" level="3" l10n="U" 577oldref="142">Syntax</paragraph> 578<paragraph xml-lang="en-US" id="par_id3155871" role="code" l10n="U" oldref="143">T(Value)</paragraph> 579<paragraph xml-lang="en-US" id="par_id3154726" role="paragraph" l10n="CHG" oldref="144">If <emph>Value</emph> is a text string or refers to a text string, T returns that text string; otherwise it returns a blank text string.</paragraph> 580<paragraph xml-lang="en-US" id="hd_id3155544" role="heading" level="3" l10n="U" 581oldref="145">Example</paragraph> 582<paragraph xml-lang="en-US" id="par_id3151062" role="paragraph" l10n="CHG" oldref="146"> 583<item type="input">=T(12345)</item> returns an empty string.</paragraph> 584<paragraph xml-lang="en-US" id="par_id4650105" role="paragraph" l10n="NEW"> 585<item type="input">=T("12345")</item> returns the string 12345.</paragraph> 586</section> 587<section id="text"> 588<bookmark xml-lang="en-US" branch="index" id="bm_id3147132"> 589<bookmark_value>TEXT function</bookmark_value> 590</bookmark> 591<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_TEXT" id="bm_id3156426" localize="false"/> 592<paragraph xml-lang="en-US" id="hd_id3147132" role="heading" level="2" l10n="U" 593oldref="158">TEXT</paragraph> 594<paragraph xml-lang="en-US" id="par_id3147213" role="paragraph" l10n="U" oldref="159"><ahelp hid="HID_FUNC_TEXT">Converts a number into text according to a given format.</ahelp></paragraph> 595<paragraph xml-lang="en-US" id="hd_id3153129" role="heading" level="3" l10n="U" 596oldref="160">Syntax</paragraph> 597<paragraph xml-lang="en-US" id="par_id3147377" role="code" l10n="U" oldref="161">TEXT(Number; Format)</paragraph> 598<paragraph xml-lang="en-US" id="par_id3147389" role="paragraph" l10n="U" oldref="162"> 599<emph>Number</emph> is the numerical value to be converted.</paragraph> 600<paragraph xml-lang="en-US" id="par_id3156167" role="paragraph" l10n="U" oldref="163"> 601<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> 602<paragraph xml-lang="en-US" id="hd_id1243629" role="heading" level="3" l10n="NEW">Example</paragraph> 603<paragraph xml-lang="en-US" id="par_id9044770" role="paragraph" l10n="NEW"> 604<item type="input">=TEXT(12.34567;"###.##")</item> returns the text 12.35</paragraph> 605<paragraph xml-lang="en-US" id="par_id3674123" role="paragraph" l10n="NEW"> 606<item type="input">=TEXT(12.34567;"000.00")</item> returns the text 012.35</paragraph> 607</section> 608<section id="trim"> 609<bookmark xml-lang="en-US" branch="index" id="bm_id3151039"> 610<bookmark_value>TRIM function</bookmark_value> 611</bookmark> 612<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GLAETTEN" id="bm_id3150584" localize="false"/> 613<paragraph xml-lang="en-US" id="hd_id3151039" role="heading" level="2" l10n="U" 614oldref="54">TRIM</paragraph> 615<paragraph xml-lang="en-US" id="par_id3157888" role="paragraph" l10n="CHG" oldref="55"><ahelp hid="HID_FUNC_GLAETTEN">Removes spaces from a string, leaving only a single space character between words.</ahelp></paragraph> 616<paragraph xml-lang="en-US" id="hd_id3152913" role="heading" level="3" l10n="U" 617oldref="56">Syntax</paragraph> 618<paragraph xml-lang="en-US" id="par_id3151349" role="code" l10n="U" oldref="57">TRIM("Text")</paragraph> 619<paragraph xml-lang="en-US" id="par_id3151362" role="paragraph" l10n="CHG" oldref="58"> 620<emph>Text</emph> refers to text in which spaces are removed.</paragraph> 621<paragraph xml-lang="en-US" id="hd_id3146838" role="heading" level="3" l10n="U" 622oldref="59">Example</paragraph> 623<paragraph xml-lang="en-US" id="par_id3156074" role="paragraph" l10n="U" oldref="60"> 624<item type="input">=TRIM("hello")</item> returns hello.</paragraph> 625</section> 626<section id="unichar"> 627<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UNICHAR" id="bm_id0907200904004674" localize="false"/> 628<bookmark xml-lang="en-US" branch="index" id="bm_id0907200904030935"> 629<bookmark_value>UNICHAR function</bookmark_value> 630</bookmark> 631<paragraph xml-lang="en-US" id="hd_id0907200904022525" role="heading" level="2" l10n="NEW">UNICHAR</paragraph> 632<paragraph xml-lang="en-US" id="par_id0907200904022538" role="paragraph" l10n="NEW"><ahelp hid=".">Converts a code number into a Unicode character or letter.</ahelp></paragraph> 633<paragraph xml-lang="en-US" id="hd_id0907200904123753" role="heading" level="3" l10n="NEW">Syntax</paragraph> 634<paragraph xml-lang="en-US" id="par_id0907200904123753" role="paragraph" l10n="NEW">UNICHAR(number)</paragraph> 635<paragraph xml-lang="en-US" id="hd_id0907200904123720" role="heading" level="3" l10n="NEW">Example</paragraph> 636<paragraph xml-lang="en-US" id="par_id090720090412378" role="paragraph" l10n="NEW">=UNICHAR(169) returns the Copyright character <emph>©</emph>.</paragraph> 637</section> 638<section id="unicode"> 639<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_UNICODE" id="bm_id0907200904011330" localize="false"/> 640<bookmark xml-lang="en-US" branch="index" id="bm_id0907200904033543"> 641<bookmark_value>UNICODE function</bookmark_value> 642</bookmark> 643<paragraph xml-lang="en-US" id="hd_id0907200904022588" role="heading" level="2" l10n="NEW">UNICODE</paragraph> 644<paragraph xml-lang="en-US" id="par_id0907200904022594" role="paragraph" l10n="NEW"><ahelp hid=".">Returns the numeric code for the first Unicode character in a text string.</ahelp></paragraph> 645<paragraph xml-lang="en-US" id="hd_id0907200904123874" role="heading" level="3" l10n="NEW">Syntax</paragraph> 646<paragraph xml-lang="en-US" id="par_id0907200904123846" role="paragraph" l10n="NEW">UNICODE("Text")</paragraph> 647<paragraph xml-lang="en-US" id="hd_id0907200904123899" role="heading" level="3" l10n="NEW">Example</paragraph> 648<paragraph xml-lang="en-US" id="par_id0907200904123919" role="paragraph" l10n="NEW">=UNICODE("©") returns the Unicode number 169 for the Copyright character.</paragraph> 649</section> 650<section id="upper"> 651<bookmark xml-lang="en-US" branch="index" id="bm_id3145178"> 652<bookmark_value>UPPER function</bookmark_value> 653</bookmark> 654<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_GROSS" id="bm_id3145189" localize="false"/> 655<paragraph xml-lang="en-US" id="hd_id3145178" role="heading" level="2" l10n="U" 656oldref="62">UPPER</paragraph> 657<paragraph xml-lang="en-US" id="par_id3162905" role="paragraph" l10n="U" oldref="63"><ahelp hid="HID_FUNC_GROSS">Converts the string specified in the <emph>text</emph> field to uppercase.</ahelp></paragraph> 658<paragraph xml-lang="en-US" id="hd_id3148526" role="heading" level="3" l10n="U" 659oldref="64">Syntax</paragraph> 660<paragraph xml-lang="en-US" id="par_id3148539" role="code" l10n="U" oldref="65">UPPER("Text")</paragraph> 661<paragraph xml-lang="en-US" id="par_id3148496" role="paragraph" l10n="U" oldref="66"> 662<emph>Text</emph> refers to the lower case letters you want to convert to upper case.</paragraph> 663<paragraph xml-lang="en-US" id="hd_id3148516" role="heading" level="3" l10n="U" 664oldref="67">Example</paragraph> 665<paragraph xml-lang="en-US" id="par_id3146757" role="paragraph" l10n="U" oldref="68"> 666<item type="input">=UPPER("Good Morning")</item> returns GOOD MORNING.</paragraph> 667</section> 668<section id="value"> 669<bookmark xml-lang="en-US" branch="index" id="bm_id3150802"> 670<bookmark_value>VALUE function</bookmark_value> 671</bookmark> 672<bookmark xml-lang="en-US" branch="hid/SC_HID_FUNC_WERT" id="bm_id3150814" localize="false"/> 673<paragraph xml-lang="en-US" id="hd_id3150802" role="heading" level="2" l10n="U" 674oldref="185">VALUE</paragraph> 675<paragraph xml-lang="en-US" id="par_id3152551" role="paragraph" l10n="U" oldref="186"><ahelp hid="HID_FUNC_WERT">Converts a text string into a number.</ahelp></paragraph> 676<paragraph xml-lang="en-US" id="hd_id3152568" role="heading" level="3" l10n="U" 677oldref="187">Syntax</paragraph> 678<paragraph xml-lang="en-US" id="par_id3153638" role="code" l10n="U" oldref="188">VALUE("Text")</paragraph> 679<paragraph xml-lang="en-US" id="par_id3153651" role="paragraph" l10n="U" oldref="189"> 680<emph>Text</emph> is the text to be converted to a number.</paragraph> 681<paragraph xml-lang="en-US" id="hd_id3144719" role="heading" level="3" l10n="U" 682oldref="190">Example</paragraph> 683<paragraph xml-lang="en-US" id="par_id3144733" role="paragraph" l10n="U" oldref="191"> 684<item type="input">=VALUE("4321")</item> returns 4321.</paragraph> 685</section> 686</sort> 687<section id="relatedtopics"> 688<embed href="text/scalc/01/04060100.xhp#drking"/> 689</section> 690</body> 691</helpdocument> 692