merge the formfield patch from ooo-build
[ooovba.git] / helpcontent2 / source / text / scalc / guide / format_value_userdef.xhp
blob659656e40cdfab657c3d85058d91318643e1f8fa
1 <?xml version="1.0" encoding="UTF-8"?>
5 <!--
6 ***********************************************************************
8 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
9 *
10 * Copyright 2008 by Sun Microsystems, Inc.
12 * OpenOffice.org - a multi-platform office productivity suite
14 * $RCSfile: format_value_userdef.xhp,v $
15 * $Revision: 1.7 $
17 * This file is part of OpenOffice.org.
19 * OpenOffice.org is free software: you can redistribute it and/or modify
20 * it under the terms of the GNU Lesser General Public License version 3
21 * only, as published by the Free Software Foundation.
23 * OpenOffice.org is distributed in the hope that it will be useful,
24 * but WITHOUT ANY WARRANTY; without even the implied warranty of
25 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
26 * GNU Lesser General Public License version 3 for more details
27 * (a copy is included in the LICENSE file that accompanied this code).
29 * You should have received a copy of the GNU Lesser General Public License
30 * version 3 along with OpenOffice.org. If not, see
31 * <http://www.openoffice.org/license.html>
32 * for a copy of the LGPLv3 License.
34 ************************************************************************
35 -->
38 <helpdocument version="1.0">
39 <meta>
40 <topic id="textscalcguideformat_value_userdefxml" indexer="include" status="PUBLISH">
41 <title xml-lang="en-US" id="tit">User-defined Number Formats</title>
42 <filename>/text/scalc/guide/format_value_userdef.xhp</filename>
43 </topic>
44 </meta>
45 <body>
49 <bookmark xml-lang="en-US" branch="index" id="bm_id3143268"><bookmark_value>numbers; user-defined formatting in tables</bookmark_value>
50 <bookmark_value>formatting; user-defined numbers</bookmark_value>
51 <bookmark_value>number formats; millions</bookmark_value>
52 <bookmark_value>format codes; user-defined number formats</bookmark_value>
53 </bookmark>
54 <comment>mw copied "format codes;" from shared/01/05020300.xhp</comment>
55 <paragraph xml-lang="en-US" id="hd_id3143268" role="heading" level="1" l10n="U" 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>
56 </variable></paragraph>
57 <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>
58 <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>
59 <list type="ordered">
60 <listitem>
61 <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>
62 </listitem>
63 <listitem>
64 <paragraph xml-lang="en-US" id="par_id3149664" role="listitem" l10n="U" oldref="4">Choose <emph>Format - Cells - Numbers</emph>.</paragraph>
65 </listitem>
66 <listitem>
67 <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>
68 </listitem>
69 <listitem>
70 <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>
71 <paragraph xml-lang="en-US" id="par_id3152596" role="code" l10n="U" oldref="7">0.0,, "Million"</paragraph>
72 </listitem>
73 <listitem>
74 <paragraph xml-lang="en-US" id="par_id3144764" role="listitem" l10n="U" oldref="8">Click OK.</paragraph>
75 </listitem>
76 </list>
77 <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>
78 <table id="tbl_id3153157">
81 <tablerow>
82 <tablecell>
83 <paragraph xml-lang="en-US" id="par_id3146971" role="tablehead" l10n="U" oldref="10">Number</paragraph>
84 </tablecell>
85 <tablecell>
86 <paragraph xml-lang="en-US" id="par_id3154757" role="tablehead" l10n="U" oldref="11">.#,, "Million"</paragraph>
87 </tablecell>
88 <tablecell>
89 <paragraph xml-lang="en-US" id="par_id3147338" role="tablehead" l10n="U" oldref="12">0.0,, "Million"</paragraph>
90 </tablecell>
91 <tablecell>
92 <paragraph xml-lang="en-US" id="par_id3146920" role="tablehead" l10n="U" oldref="13">#,, "Million"</paragraph>
93 </tablecell>
94 </tablerow>
95 <tablerow>
96 <tablecell>
97 <paragraph xml-lang="en-US" id="par_id3147344" role="paragraph" l10n="U" oldref="14">10200000</paragraph>
98 </tablecell>
99 <tablecell>
100 <paragraph xml-lang="en-US" id="par_id3147003" role="paragraph" l10n="U" oldref="15">10.2 Million</paragraph>
101 </tablecell>
102 <tablecell>
103 <paragraph xml-lang="en-US" id="par_id3166426" role="paragraph" l10n="U" oldref="16">10.2 Million</paragraph>
104 </tablecell>
105 <tablecell>
106 <paragraph xml-lang="en-US" id="par_id3155113" role="paragraph" l10n="U" oldref="17">10 Million</paragraph>
107 </tablecell>
108 </tablerow>
109 <tablerow>
110 <tablecell>
111 <paragraph xml-lang="en-US" id="par_id3150369" role="paragraph" l10n="U" oldref="18">500000</paragraph>
112 </tablecell>
113 <tablecell>
114 <paragraph xml-lang="en-US" id="par_id3145585" role="paragraph" l10n="U" oldref="19">.5 Million</paragraph>
115 </tablecell>
116 <tablecell>
117 <paragraph xml-lang="en-US" id="par_id3154486" role="paragraph" l10n="U" oldref="20">0.5 Million</paragraph>
118 </tablecell>
119 <tablecell>
120 <paragraph xml-lang="en-US" id="par_id3146114" role="paragraph" l10n="U" oldref="21">1 Million</paragraph>
121 </tablecell>
122 </tablerow>
123 <tablerow>
124 <tablecell>
125 <paragraph xml-lang="en-US" id="par_id3155810" role="paragraph" l10n="U" oldref="22">100000000</paragraph>
126 </tablecell>
127 <tablecell>
128 <paragraph xml-lang="en-US" id="par_id3153818" role="paragraph" l10n="U" oldref="23">100. Million</paragraph>
129 </tablecell>
130 <tablecell>
131 <paragraph xml-lang="en-US" id="par_id3151241" role="paragraph" l10n="U" oldref="24">100.0 Million</paragraph>
132 </tablecell>
133 <tablecell>
134 <paragraph xml-lang="en-US" id="par_id3144771" role="paragraph" l10n="U" oldref="25">100 Million</paragraph>
135 </tablecell>
136 </tablerow>
137 </table>
138 <section id="relatedtopics">
140 <embed href="text/scalc/guide/format_value.xhp#format_value"/>
141 <embed href="text/scalc/guide/currency_format.xhp#currency_format"/>
142 <embed href="text/scalc/guide/text_numbers.xhp#text_numbers"/>
143 <embed href="text/shared/01/05020301.xhp#zahlenformatcodes"/>
145 </section>
146 </body>
147 </helpdocument>