net.time4j.format

Enum NumberSystem

java.lang.Object

java.lang.Enum<NumberSystem>

net.time4j.format.NumberSystem

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<NumberSystem>

public enum NumberSystem
extends java.lang.Enum<NumberSystem>

Defines the number system.

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

Since:

3.11/4.8

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.
KHMER Traditional number system used by Khmer people in Cambodia.
MYANMAR The number system used in Myanmar (Burma).
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

Modifier and Type	Method and Description
boolean	contains(char digit) Does this number system contains given digit char?
java.lang.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(java.lang.String numeral) Converts given text numeral to an integer in smart mode.
int	toInteger(java.lang.String numeral, Leniency leniency) Converts given text numeral to an integer.
java.lang.String	toNumeral(int number) Converts given integer to a text numeral.
int	toNumeral(int number, java.lang.Appendable buffer) Converts given integer to a text numeral which will then be written into buffer.
static NumberSystem	valueOf(java.lang.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.

ARABIC_INDIC

public static final NumberSystem ARABIC_INDIC

Arabic-Indic numbers (used in many Arabic countries).

Note: Must not be negative.

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.

Since:

3.23/4.19

BENGALI

public static final NumberSystem BENGALI

The Bengali digits used in parts of India.

Note: Must not be negative.

Since:

3.23/4.19

DEVANAGARI

public static final NumberSystem DEVANAGARI

The Devanagari digits used in parts of India.

Note: Must not be negative.

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.

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.

GUJARATI

public static final NumberSystem GUJARATI

The Gujarati digits used in parts of India.

Note: Must not be negative.

Since:

3.23/4.19

KHMER

public static final NumberSystem KHMER

Traditional number system used by Khmer people in Cambodia.

Note: Must not be negative.

Since:

3.23/4.19

MYANMAR

public static final NumberSystem MYANMAR

The number system used in Myanmar (Burma).

Note: Must not be negative.

Since:

3.23/4.19

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.

TELUGU

public static final NumberSystem TELUGU

The Telugu digits used in parts of India.

Note: Must not be negative.

Since:

3.23/4.19

THAI

public static final NumberSystem THAI

The Thai digits used in Thailand (Siam).

Note: Must not be negative.

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(java.lang.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:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

toNumeral

public java.lang.String toNumeral(int number)

Converts given integer to a text numeral.

Parameters:

number - number to be displayed as text

Returns:

text numeral

Throws:

java.lang.IllegalArgumentException - if the conversion is not supported for given number

Since:

3.11/4.8

toNumeral

public int toNumeral(int number,
                     java.lang.Appendable buffer)
              throws java.io.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:

java.lang.IllegalArgumentException - if the conversion is not supported for given number

java.io.IOException - if writing to the buffer fails

Since:

3.27/4.22

toInteger

public final int toInteger(java.lang.String numeral)

Converts given text numeral to an integer in smart mode.

Parameters:

numeral - text numeral to be evaluated as number

Returns:

integer

Throws:

java.lang.IllegalArgumentException - if given number has wrong format

java.lang.ArithmeticException - if int-range overflows

Since:

3.11/4.8

toInteger

public int toInteger(java.lang.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:

java.lang.IllegalArgumentException - if given number has wrong format

java.lang.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 java.lang.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