HanziToPinyin

Combination of output format options

Three types of output format options can be customized in pinyin4j.

• VCharType: output format of character 'ü', which has three options.
  • WITH_U_AND_COLON (default)
  • WITH_V
  • WITH_U_UNICODE
• ToneType: output format of Chinese tones, which has three options.
  • WITH_TONE_NUMBER (default)
  • WITHOUT_TONE
  • WITH_TONE_MARK
• CaseType: cases of letters in outputted string, which has two options.
  • LOWERCASE (default)
  • UPPERCASE

Some combinations of these three output formats are forbidden. For example, '吕'

LOWERCASE
Combination	WITH_U_AND_COLON	WITH_V	WITH_U_UNICODE
WITH_TONE_NUMBER	lu:3	lv3	lü3
WITHOUT_TONE	lu:	lv	lü
WITH_TONE_MARK	Exception	Exception	lǚ

UPPERCASE
Combination	WITH_U_AND_COLON	WITH_V	WITH_U_UNICODE
WITH_TONE_NUMBER	LU:3	LV3	LÜ3
WITHOUT_TONE	LU:	LV	LÜ
WITH_TONE_MARK	Exception	Exception	LǙ

Numerals in place of tone marks

Tone	Tone Mark	Number added to end of syllable in place of tone mark	Example using tone mark	Example using number
First	macron (¯)	1	mā	ma1
Second	acute accent (´)	2	má	ma2
Third	caron (ˇ)	3	mǎ	ma3
Fourth	grave accent (`)	4	mà	ma4

Links:

Combination of output format options

Unicode® character table

Pinyin

pinyin4j