Java格式转换之(FieldPosition(跟踪索引)标识要格式化的类型为)

Java格式转换


java.text.Format

Format是一个用于格式化语言环境敏感的信息(如日期、消息和数字)的抽象基类,直接已知子类有DateFormat, MessageFormat, NumberFormat。

Format定义了编程接口,用于将语言环境敏感的对象格式化为String(使用format方法)和将String重新解析为对象(使用 parseObject方法)。 

通常,一个Format的parseObject方法必须能解析任何由其Format方法格式化的字符串。不过,也可能存在不能解析的异常情况。例如,Format方法可能创建中间无分隔符的两个相邻整数,在这种情况下,parseObject无法判断哪个数字属于哪个数。

Java平台为格式化日期、消息和数字分别提供了三个特殊的Format的子类:DateFormat、MessageFormat和NumberFormat。具体的子类必须实现三个方法: 

format(Object obj, StringBuffer toAppendTo, FieldPosition pos) 

formatToCharacterIterator(Object obj) 

parseObject(String source, ParsePosition pos) 

这些常规方法允许对对象进行多态解析和格式化,还可以被使用(如被 MessageFormat 使用)。子类通常也为特定的输入类型提供了另外的format方法,也为特定的结果类型提供了parse方法。当在输入文本的开始没有任何所需格式的文本时,则任何不带 ParsePosition参数的parse方法都应该抛出ParseException。 

大多数子类还将实现以下工厂方法: 

getInstance 获取一个适合于当前语言环境的有用的格式对象 

getInstance(Locale) 获取一个适合于指定语言环境的有用的格式对象。 

此外,某些子类还可能为了更特殊的控制实现其它getXxxxInstance方法。例如,NumberFormat类提供了getPercentInstance和 getCurrencyInstance方法来获取特殊的数字格式器。

Format的子类如果允许程序员能为不同语言环境(比如用getInstance(Locale) )创建对象,必须实现以下类方法: 

public static Locale[] getAvailableLocales()

最后子类定义一个常量集合来标识格式输出中的不同字段。这些常量用于创建一个FieldPosition对象该对象标识字段中所包含的信息及其在格式化结果中的位置。这些常量应当命名为item_FIELD,其中item标识了该字段。有关这些常量的例子,请参阅 ERA_FIELD及其在DateFormat中的同类。

格式通常不是同步的。建议为每个线程创建独立的格式实例。如果多个线程同时访问一个格式,其它必须保持外部同步。


java.text.FieldPosition

构造方法

public FieldPosition(int field)

为给定字段创建一个FieldPosition对象。字段由常量标识,在不同的Format子类中,常量名称一般以_FIELD结尾。

public FieldPosition(Format.Field attribute)

为给定的字段常量创建一个FieldPosition对象。字段由不同Format子类中定义的常量来标识。这等效于调用new FieldPosition(attribute, -1)。


public FieldPosition(Format.Field attribute,int fieldID)

为给定的字段创建一个FieldPosition对象。字段由来自Field的子类之一的属性常量以及一个由Format的子类定义的整型字段ID标识。

当attribute不为null时,需要使用Field的Format子类应当优先考虑attribute而忽略fieldID。

不过,旧的Format子类可能不知道Field而依靠fieldID。如果该字段没有相应的整型常量,则fieldID应为-1。


FieldPosition是Format及其子类用于在格式输出中(format(Object obj, StringBuffer toAppendTo, FieldPosition pos))标识字段的简单类。

FieldPosition保持对格式输出中字段位置的两个索引进行跟踪:字段的第一个字符的索引和紧跟字段的最后一个字符的索引。 

new FieldPosition(NumberFormat.INTEGER_FIELD);

stringBuffer1 = 1.235

 INTEGER:beginIndex=0,endIndex=1     //索引位0-1(跟踪索引位)

new FieldPosition(NumberFormat.FRACTION_FIELD);

stringBuffer2 = 1.235

FRACTION:beginIndex=2,endIndex=5   //索引位2-5(跟踪索引位)

不同的Format类中的format方法需要一个FieldPosition对象作为参数。使用此format方法执行部分格式化或者以获取格式化输出的信息(比如字段位置)。字段可以通过两种方式标识,两者的作用是一致的,只是Format.Field常量更详细,建议使用这种方式: 

1、通过一个其名称通常以_FIELD结尾的整型常量。这些常量在Format的不同子类中定义: 

NumberFormat

static int FRACTION_FIELD

          用于构造FieldPosition对象的字段常量。

static int INTEGER_FIELD

          用于构造FieldPosition对象的字段常量。

总结:二者的跟踪的索引位不同




例子:

public static void main(String[] args) {

        //建立一个数字格式化对象

        NumberFormat numberFormat = NumberFormat.getInstance();

        //建立字符数组缓冲器)—— 线程安全

        StringBuffer stringBuffer1 = new StringBuffer();

        //数字格式化,用于格式化时对索引跟踪(第一个字符的索引,紧跟字段最后一个字符的索引)

        FieldPosition fieldPosition = new FieldPosition(NumberFormat.INTEGER_FIELD);

        //十进位小数对象

        BigDecimal bigDecimal = new BigDecimal("1.23456789");

        //执行格式化

        stringBuffer1 = numberFormat.format(bigDecimal, stringBuffer1, fieldPosition);

        System.out.println("stringBuffer1 = " + stringBuffer1);  //结果为1.235

        //获取索引

        System.out.println("INTEGER:beginIndex=" + fieldPosition.getBeginIndex() + ",endIndex=" + fieldPosition.getEndIndex());

        fieldPosition = new FieldPosition(NumberFormat.FRACTION_FIELD);

        StringBuffer stringBuffer2 = new StringBuffer();

        stringBuffer2 = numberFormat.format(bigDecimal, stringBuffer2, fieldPosition);

        System.out.println("stringBuffer2 = " + stringBuffer2);

        System.out.println("FRACTION:beginIndex=" + fieldPosition.getBeginIndex() + ",endIndex=" + fieldPosition.getEndIndex());

    }

结果为:

stringBuffer1 = 1.235

  INTEGER:beginIndex=0,endIndex=1     //索引位0-1

stringBuffer2 = 1.235

FRACTION:beginIndex=2,endIndex=5   //索引位2-5


2、通过一个Format.Field常量:标识要格式化的类型是什么?

NumberFormat.Field

static NumberFormat.Field CURRENCY

          标识货币字段的常量。

static NumberFormat.Field DECIMAL_SEPARATOR

          标识小数点字段的常量。

static NumberFormat.Field EXPONENT

          标识指数字段的常量。

static NumberFormat.Field EXPONENT_SIGN

          标识指数符号 (exponent sign) 字段的常量。

static NumberFormat.Field EXPONENT_SYMBOL

          标识指数符号 (exponent symbol) 字段的常量。

static NumberFormat.Field FRACTION

          标识小数字段的常量。

static NumberFormat.Field GROUPING_SEPARATOR

          标识组分隔符字段的常量。

static NumberFormat.Field INTEGER

          标识整数字段的常量。

static NumberFormat.Field PERCENT

          标识百分数字段的常量。

static NumberFormat.Field PERMILLE

          标识千分数字段的常量。

static NumberFormat.Field SIGN

          标识符号字段的常量。

  FieldPosition pos = new FieldPosition(DateFormat.Field.DAY_OF_MONTH);

          标识日期字段的常量


public static void main(String[] args) {

        NumberFormat numberFormat = NumberFormat.getInstance();

        StringBuffer stringBuffer1 = new StringBuffer();

        FieldPosition fieldPosition = new FieldPosition(NumberFormat.Field.INTEGER);

        BigDecimal bigDecimal = new BigDecimal("1.23456789");

        stringBuffer1 = numberFormat.format(bigDecimal, stringBuffer1, fieldPosition);

        System.out.println("stringBuffer1 = " + stringBuffer1);

        System.out.println("INTEGER:beginIndex=" + fieldPosition.getBeginIndex() + ",endIndex=" + fieldPosition.getEndIndex());

        fieldPosition = new FieldPosition(NumberFormat.Field.FRACTION);

        StringBuffer stringBuffer2 = new StringBuffer();

        stringBuffer2 = numberFormat.format(bigDecimal, stringBuffer2, fieldPosition);

        System.out.println("stringBuffer2 = " + stringBuffer2);

        System.out.println("FRACTION:beginIndex=" + fieldPosition.getBeginIndex() + ",endIndex=" + fieldPosition.getEndIndex());

    }

输出结果:

stringBuffer1 = 1.235

INTEGER:beginIndex=0,endIndex=1

stringBuffer2 = 1.235

FRACTION:beginIndex=2,endIndex=5


public static void main(String[] args) {

        DateFormat dateFormat = DateFormat.getDateTimeInstance(DateFormat.LONG, DateFormat.LONG);

        StringBuffer stringBuffer = new StringBuffer();

        FieldPosition pos = new FieldPosition(DateFormat.Field.DAY_OF_MONTH);

        stringBuffer = dateFormat.format(new Date(), stringBuffer, pos);

        System.out.println("stringBuffer = " + stringBuffer);

        System.out.println("DATE_FIELD:beginIndex= " + pos.getBeginIndex() + ",endIndex=" + pos.getEndIndex());

    }

输出结果:

stringBuffer = 2016年6月28日 上午11时07分18秒

DATE_FIELD:beginIndex= 7,endIndex=9


java.text.ParsePosition

ParsePosition是Format及其子类所使用的简单类,用来在解析过程中跟踪当前位置。各种Format类中的parseObject方法要求将 ParsePosition对象作为一个变量。解析具有不同格式的字符串时,可以使用同一个ParsePosition,因为索引参数记录的是当前位置。ParsePosition也会记录解析错误的位置。


构造方法

public ParsePosition(int index)

创建一个具有给定初始索引的新 ParsePosition。


例子:

public static void main(String[] args) {

        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd");

        String strings[] = {"xxx 2016-06-28 xxx1", "20160628 xxx2"};

        for (int i = 0; i < strings.length; i++) {

            ParsePosition parsePosition = new ParsePosition(4);//从第四位开始处理

            Date date = simpleDateFormat.parse(strings[i], parsePosition);

            //解析错误,返回null

            if (date == null) {

                System.out.println("无效日期:" + strings[i]);

                System.out.println("解析出错的索引=" + parsePosition.getErrorIndex());

                System.out.println("当前索引=" + parsePosition.getIndex());

                continue;

            }

            String substring = strings[i].substring(parsePosition.getIndex());

            System.out.println("日期=" + date + ",剩余部分:" + substring);

        }

    }

日期=Tue Jun 28 00:00:00 CST 2016,剩余部分: xxx1

无效日期:20160628 xxx2

解析出错的索引=8

当前索引=4

java.text.NumberFormat

NumberFormat 是所有数值格式的抽象基类。此类提供格式化和解析数值的接口。NumberFormat 还提供了一些方法来确定哪些语言环境具有数值格式,以及它们的名称是什么。 

NumberFormat 可用于格式化和解析任何语言环境的数值。使代码能够完全独立于小数点、千位分隔符甚至所用特定小数位数的语言环境约定,并与数值格式是否为偶小数无关。


如何获得一个实例?

NumberFormat总共有三种实例,常规数值、货币数值,百分比数值,每种都可以用默认语言环境和指定语言环境。

常规数值:getInstance()(同getNumberInstance())、getInstance(Locale inLocale)(同getNumberInstance(Locale inLocale))

货币数值:getCurrencyInstance()、getCurrencyInstance(Locale inLocale)

百分比数值:getPercentInstance()、getPercentInstance(Locale inLocale)


public static Locale[] getAvailableLocales()

返回一个当前所支持的语言环境数组


void setCurrency(Currency currency) 

设置格式化货币值时此数值格式使用的货币。

void setGroupingUsed(boolean newValue) 

设置此格式中是否使用分组,即是否有千位分隔符(逗号)。


void setMaximumFractionDigits(int newValue) 

设置数的小数部分所允许的最大位数。与解析无关。

void setMaximumIntegerDigits(int newValue) 

设置数的整数部分所允许的最大位数。与解析无关。

void setMinimumFractionDigits(int newValue) 

设置数的小数部分所允许的最小位数。与解析无关。

void setMinimumIntegerDigits(int newValue) 

设置数的整数部分所允许的最小位数。与解析无关。

void setParseIntegerOnly(boolean value) 

设置数是否应该仅作为整数进行解析。与格式化无关。


例子:

public static void main(String[] args) throws Exception {

        //常规数值

        NumberFormat format1 = NumberFormat.getNumberInstance();

        System.out.println(format1.getMaximumIntegerDigits());//2147483647

        System.out.println(format1.getMinimumIntegerDigits());//1

        System.out.println(format1.getMaximumFractionDigits());//3

        System.out.println(format1.getMinimumFractionDigits());//0

        System.out.println(format1.isGroupingUsed());//true

        System.out.println(format1.isParseIntegerOnly());//false

        System.out.println(format1.format(10000000));//10,000,000 默认分组

        System.out.println(format1.format(10000000.000));//10,000,000 小数点后全身0,被舍弃

        System.out.println(format1.format(10000000.001));//10,000,000.001

        System.out.println(format1.format(10000000.0001));//10,000,000 默认最大小数位数是3位

        System.out.println(format1.parse("10000000.001"));//1.0000000001E7 默认可以解析小数

        format1.setParseIntegerOnly(true);

        System.out.println(format1.parse("10000000.001"));//10000000

        //百分比数值

        NumberFormat format2 = NumberFormat.getPercentInstance();

        System.out.println(format2.getMaximumIntegerDigits());//2147483647

        System.out.println(format2.getMinimumIntegerDigits());//1

        System.out.println(format2.getMaximumFractionDigits());//0

        System.out.println(format2.getMinimumFractionDigits());//0

        System.out.println(format2.isGroupingUsed());//true

        System.out.println(format2.isParseIntegerOnly());//false

        System.out.println(format2.format(1.01));//101%

        System.out.println(format2.format(1.001));//100% 默认最大小数位数是0

        format2.setMaximumFractionDigits(1);

        System.out.println(format2.format(1.001));//100.1%

        System.out.println(format2.parse("100.1%"));// 1.001 默认可以解析小数

        //货币格式

        NumberFormat format3 = NumberFormat.getCurrencyInstance();

        System.out.println(format3.getMaximumIntegerDigits());//2147483647

        System.out.println(format3.getMinimumIntegerDigits());//1

        System.out.println(format3.getMaximumFractionDigits());//2

        System.out.println(format3.getMinimumFractionDigits());//2

        System.out.println(format3.isGroupingUsed());//true

        System.out.println(format3.isParseIntegerOnly());//false

        System.out.println(format3.format(10000));//¥10,000.00 默认语言环境是zh_CN

        System.out.println(format3.parse("¥10,000.00"));//10000

    }


java.text.DecimalFormat

DecimalFormat是NumberFormat的一个具体子类,用于格式化十进制数字。该类设计有各种功能,使其能够解析和格式化任意语言环境中的数,包括对西方语言、阿拉伯语和印度语数字的支持。通常不直接调用DecimalFormat的构造方法,要获取具体语言环境的DecimalFormat(包括默认语言环境),可调用NumberFormat的某个工厂方法,如getInstance()。如果看源码会发现getInstance()其实返回的就是DecimalFormat实例,因为以后的版本NumberFormat的工厂方法可能返回不同于DecimalFormat的子类: 

NumberFormat f = NumberFormat.getInstance(loc);

if (f instanceof DecimalFormat) {

    ((DecimalFormat) f).setDecimalSeparatorAlwaysShown(true);

}

DecimalFormat包含一个模式和一组符号。可直接使用applyPattern()或间接使用API方法来设置模式。符号存储在DecimalFormatSymbols象中。如果想要改变符号,比如小数点,可以使用和DecimalFormate关联的DecimalFormatSymbols,此类表示了DecimalFormat格式化数字所需的符号集(如小数点、组分隔符等等)。DecimalFormat 根据其语言环境数据为其自身创建一个DecimalFormatSymbols实例。如果需要更改这些符号,可从DecimalFormat#getDecimalFormatSymbols()获得DecimalFormatSymbols对象并修改它。通常程序员不需要修改DecimalFormatSymbols。


特殊符号

0

数字。阿拉伯数字,如果当前位置不存在数字,则显示为0

#

数字。阿拉伯数字,在不影响数值的情况下,当前位置如果为0或者不存在,则不显示

.

数字。小数分隔符或货币小数分隔符

-

数字。减号

,

数字。分组分隔符

E

数字。分隔科学计数法中的尾数和指数。在前缀或后缀中无需加引号

;

子模式边界。分隔正数和负数子模式

%

前缀或后缀。乘以 100 并显示为百分数

\u2030

前缀或后缀。乘以 1000 并显示为千分数

¤(\u00A4)

前缀或后缀。货币记号,由货币符号替换。如果两个同时出现,则用国际货币符号替换。如果出现在某个模式中,则使用货币小数分隔符,而不使用小数分隔符

前缀或后缀。用于在前缀或或后缀中为特殊字符加引号,例如 "‘#‘#" 将 123 格式化为 "#123"。要创建单引号本身,请连续使用两个单引号:"# o‘‘clock"



语法

1、前缀和后缀:数字前后的符号,除 \uFFFE、\uFFFF 和特殊字符以外的所有 Unicode 字符。

2、小数分隔符和千位分隔符应该是不同的字符,否则将不可能进行解析。

3、如果使用具有多个分组字符的模式,则最后一个分隔符和整数结尾之间的间隔才是使用的分组大小。所以 "#,##,###,####" == "######,####" == "##,####,####"。 



构造方法

DecimalFormat() 

使用默认模式和默认语言环境的符号创建一个DecimalFormat。 

DecimalFormat(String pattern) 

使用给定的模式和默认语言环境的符号创建一个DecimalFormat。 

DecimalFormat(String pattern, DecimalFormatSymbols symbols) 

使用给定的模式和符号创建一个DecimalFormat。 


例子:

public static void main(String[] args) throws Exception {

        DecimalFormatSymbols unusualSymbols = new DecimalFormatSymbols();

        unusualSymbols.setDecimalSeparator(‘|‘);

        unusualSymbols.setGroupingSeparator(‘^‘);

        String strange = "#,##0.###";

        DecimalFormat weirdFormatter = new DecimalFormat(strange, unusualSymbols);

        weirdFormatter.setGroupingSize(4);

        String bizarre = weirdFormatter.format(12345.678);

        System.out.println(bizarre);//1^2345|678

    }

你可能感兴趣的:(Java格式转换之(FieldPosition(跟踪索引)标识要格式化的类型为))