Skip to content

Commit

Permalink
docs: example for number system category
Browse files Browse the repository at this point in the history
  • Loading branch information
richardschneider committed Jan 13, 2019
1 parent 101ec57 commit b7c32bd
Show file tree
Hide file tree
Showing 4 changed files with 303 additions and 273 deletions.
1 change: 1 addition & 0 deletions doc/Documentation.csproj
Original file line number Diff line number Diff line change
Expand Up @@ -85,6 +85,7 @@
<Content Include="articles\numbering-systems\index.md" />
<Content Include="articles\numbering-systems\numeric.md" />
<Content Include="articles\numbering-systems\algorithmic.md" />
<Content Include="articles\numbering-systems\category.md" />
<None Include="Web.Debug.config">
<DependentUpon>Web.config</DependentUpon>
</None>
Expand Down
25 changes: 21 additions & 4 deletions doc/articles/numbering-systems/category.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,27 @@
# Categories

Instead of using a specific numbering system name, a category name is
used to request a locale specific number system for the category.
Instead of using a specific numbering system name, a category name can be
used to request a locale specific numbering system for the category.

| Category | Description |
| -------- | ----------- |
| native | Requests the numbering system used for the native digits, usually defined as a part of the script used to write the language. |
| financial | Requests the numbering system used for financial quantities. This is often used for ideographic languages such as Chinese, where it would be easy to alter an amount represented in the default numbering system simply by adding additional strokes. If the financial numbering system is not specified, applications should use the default numbering system as a fallback. |
| traditional | Requests the traditional numerals for a locale. If the traditional numbering system is not defined, applications should use the native numbering system as a fallback. |
| finance | Requests the numbering system used for financial quantities. This is often used for ideographic languages such as Chinese, where it would be easy to alter an amount represented in the default numbering system simply by adding additional strokes. |
| traditio | Requests the traditional numerals for a locale. If the traditional numbering system is not defined, applications should use the native numbering system as a fallback. |

If the locale does not define a numbering system for the category, then the default numbering system is used as a fallback.

## Example

The following table shows the number `123` represented in various locales.

| Locale | Formatted |
| ------ | --------- |
| en | 123 |
| en-u-nu-native | 123 |
| en-u-nu-traditio | 123 |
| en-u-nu-finance | 123 |
| zh-TW | 123 |
| zh-TW-u-nu-native | 一二三 |
| zh-TW-u-nu-traditio | 一百二十三 |
| zh-TW-u-nu-finance | 壹佰貳拾參 |
Loading

0 comments on commit b7c32bd

Please sign in to comment.