1<?xml version="1.0" encoding="UTF-8"?>
2<helpdocument version="1.0">
3
4<!--***********************************************************
5 *
6 * Licensed to the Apache Software Foundation (ASF) under one
7 * or more contributor license agreements.  See the NOTICE file
8 * distributed with this work for additional information
9 * regarding copyright ownership.  The ASF licenses this file
10 * to you under the Apache License, Version 2.0 (the
11 * "License"); you may not use this file except in compliance
12 * with the License.  You may obtain a copy of the License at
13 *
14 *   http://www.apache.org/licenses/LICENSE-2.0
15 *
16 * Unless required by applicable law or agreed to in writing,
17 * software distributed under the License is distributed on an
18 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
19 * KIND, either express or implied.  See the License for the
20 * specific language governing permissions and limitations
21 * under the License.
22 *
23 ***********************************************************-->
24
25
26
27
28<meta>
29      <topic id="textscalcguideformat_value_userdefxml" indexer="include" status="PUBLISH">
30         <title xml-lang="en-US" id="tit">User-defined Number Formats</title>
31         <filename>/text/scalc/guide/format_value_userdef.xhp</filename>
32      </topic>
33   </meta>
34   <body>
35<bookmark xml-lang="en-US" branch="index" id="bm_id3143268"><bookmark_value>numbers;user-defined formatting</bookmark_value>
36      <bookmark_value>formatting; user-defined numbers</bookmark_value>
37      <bookmark_value>number formats; millions</bookmark_value>
38      <bookmark_value>format codes; user-defined number formats</bookmark_value>
39</bookmark><comment>mw changed "numbers;"</comment>
40<paragraph xml-lang="en-US" id="hd_id3143268" role="heading" level="1" l10n="U"
41                 oldref="26"><variable id="format_value_userdef"><link href="text/scalc/guide/format_value_userdef.xhp" name="User-defined Number Formats">User-defined Number Formats</link>
42</variable></paragraph>
43      <paragraph xml-lang="en-US" id="par_id3150400" role="paragraph" l10n="U" oldref="1">You can define your own number formats to display numbers in <item type="productname">%PRODUCTNAME</item> Calc.</paragraph>
44      <paragraph xml-lang="en-US" id="par_id3150767" role="paragraph" l10n="U" oldref="2">As an example, to display the number 10,200,000 as 10.2 Million:</paragraph>
45      <list type="ordered">
46         <listitem>
47            <paragraph xml-lang="en-US" id="par_id3150868" role="listitem" l10n="U" oldref="3">Select the cells to which you want to apply a new, user-defined format.</paragraph>
48         </listitem>
49         <listitem>
50            <paragraph xml-lang="en-US" id="par_id3149664" role="listitem" l10n="U" oldref="4">Choose <emph>Format - Cells - Numbers</emph>.</paragraph>
51         </listitem>
52         <listitem>
53            <paragraph xml-lang="en-US" id="par_id3149260" role="listitem" l10n="U" oldref="5">In the <emph>Categories</emph> list box select "User-defined".</paragraph>
54         </listitem>
55         <listitem>
56            <paragraph xml-lang="en-US" id="par_id3148646" role="listitem" l10n="U" oldref="6">In the <emph>Format code</emph> text box enter the following code:</paragraph>
57            <paragraph xml-lang="en-US" id="par_id3152596" role="code" l10n="U" oldref="7">0.0,, "Million"</paragraph>
58         </listitem>
59         <listitem>
60            <paragraph xml-lang="en-US" id="par_id3144764" role="listitem" l10n="U" oldref="8">Click OK.</paragraph>
61         </listitem>
62      </list>
63      <paragraph xml-lang="en-US" id="par_id3155417" role="paragraph" l10n="U" oldref="9">The following table shows the effects of rounding, thousands delimiters (,), decimal delimiters (.) and the placeholders # and 0.</paragraph>
64      <table id="tbl_id3153157">
65         <tablerow>
66            <tablecell>
67               <paragraph xml-lang="en-US" id="par_id3146971" role="tablehead" l10n="U" oldref="10">Number</paragraph>
68            </tablecell>
69            <tablecell>
70               <paragraph xml-lang="en-US" id="par_id3154757" role="tablehead" l10n="U" oldref="11">.#,, "Million"</paragraph>
71            </tablecell>
72            <tablecell>
73               <paragraph xml-lang="en-US" id="par_id3147338" role="tablehead" l10n="U" oldref="12">0.0,, "Million"</paragraph>
74            </tablecell>
75            <tablecell>
76               <paragraph xml-lang="en-US" id="par_id3146920" role="tablehead" l10n="U" oldref="13">#,, "Million"</paragraph>
77            </tablecell>
78         </tablerow>
79         <tablerow>
80            <tablecell>
81               <paragraph xml-lang="en-US" id="par_id3147344" role="paragraph" l10n="U" oldref="14">10200000</paragraph>
82            </tablecell>
83            <tablecell>
84               <paragraph xml-lang="en-US" id="par_id3147003" role="paragraph" l10n="U" oldref="15">10.2 Million</paragraph>
85            </tablecell>
86            <tablecell>
87               <paragraph xml-lang="en-US" id="par_id3166426" role="paragraph" l10n="U" oldref="16">10.2 Million</paragraph>
88            </tablecell>
89            <tablecell>
90               <paragraph xml-lang="en-US" id="par_id3155113" role="paragraph" l10n="U" oldref="17">10 Million</paragraph>
91            </tablecell>
92         </tablerow>
93         <tablerow>
94            <tablecell>
95               <paragraph xml-lang="en-US" id="par_id3150369" role="paragraph" l10n="U" oldref="18">500000</paragraph>
96            </tablecell>
97            <tablecell>
98               <paragraph xml-lang="en-US" id="par_id3145585" role="paragraph" l10n="U" oldref="19">.5 Million</paragraph>
99            </tablecell>
100            <tablecell>
101               <paragraph xml-lang="en-US" id="par_id3154486" role="paragraph" l10n="U" oldref="20">0.5 Million</paragraph>
102            </tablecell>
103            <tablecell>
104               <paragraph xml-lang="en-US" id="par_id3146114" role="paragraph" l10n="U" oldref="21">1 Million</paragraph>
105            </tablecell>
106         </tablerow>
107         <tablerow>
108            <tablecell>
109               <paragraph xml-lang="en-US" id="par_id3155810" role="paragraph" l10n="U" oldref="22">100000000</paragraph>
110            </tablecell>
111            <tablecell>
112               <paragraph xml-lang="en-US" id="par_id3153818" role="paragraph" l10n="U" oldref="23">100. Million</paragraph>
113            </tablecell>
114            <tablecell>
115               <paragraph xml-lang="en-US" id="par_id3151241" role="paragraph" l10n="U" oldref="24">100.0 Million</paragraph>
116            </tablecell>
117            <tablecell>
118               <paragraph xml-lang="en-US" id="par_id3144771" role="paragraph" l10n="U" oldref="25">100 Million</paragraph>
119            </tablecell>
120         </tablerow>
121      </table>
122
123      <section id="relatedtopics">
124         <embed href="text/scalc/guide/format_value.xhp#format_value"/>
125         <embed href="text/scalc/guide/currency_format.xhp#currency_format"/>
126         <embed href="text/scalc/guide/text_numbers.xhp#text_numbers"/>
127         <embed href="text/shared/01/05020301.xhp#zahlenformatcodes"/>
128      </section>
129   </body>
130</helpdocument>