Format —— Java & Android

1. ParsePosition
Format的子类用来记录当前的解析位置，当要分段解析一个字符串时


如：
        NumberFormat format = NumberFormat.getInstance();
        ParsePosition pp = new ParsePosition(0);
        String target = "1'12'123'1234";
        while (pp.getIndex() < target.length()){
            System.out.println(format.parse(target, pp));
            pp.setIndex(pp.getIndex() + 1);
        }
        输出：
        1
        12
        123
        1234


2. FieldPosition
Format的子类用来记录特定Field在格式化后的字符串中的起始位置，其中endIndex是所占最后一个位置+1


如：
        NumberFormat numForm = NumberFormat.getInstance();
        StringBuffer sb = new StringBuffer();
        FieldPosition pos = new FieldPosition(NumberFormat.FRACTION_FIELD);
        numForm.format(123.45, sb, pos);
        System.out.println(sb);
        System.out.println("FRACTION portion is at: " + pos.getBeginIndex() +
                ", " + pos.getEndIndex());
        输出：
        beginIndex：4，endIndex：6




3. NumberFormat
简单地将进行数字和字符串的转换，包括普通数字、货币和百分数，非线程安全的


a. setMaximumFractionDigits——fMax和setMinimumFractionDigits——fMin
设置转换后的字符串中小数位数
如果fMin大于实际的小数位数，会使用padding字符填充，默认为0；
如果fMax小于实际的小数位数，会圆整到fMax位小数；
如果实际的小数位数在fMin和fMax之间，且这部分小数位0，则这部分0不会显示
如12.1000004, fMin=2, fMax=5，则输出为‘12.10’


设置fMin时，如果fMin > fMax，则fMax = fMin
设置fMax时，如果fMax < fMin，则fMin = fMax


如12.1234:
setMaximumFractionDigits(3)，则输出为‘12.123’
setMinimumFractionDigits(5)，则输出为‘12.12340’


b. setParseIntegerOnly是否只解析整数部分
如12.1234
setParseIntegerOnly(true)，则输出为‘12’


c. setMinimumIntegerDigits——IMin和setMaximumIntegerDigits——IMAX
设置最大和最小整数位数


设置IMin时，如果IMin > IMax，则IMax = IMin
设置IMax时，如果IMax < IMin，则IMin = IMax


如果IMAX小于数字的自然整数位数则会被截断；如果IMin大于数字的自然整数位数，则会使用padding字符填充，默认为0
如1234.5
setMaximumIntegerDigits(2)，则输出为‘34.5’
setMinimumIntegerDigits(5)，则输出为‘01234.5’


d. 圆整模式
CEILING     ：向正无穷
DOWN        ：向0
FLOOR       ：向负无穷
HALF_DOWN   ：向最近的
HALF_EVEN   ：向最近的
HALF_UP     ：向最近的
UNNECESSARY ：若需要圆整操作，则抛出异常
UP          ：正数向正无穷，负数向负无穷


4. DecimalFormatSymbols
DecimalFormat用来记录特殊符号的，例如在解析时什么符号被当作NaN，在格式化时NaN以什么形式输出
可以设置的符号有：
货币符号
小数和整数之间的分隔符
千分位分隔符
无穷大
NaN
科学计数法中指数和非指数之间的分隔符
负数签名的负号
0
百分号
模式分隔符
货币中小数和整数之间的分隔符




4. DecimalFormat
提供复杂强大的字符串和数字之间的转换功能，包括普通数字、货币和百分数，非线程安全的
可以设置数字的格式，以供解析和格式化时使用，可以为特殊意义的字符或字符串设置格式化或解析表示


a. setDecimalSeparatorAlwaysShown是否显示小数点，false则表示不需要显示时不显示，而true却相反
如1234，false时‘1234’，true时‘1234.’


b. 模式
0和#都表示数字，但是#表示如果0可以省去则省去，0正好相反
0和.之间只能是0，不能有其他字符


模式中的小数模式确定FMax和FMin
如#.##，FMax=2，FMin=0
#.0#，FMax=2，FMin=1
模式中的整数模式确定IMin，IMAX默认为Integer.MAX_VALUE除非显示设定


c. grouping
指定整数部分如何分组显示，各个分组之间使用grouping seperator
在模式中使用,表示分组分隔符，最后一个分组分隔符到模式尾部（如果没有小数模式部分）或者.之间的#或0的数目即为分组的长度
在普通java平台上，就只有这一个长度
在Android中这个长度称为primary grouping size(PGS)，还有一个secondary grouping size(SGS)，如果在模式中分组分隔符数目为1则两个长度一致
如果PGS和SGS不一致，则PGS只应用于包含最低有效位的分组
SGS的大小确定方式：最后两个分组分隔符之间的#或0的数目
PGS用于整数的最低有效位的显示，SGS与其他有效位的显示
如12345678，PGS=4，SGS=3，则输出为‘1,234,5678’


d. padding (only in Android)
*作为padding转移符号，其后的任何字符(16位长度)作为填充字符
填充宽度：*和填充符号之外的字符数目
如：“*#,##,####”，长度8
“*####”，长度3


e. 科学计数法
指数模式是指指数字符(通常为E或e)后的模式部分，非指数模式指的是指数字符前面的模式部分
指数部分数字长度由指数模式的长度决定
指数模式的第一个数字字符必须是0，而不能是#


f. significant digits
显示出来的数字的数目可以使用两种方式来确定：
一种是：设定(通过模式或APIs)小数和整数的位数来共同确定
还有就是：通过有效数字位数来确定，就是通过模式中的@和#确定最小——MinSD和最大——MaxSD有效数字的数目，模式是否包含@表示是否启用该方式
如：“@@##”，MinSD=2，MaxSD=4


MinSD和MaxSD对解析没有影响


模式中在第一个@之前的#不作为有效数字的计数，但是可以用于表示分组大小
如“#,#@#”，MinSD=1，MaxSD=2，PGS=3


若使用本方法，则不能有.和0


使用该方式，则使用APIs设置的小数和整数的位数被忽略，小数和整数的位数就由MinSD、MaxSD确定
如对于“@@##”，“3.14159”输出为“3.142”，“12.3004”输出为“12.3”


5. ChoiceFormat
基于一个数字返回一个固定的字符串，对于像英语这样有单数和复数之分的比较有用
使用前需要制定一个数字数组Na(必须是升序的长度L)和字符串数组Sa
返回字符串的规则是：
    对于给的数字a，在数字数组中找到一个索引j，使得Na[j]<= a < Na[j+1]；
    若没有这样的j，若a < Na[0]则j=0，若a > Na[L-1]则j=L-1
    最后返回Sa[j]
如果通过模式字符串指定，则在比较时Na[j]<= a < Na[j+1]对应的Na[j]使用<连接字符串，则要变成Na[j]< a < Na[j+1]
如“1#Sun|2#Mon|3#Tue|4#Wed|5#Thur|6#Fri|7#Sat”，则“8”输出为Sat，“1.1”输出为Sun
“0#are no files|1#is one file|1<are many files”，则“1.1”输出为“are many files”


6. MessageFormat
其他Formatters的集合体


a. 获取一组对象，格式化这些对象，然后将格式化后的字符串插入到模式中的适当位置
每个对象的插入位置的模式决定了如何格式化其本身


每个插入位置的格式化模式，可以通过APIs设置，也可以通过在构造MessageFormat时在模式中指定


b. 从字符串中解析出一组对象，可以是Number，Date


详细用法见API文档


7. DateFormat
简单地解析和格式化日期时间


8. SimpleDateFormat
提供强大的解析和格式化日期时间的功能


a. set2DigitYearStart
设置解析时两位年的起始年(SY)
年份的确定规则：(year为解析的两位年份)
year += SY / 100 * 100; //确保和起始年在同一个世纪
if (year < SY) year += 100;
默认情况下，SY为SimpleDateFormat创建时时间的年份-80