summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLászló Németh <nemeth@numbertext.org>2018-07-02 16:05:27 +0200
committerChristian Lohmaier <lohmaier+LibreOffice@googlemail.com>2018-07-03 17:55:59 +0200
commitd37a847e3ea2560371f4b97d6c52122137c108eb (patch)
tree60069f0c015fa00b6dc1560b6b6ec9442a6bd555
parent5c61398c042d7a8c875d1cd8d7455325f79ff547 (diff)
tdf#115007 add NatNum12 help and ask translators for extending
language support in number and date formatting by extending the newly integrated libnumbertext (http://www.numbertext.org) and default date formats of LibreOffice: Translators: (1) please, modify the list of NatNum12 functions according to libnumbertext language support of your language. Other arguments could be ordinal-feminine, ordinal-masculine, ordinal-neuter, formal, article, etc. To show the available NatNum12 arguments of your language, open https://numbertext.github.io/#testimonials in a browser, and select "Functions (help)" in the pop-up menu. As you can see in the examples for NatNum12 date formats and in the extended en_US.xml and hu_HU.xml locale data files, it's possible to support also special number formatting needs of your language, including spelling out numbers, money amounts and dates with automatic selection of prepositions [like Catalan "de" or "d'" before month names], articles [Hungarian "a" or "az"] and suffixes [in Hungarian or likely Estonian, Finnish, Turkish etc. languages: "in", "from", "to" etc. suffixes of day and month names], check http://numbertext.org or write your questions on LibreOffice l10n mailing list. Reviewed-on: https://gerrit.libreoffice.org/55708 Tested-by: Jenkins Reviewed-by: László Németh <nemeth@numbertext.org> Conflicts: source/text/shared/01/05020301.xhp Change-Id: I330a674f2832fba90ad0903d3e428f3d1fae7a98 Reviewed-on: https://gerrit.libreoffice.org/56817 Tested-by: Jenkins Reviewed-by: László Németh <nemeth@numbertext.org> Reviewed-by: Christian Lohmaier <lohmaier+LibreOffice@googlemail.com>
-rw-r--r--source/text/shared/01/05020301.xhp98
1 files changed, 96 insertions, 2 deletions
diff --git a/source/text/shared/01/05020301.xhp b/source/text/shared/01/05020301.xhp
index 5c965c8eb..a9cf0f987 100644
--- a/source/text/shared/01/05020301.xhp
+++ b/source/text/shared/01/05020301.xhp
@@ -991,6 +991,7 @@
<paragraph id="hd_id231020161309289931" role="heading" level="2" xml-lang="en-US">NatNum modifiers</paragraph>
<paragraph id="par_id3149998" role="paragraph" xml-lang="en-US">To display numbers using native number characters, use a [NatNum1], [NatNum2], ... [NatNum11] modifier at the beginning of a number format codes.</paragraph>
+<paragraph id="par_id3158313" role="paragraph" xml-lang="en-US">To spell out numbers in various number, currency and date formats, use a [NatNum12] modifier with the chosen arguments at the beginning of a number format code. See <link href="text/shared/01/05020301.xhp#NatNum12">NatNum12</link> section below.</paragraph>
<paragraph id="par_id3154600" role="paragraph" xml-lang="en-US">The [NatNum1] modifier always uses a one to one character mapping to convert numbers to a string that matches the native number format code of the corresponding locale. The other modifiers produce different results if they are used with different locales. A locale can be the language and the territory for which the format code is defined, or a modifier such as [$-yyy] that follows the native number modifier. In this case, yyy is the hexadecimal MS-LCID that is also used in currency format codes. For example, to display a number using Japanese short Kanji characters in an English US locale, use the following number format code:</paragraph>
<paragraph id="par_id3152546" role="example" localize="false" xml-lang="en-US">[NatNum1][$-411]0</paragraph>
<paragraph id="par_id3147269" role="paragraph" xml-lang="en-US">In the following list, the Microsoft Excel [DBNumX] modifier that corresponds to <item type="productname">%PRODUCTNAME</item> [NatNum] modifier is shown. If you want, you can use a [DBNumX] modifier instead of [NatNum] modifier for your locale. Whenever possible, <item type="productname">%PRODUCTNAME</item> internally maps [DBNumX] modifiers to [NatNumN] modifiers.</paragraph>
@@ -2458,8 +2459,101 @@
</tablecell>
</tablerow>
</table>
+</section>
+
+<section id="NatNum12">
+
+<paragraph id="hd_id231201610928993199" role="heading" level="2" xml-lang="en-US">NatNum12 modifier</paragraph>
+
+<paragraph id="par_id3158314" role="paragraph" xml-lang="en-US">To spell out numbers in various number, currency and date formats, use a [NatNum12] modifier with the chosen arguments at the beginning of a number format code.</paragraph>
+
+<paragraph id="par_id130820161735318343" role="paragraph" xml-lang="en-US">Common NatNum12 formatting examples</paragraph>
+
+<table id="Tabela101">
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id130820131011365891" role="tablehead" xml-lang="en-US">Formatting code</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id13082016201136632" role="tablehead" xml-lang="en-US">Explanation</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id130820161733145583" role="tablecontent" xml-lang="en-US">[NatNum12]</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id130820161733112114" role="tablecontent" xml-lang="en-US">Spell out as cardinal number: 1 → one</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id1308201617533145585" role="tablecontent" xml-lang="en-US">[NatNum12 ordinal]</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id13082016107533112116" role="tablecontent" xml-lang="en-US">Spell out as ordinal number: 1 → first</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id1308201616533145587" role="tablecontent" xml-lang="en-US">[NatNum12 ordinal-number]</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id13082016107533112118" role="tablecontent" xml-lang="en-US">Spell out as ordinal indicator: 1 → 1st</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id1308201796533145589" role="tablecontent" xml-lang="en-US">[NatNum12 capitalize]</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id130820161715331121110" role="tablecontent" xml-lang="en-US">Spell out with capitalization, as cardinal number: 1 → One</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id1308201617965331455812" role="tablecontent" xml-lang="en-US">[NatNum12 upper ordinal]</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id130826171075331121112" role="tablecontent" xml-lang="en-US">Spell out in upper case, as ordinal number: 1 → FIRST</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id1308201617965331455813" role="tablecontent" xml-lang="en-US">[NatNum12 title]</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id13082016075331121114" role="tablecontent" xml-lang="en-US">Spell out in title case, as cardinal number: 101 → Hundred One</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id1308201617965331455814" role="tablecontent" xml-lang="en-US">[NatNum12 USD]</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id13082016075331121115" role="tablecontent" xml-lang="en-US">Spell out as a money amount of a given currency specified by 3-letter ISO code: 1 → one U.S. dollar</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id1308201617965331455816" role="tablecontent" xml-lang="en-US">[NatNum12 D=ordinal-number]D" of "MMMM</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id13082016075331121117" role="tablecontent" xml-lang="en-US">Spell out as a date in format "1st of May"</paragraph>
+ </tablecell>
+ </tablerow>
+ <tablerow>
+ <tablecell>
+ <paragraph id="par_id1308201617965331455818" role="tablecontent" xml-lang="en-US">[NatNum12 YYYY=title year,D=capitalize ordinal]D" of "MMMM, YYYY</paragraph>
+ </tablecell>
+ <tablecell>
+ <paragraph id="par_id13082016075331121119" role="tablecontent" xml-lang="en-US">Spell out as a date in format "First of May, Nineteen Ninety-nine"</paragraph>
+ </tablecell>
+ </tablerow>
+</table>
+
+<paragraph id="par_id3158316" role="paragraph" xml-lang="en-US">Other possible arguments: "money" before 3-letter currency codes, for example [NatNum12 capitalize money USD]0.00 will format number "1.99" as "One and 99/100 U.S. Dollars".</paragraph>
</section>
</body>
-
-</helpdocument> \ No newline at end of file
+</helpdocument>