NumberSystem (Time4J-Core 4.33 API)

java.lang.Object
- java.lang.Enum<NumberSystem>
- - net.time4j.format.NumberSystem

All Implemented Interfaces:

Serializable, Comparable<NumberSystem>
```
public enum NumberSystem
extends Enum<NumberSystem>
```
Defines the number system.

Attention: This enum can only handle non-negative integers.

Since:

3.11/4.8

Author:

Meno Hochschild

Enum Constant Summary

Enum Constants
Enum Constant and Description
`ARABIC` Arabic numbers with the decimal digits 0-9 (default setting).
`ARABIC_INDIC` Arabic-Indic numbers (used in many Arabic countries).
`ARABIC_INDIC_EXT` Extended Arabic-Indic numbers (used for example in Iran).
`BENGALI` The Bengali digits used in parts of India.
`DEVANAGARI` The Devanagari digits used in parts of India.
`DOZENAL` Dozenal numbers describe a 12-based positional numbering system.
`ETHIOPIC` Ethiopic numerals (always positive).
`GUJARATI` The Gujarati digits used in parts of India.
`JAPANESE` The Japanese numbers limited to the range 1-9999.
`KHMER` Traditional number system used by Khmer people in Cambodia.
`MYANMAR` The number system used in Myanmar (Burma).
`ORYA` The Orya digits used in parts of India.
`ROMAN` Roman numerals in range 1-3999.
`TELUGU` The Telugu digits used in parts of India.
`THAI` The Thai digits used in Thailand (Siam).

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`contains(char digit)` Does this number system contains given digit char?
`String`	`getCode()` Obtains an identifier which can be used together with the unicode extension "nu" in `Locale`-parameters.
`String`	`getDigits()` Defines all digit characters from the smallest to the largest one.
`boolean`	`isDecimal()` Does this number system describe a decimal system where the digits can be mapped to the range 0-9?
`int`	`toInteger(String numeral)` Converts given text numeral to an integer in smart mode.
`int`	`toInteger(String numeral, Leniency leniency)` Converts given text numeral to an integer.
`String`	`toNumeral(int number)` Converts given integer to a text numeral.
`int`	`toNumeral(int number, Appendable buffer)` Converts given integer to a text numeral which will then be written into buffer.
`static NumberSystem`	`valueOf(String name)` Returns the enum constant of this type with the specified name.
`static NumberSystem[]`	`values()` Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum
compareTo, equals, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Enum Constant Detail
  - ARABIC
```
public static final NumberSystem ARABIC
```
    Arabic numbers with the decimal digits 0-9 (default setting).
    This number system is used worldwide. Direct conversion of negative integers is not supported. Code: "latn" as inconsistently defined in CLDR (has nothing to do with Latin).
  - ARABIC_INDIC
```
public static final NumberSystem ARABIC_INDIC
```
    Arabic-Indic numbers (used in many Arabic countries).
    Note: Must not be negative. Code: "arab" as defined shortened in CLDR.
    
    Since:
    
    3.23/4.19
  - ARABIC_INDIC_EXT
```
public static final NumberSystem ARABIC_INDIC_EXT
```
    Extended Arabic-Indic numbers (used for example in Iran).
    Note: Must not be negative. Code: "arabext".
    
    Since:
    
    3.23/4.19
  - BENGALI
```
public static final NumberSystem BENGALI
```
    The Bengali digits used in parts of India.
    Note: Must not be negative. Code: "beng".
    
    Since:
    
    3.23/4.19
  - DEVANAGARI
```
public static final NumberSystem DEVANAGARI
```
    The Devanagari digits used in parts of India.
    Note: Must not be negative. Code: "deva".
    
    Since:
    
    3.23/4.19
  - DOZENAL
```
public static final NumberSystem DOZENAL
```
    Dozenal numbers describe a 12-based positional numbering system.
    See also Wikipedia. Note: Must not be negative. Code: "dozenal" (no CLDR-equivalent).
    
    Since:
    
    3.26/4.22
  - ETHIOPIC
```
public static final NumberSystem ETHIOPIC
```
    Ethiopic numerals (always positive).
    See also A Look at Ethiopic Numerals. Attention: This enum is not a decimal system. Code: "ethiopic".
  - GUJARATI
```
public static final NumberSystem GUJARATI
```
    The Gujarati digits used in parts of India.
    Note: Must not be negative. Code: "gujr".
    
    Since:
    
    3.23/4.19
  - JAPANESE
```
public static final NumberSystem JAPANESE
```
    The Japanese numbers limited to the range 1-9999.
    See also Wikipedia. The code is: "jpan".
    
    Since:
    
    3.32/4.27
  - KHMER
```
public static final NumberSystem KHMER
```
    Traditional number system used by Khmer people in Cambodia.
    Note: Must not be negative. Code: "khmr".
    
    Since:
    
    3.23/4.19
  - MYANMAR
```
public static final NumberSystem MYANMAR
```
    The number system used in Myanmar (Burma).
    Note: Must not be negative. Code: "mymr".
    
    Since:
    
    3.23/4.19
  - ORYA
```
public static final NumberSystem ORYA
```
    The Orya digits used in parts of India.
    Note: Must not be negative. Code: "orya".
    
    Since:
    
    3.37/4.32
  - ROMAN
```
public static final NumberSystem ROMAN
```
    Roman numerals in range 1-3999.
    If the leniency is strict then parsing of Roman numerals will only follow modern usage. The parsing is always case-insensitive. See also Roman Numerals. Code: "roman" (deviation from CLDR).
  - TELUGU
```
public static final NumberSystem TELUGU
```
    The Telugu digits used in parts of India.
    Note: Must not be negative. Code: "telu".
    
    Since:
    
    3.23/4.19
  - THAI
```
public static final NumberSystem THAI
```
    The Thai digits used in Thailand (Siam).
    Note: Must not be negative. Code: "thai".
    
    Since:
    
    3.23/4.19
- Method Detail
  - values
```
public static NumberSystem[] values()
```
    Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
```
for (NumberSystem c : NumberSystem.values())
    System.out.println(c);
```
    Returns:
    
    an array containing the constants of this enum type, in the order they are declared
  - valueOf
```
public static NumberSystem valueOf(String name)
```
    Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
    
    Parameters:
    
    name - the name of the enum constant to be returned.
    
    Returns:
    
    the enum constant with the specified name
    
    Throws:
    
    IllegalArgumentException - if this enum type has no constant with the specified name
    
    NullPointerException - if the argument is null
  - toNumeral
```
public String toNumeral(int number)
```
    Converts given integer to a text numeral.
    
    Parameters:
    
    number - number to be displayed as text
    
    Returns:
    
    text numeral
    
    Throws:
    
    IllegalArgumentException - if the conversion is not supported for given number
    
    Since:
    
    3.11/4.8
  - toNumeral
```
public int toNumeral(int number,
                     Appendable buffer)
              throws IOException
```
    Converts given integer to a text numeral which will then be written into buffer.
    
    Parameters:
    
    number - number to be displayed as text
    
    buffer - the buffer where any formatted number goes to
    
    Returns:
    
    count of characters written to the buffer
    
    Throws:
    
    IllegalArgumentException - if the conversion is not supported for given number
    
    IOException - if writing to the buffer fails
    
    Since:
    
    3.27/4.22
  - toInteger
```
public final int toInteger(String numeral)
```
    Converts given text numeral to an integer in smart mode.
    
    Parameters:
    
    numeral - text numeral to be evaluated as number
    
    Returns:
    
    integer
    
    Throws:
    
    IllegalArgumentException - if given number has wrong format
    
    ArithmeticException - if int-range overflows
    
    Since:
    
    3.11/4.8
  - toInteger
```
public int toInteger(String numeral,
                     Leniency leniency)
```
    Converts given text numeral to an integer.
    
    In most cases, the leniency will not be taken into account, but parsing of some odd roman numerals can be enabled in non-strict mode (for example: IIXX instead of XVIII).
    
    Parameters:
    
    numeral - text numeral to be evaluated as number
    
    leniency - determines how lenient the parsing of given numeral should be
    
    Returns:
    
    integer
    
    Throws:
    
    IllegalArgumentException - if given number has wrong format
    
    ArithmeticException - if int-range overflows
    
    Since:
    
    3.15/4.12
  - contains
```
public boolean contains(char digit)
```
    Does this number system contains given digit char?
    
    Parameters:
    
    digit - numerical char to be checked
    
    Returns:
    
    boolean
    
    Since:
    
    3.11/4.8
  - getDigits
```
public String getDigits()
```
    Defines all digit characters from the smallest to the largest one.
    
    Note: If letters are used as digits then the upper case will be used.
    
    Returns:
    
    String containing all valid digit characters in ascending order
    
    Since:
    
    3.23/4.19
  - isDecimal
```
public boolean isDecimal()
```
    Does this number system describe a decimal system where the digits can be mapped to the range 0-9?
    
    Returns:
    
    boolean
    
    Since:
    
    3.23/4.19
  - getCode
```
public String getCode()
```
    Obtains an identifier which can be used together with the unicode extension "nu" in Locale-parameters.
    
    Example: Locale.forLanguageTag("th-TH-u-nu-" + NumberSystem.THAI.getCode()) would set the Thai-number-system where the code "thai" is used.
    
    Returns:
    
    unicode extension identifier (in most cases defined like in CLDR)
    
    Since:
    
    4.24

Enum NumberSystem

Enum Constant Summary

Method Summary

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

ARABIC

ARABIC_INDIC

ARABIC_INDIC_EXT

BENGALI

DEVANAGARI

DOZENAL

ETHIOPIC

GUJARATI

JAPANESE

KHMER

MYANMAR

ORYA

ROMAN

TELUGU

THAI

Method Detail

values

valueOf

toNumeral

toNumeral

toInteger

toInteger

contains

getDigits

isDecimal

getCode