Java格式化类Format


Format介绍

java.text.Format是Java格式化的抽象基类。主要用于将对象格式化为指定模式的字符串,或者将指定模式的字符串解析为对象。

Format方法

- format(格式化)

格式化:对象格式化为字符串。

  1. public final String format (Object obj)

    public final String format (Object obj) {
        return format(obj, new StringBuffer(), new FieldPosition(0)).toString();
    }
    

    一般使用此方法来将对象格式化为字符串,该方法为不可变方法,方法内部调用抽象方法的具体子类实现。

  2. public abstract StringBuffer format(Object obj, StringBuffer toAppendTo, FieldPosition pos)
    抽象方法,子类必须实现该方法,定义子类自己具体的对象格式化为字符串的逻辑。

- parseObject(解析)

解析:字符串解析为对象。

  1. public Object parseObject(String source) throws ParseException

    public Object parseObject(String source) throws ParseException {
        ParsePosition pos = new ParsePosition(0);
        Object result = parseObject(source, pos);
        if (pos.index == 0) {
            throw new ParseException("Format.parseObject(String) failed",
                pos.errorIndex);
        }
        return result;
    }
    

    一般使用此方法来将字符串解析为对象,该方法为不可变方法,方法内部调用抽象方法的具体子类实现。

  2. public abstract Object parseObject (String source, ParsePosition pos)
    抽象方法,子类必须实现该方法,定义子类自己具体的字符串解析为对象的逻辑。

格式化分类

在这里插入图片描述

格式化分类格式化类描述
日期时间格式化DateFormat格式化日期时间的抽象类
SimpleDateFormatDateFormat的实现类,用于格式化和解析日期时间,非线程安全
ClassicFormatDateTimeFormatter的内部类,提供日期时间的格式化和解析
数字格式化NumberFormat格式化数字的抽象类
DecimalFormatNumberFormat的实现类,提供数字格式化和解析
ChoiceFormatNumberFormat的实现类,可以根据特定的值范围来选择相应的格式
字符串格式化MessageFormat用于字符串格式化的类。它可以将带有占位符的模板字符串和对应的参数值进行格式化
StringString类的format方法用于字符串的格式化

日期时间格式化

1. DateFormat

日期格式化抽象类,根据当前语言环境格式化日期和时间。

因为DateFormat是一个抽象类,所以不能直接new创建实例对象。但DateFormat提供了一些静态方法便于我们构建DateFormat子类的实例。

常用方法
getInstance

获取格式化的日期时间

  • getInstance():输出样式:22-8-30 下午4:14
getDateInstance

获取格式化的日期

方法描述
getDateInstance()输出样式:2022-8-30
getDateInstance(int style)指定样式
getDateInstance(int style, Locale aLocale)指定样式和语言环境
getTimeInstance

获取格式化的时间

方法描述
getTimeInstance()输出样式:16:14:32
getTimeInstance(int style)指定样式
getTimeInstance(int style, Locale aLocale)指定样式和语言环境
getDateTimeInstance

获取格式化的日期时间

方法描述
getDateTimeInstance()输出样式:2022-8-30 16:14:32
getDateTimeInstance(int dateStyle, int timeStyle)指定样式
getDateTimeInstance(int dateStyle, int timeStyle, Locale aLocale)指定样式和语言环境
方法入参
style

设置输出样式。

DateFormat提供了多种输出样式:


    /**
     * 完整样式
     */
    public static final int FULL = 0;
    /**
     * 长样式
     */
    public static final int LONG = 1;
    /**
     * 中等样式
     */
    public static final int MEDIUM = 2;
    /**
     * 短样式
     */
    public static final int SHORT = 3;
    /**
     * 默认样式:中等样式
     */
    public static final int DEFAULT = MEDIUM;
样式输出格式(日期Date)输出格式(时间Time)
SHORT22-8-30下午4:03
MEDIUM
DEFAULT
2022-8-3016:03:06
LONG2022年8月30日下午04时03分06秒
FULL2022年8月30日 星期二下午04时03分06秒 CST
Locale

设置语言环境。

在这里插入图片描述

  • language:语言(zh:中文)
  • region:地区(CN:China)

2. SimpleDateFormat

SimpleDateFormat是DateFormat的一个具体实现类,是非线程安全的。

因为DateFormat直接支持的样式比较少,经常满足不了实际需求,于是SimpleDateFormat就来了,SimpleDateFormat提供了丰富的样式且可自定义样式。

在使用SimpleDateFormat的时候,需要通过字母来描述时间元素,并组装成想要的日期和时间模式。

常用模式元素

常用的日期时间元素和字母的对应表如下:

字母描述实例
G年代标志符(公元、公元前)AD、BC
y2015
Y周年2016
M年中的月份12
w年中的周数50
W月份中的周数02
D年中的天数344
d月份中的天数10
F月份中的星期02
E周中的天数(星期几)Thu
u周中的天数(第几天,星期一=1,星期日=7)1
aAM/PM标记AM、PM、上午、下午
H一天中的小时数(0~23)21
k一天中的小时数(1~24)21
KAM/PM中的小时数(0~11)09
hAM/PM中的小时数(1~12)09
m小时中的分钟数31
s分钟中的秒数08
S毫秒数716
z时区CST
Z时区(RFC 822标准时区)+0800
X时区(ISO 8601标准时区)+08

y与Y的区别:

  • YY是周年
  • yy是日历年,推荐使用y

举例:今天是2019年12月30日,日历年是 2019,但周年是 2020,因为本周是 2020 年的第 1 周。所以yy是19,而YY是20。

使用方法
格式化
public static void main(String[] args) throws ParseException {
    Date date = new Date();
    SimpleDateFormat simpleDateFormat = new SimpleDateFormat("G yyyy-MM-dd HH:mm:ss S E z");
    String format = simpleDateFormat.format(date);
}

debug:
在这里插入图片描述

解析
public static void main(String[] args) throws ParseException {
        String str = "公元 2022-08-30 22:10:03 530 星期二 CST";
        SimpleDateFormat simpleDateFormat = new SimpleDateFormat("G yyyy-MM-dd HH:mm:ss S E z");
        Date date1 = (Date) simpleDateFormat.parseObject(str);
}

debug:
在这里插入图片描述

3. ClassicFormat

暂不分析。

数字格式化

1. NumberFormat

数字格式化抽象类,根据当前语言环境格式化数字。

NumberFormat是一个抽象类,不能直接new创建实例对象。NumberFormat提供了一些静态方法便于我们构建NumberFormat子类的实例。

常用方法
getInstance

获取格式化的常规数值

  • getInstance()
  • getInstance(Locale inLocale)
getNumberInstance

获取格式化的常规数值

  • getNumberInstance()
  • getNumberInstance(Locale inLocale)
getIntegerInstance

获取格式化的整型数值

  • getIntegerInstance()
  • getIntegerInstance(Locale inLocale)
getPercentInstance

获取格式化的百分比数值

  • getPercentInstance()
  • getPercentInstance(Locale inLocale)
getCurrencyInstance

获取格式化的指定语言环境的货币数值

  • getCurrencyInstance()
  • getCurrencyInstance(Locale inLocale)
方法示例
public static void main(String[] args) throws ParseException {
    NumberFormat instance = NumberFormat.getInstance();
    String format = instance.format(2.3);
    System.out.println("getInstance=====================" + format);
    NumberFormat integerInstance = NumberFormat.getIntegerInstance();
    String format1 = integerInstance.format(2.3);
    System.out.println("getIntegerInstance==============" + format1);
    NumberFormat percentInstance = NumberFormat.getPercentInstance();
    String format2 = percentInstance.format(2.3);
    System.out.println("getPercentInstance==============" + format2);
    NumberFormat currencyInstance = NumberFormat.getCurrencyInstance();
    String format3 = currencyInstance.format(2.3);
    System.out.println("getCurrencyInstance=============" + format3);
    NumberFormat currencyInstance1 = NumberFormat.getCurrencyInstance(Locale.US);
    String format4 = currencyInstance1.format(2.3);
    System.out.println("getCurrencyInstance(Locale.US)==" + format4);
}

控制台日志:

getInstance=====================2.3
getIntegerInstance==============2
getPercentInstance==============230%
getCurrencyInstance=============2.30
getCurrencyInstance(Locale.US)==$2.30

2. DecimalFormat

DecimalFormat是NumberFormat的一个具体子类,用于格式化十进制数字。

DecimalFormat能够分析和格式化任意语言环境中的数字:

  • 包括对西方语言、阿拉伯语和印度语数字的支持。
  • 支持整数 (123)、定点数 (123.4)、科学记数法表示的数 (1.23E4)、百分数 (12%) 和金额 ($123)等。
  • 所有的内容都可以本地化(本地化:使用本地的语言环境)。

需要注意的是:DecimalFormat是非线程安全的。

DecimalFormat支持手动配置模式使用模式符号

手动设置模式
  • setMaximumFractionDigits(int newValue):设置小数部分中允许的最大数字位数
  • setMinimumFractionDigits(int newValue):设置小数部分中允许的最小数字位数,如果原数小数位数不够的话,会补零。
  • setGroupingSize(int i):设置分组中一组的位数(整数部分,默认3个数字为一组)。
  • setGroupingUsed(boolean value):设置是否使用分组,true表示使用,false表示取消分组
  • setMaximumIntegerDigits(int newValue):设置整数部分允许的最大数字位数
  • setMinimumIntegerDigits(int newValue):设置整数部分允许的最小数字位数
使用模式符号串
符号 位置是否本地化含义
0 数字 阿拉伯数字,位数不足时补0
#数字阿拉伯数字,位数不足时不管
.数字小数分隔符或货币小数分隔符
-数字减号
,数字分组分隔符
E数字分隔科学计数法中的尾数和指数
;子模式边界分隔正数和负数子模式
分号前是正常模式,分号后是负数输入的的输出前缀
- 如果输入为正数,输出:正常模式的结果
- 如果输入为正数,输出:负数的前缀+正常模式的结果的绝对值
%前缀或后缀乘以100并显示为百分数
\u2030前缀或后缀乘以1000并显示为千分数
¤(\u00A4)前缀或后缀货币记号,由货币符号替换。
如果同时出现两个该符号,则用国际货币符号替换。
如果出现在某个模式中,则使用货币小数分隔符,而不使用小数分隔符。
'前缀或后缀用于在前缀或后缀中为特殊字符加引号,使特殊符号变为普通字符(如要创建单引号本身,请连续使用两个单引号)。
例如:"'#'#" 将123格式化为 "#123"
使用方法
格式化

① 手动配置模式

    public static void main(String[] args) throws ParseException {
        DecimalFormat decimalFormat = new DecimalFormat();
        decimalFormat.setGroupingUsed(true);// 使用分组
        decimalFormat.setGroupingSize(4);// 分组中一组的位数
        decimalFormat.setMinimumIntegerDigits(2);// 整数部分最小位数
        decimalFormat.setMaximumIntegerDigits(8);// 整数部分最大位数
        decimalFormat.setMinimumFractionDigits(2);// 小数部分最小位数
        decimalFormat.setMaximumFractionDigits(4);// 小数部分最大位数

        System.out.println(decimalFormat.format(1.11));// 01.11

        System.out.println(decimalFormat.format(11111.222));// 1,1111.222

        System.out.println(decimalFormat.format(11111111111.222222222222));// 1111,1111.2222
    }

② 使用模式符号串

    public static void main(String[] args){
        double pi = 3.1415926;

        // 取整数部分,整数部分不足2位补0
        System.out.println(new DecimalFormat("00").format(pi));// 03

        // 取整数部分和10位小数,整数部分不足2位补0,小数部分不足10位补0
        System.out.println(new DecimalFormat("00.0000000000").format(pi));// 03.1415926000

        // 取整数部分,整数部分不足2位不管
        System.out.println(new DecimalFormat("##").format(pi));// 3
        // ###和上面的##没区别
        System.out.println(new DecimalFormat("###").format(pi));// 3

        // 取整数部分和10位小数,整数部分不足2位不管,小数部分不足10位不管
        System.out.println(new DecimalFormat("##.##########").format(pi));// 3.1415926

        // 若输入为非负数,按;前面的正常模式输出
        // 若输入为负数,按;后面的(负数输入的输出前缀+正常模式输出的绝对值)输出
        System.out.println(new DecimalFormat("#.##;前缀").format(3.1415926));// 3.14
        System.out.println(new DecimalFormat("#.##;前缀").format(-3.1415926));// 前缀3.14

        // 百分比方式计数(百分号在末位),取整数部分和2位小数,小数部分不足2位不管
        System.out.println(new DecimalFormat("#.##%").format(pi));// 314.16%

        // 百分比方式计数(百分号在首位),取整数部分和2位小数,小数部分不足2位不管
        System.out.println(new DecimalFormat("%#.##").format(pi));// %314.16

        // 千分比方式计数(千分号在末位),取整数部分和2位小数,小数部分不足2位不管
        System.out.println(new DecimalFormat("#.##\u2030").format(pi));// 3141.59‰

        // 千分比方式计数(千分号在首位),取整数部分和2位小数,小数部分不足2位不管
        System.out.println(new DecimalFormat("\u2030#.##").format(pi));// ‰3141.59

        //显示为科学计数法,并取五位小数
        System.out.println(new DecimalFormat("#.#####E0").format(pi));// 3.14159E0

        //显示为两位整数的科学计数法,并取四位小数
        System.out.println(new DecimalFormat("00.####E0").format(pi));// 31.4159E-1

        //取整数部分,每三位以逗号进行分隔。
        System.out.println(new DecimalFormat(",###").format(pi));// 3

        // 添加货币符号在首位,如果同时出现两个该符号,则用国际货币符号
        System.out.println(new DecimalFormat("¤#.##").format(pi));// ¥3.14
        System.out.println(new DecimalFormat("\u00A4#.##").format(pi));// ¥3.14
        System.out.println(new DecimalFormat("¤¤#.##").format(pi));// CNY3.14

        // 添加货币符号在末位,如果同时出现两个该符号,则用国际货币符号
        System.out.println(new DecimalFormat("#.##¤").format(pi));// 3.14¥
        System.out.println(new DecimalFormat("#.##\u00A4").format(pi));// 3.14¥
        System.out.println(new DecimalFormat("#.##¤¤").format(pi));// 3.14CNY

        // 将特殊字符变为普通字符
        System.out.println(new DecimalFormat("''#.##").format(pi));// '3.14
        System.out.println(new DecimalFormat("#.##''").format(pi));// 3.14'
        System.out.println(new DecimalFormat("'#'#.##").format(pi));// #3.14
        System.out.println(new DecimalFormat("#.##'#'").format(pi));// 3.14#

        //将格式嵌入文本
        System.out.println(new DecimalFormat("圆周率π:#.##").format(pi));// 圆周率π:3.14
    }
解析

解析也可以手动配置模式或者使用模式符号串,这里只以使用模式符号串方式举例。

    public static void main(String[] args) throws ParseException {
        System.out.println(new DecimalFormat("圆周率π:#.##").parseObject("圆周率π:3.14"));// 3.14

        System.out.println(new DecimalFormat("#.##;前缀").parseObject("前缀3.14"));// -3.14

        System.out.println(new DecimalFormat("00.####E0").parseObject("31.4159E-1"));// 3.14159
    }

3. ChoiceFormat

ChoiceFormat将格式化运用到某个范围的数。

ChoiceFormat与其他Format类的不同之处在于,它使用构造函数放入方式(而不是使用getInstance样式工厂方法)创建ChoiceFormat对象。

注意:limits数组需要升序排列(否则结果会出错)

常用方法
nextDouble(double d)

查找大于d的最小double值,一般用在limits数组中,从而使limits数组形成一个右开区间数组

例如:limits = {0,1,ChoiceFormat.nextDouble(1)}

nextDouble(double d, boolean positive)
  1. positive=true,表示查找大于d的最小double值,一般用在limits数组中,从而使limits数组形成一个右开区间数组
  2. positive=false,表示查找小于d的最大double值,一般用在limits数组中,从而使limits数组形成一个左开区间数组
previousDouble(double d)

查找小于d的最大double值,一般用在limits数组中,从而使limits数组形成一个左开区间数组

public static void main(String[] args) {
	 System.out.println(ChoiceFormat.nextDouble(1));// 1.0000000000000002
	 System.out.println(ChoiceFormat.nextDouble(1,true));// 1.0000000000000002
	 System.out.println(ChoiceFormat.nextDouble(1,false));// 0.9999999999999999
	 System.out.println(ChoiceFormat.previousDouble(1));// 0.9999999999999999
}

上面三个方法的使用场景:

如果有个这样的需求:

  1. 当number < 1时,取值0
  2. 当1 <= number <= 2时,取值1
  3. 当2 < number <= 3时,取值2
  4. 当number > 3时,取值3

代码实现:

    double[] limits = {0, 1, 2, 3};
    String[] formats = {"0","1","2","3"};
    ChoiceFormat format = new ChoiceFormat(limits, formats);

如果这样的写法,显然不能满足:

  • number = 2时,取值1
  • number = 3时,取值2

我们可以这么写

public static void main(String[] args) {
    double[] limits = {0, 1, ChoiceFormat.nextDouble(2), ChoiceFormat.nextDouble(3)};
    String[] formats = {"0","1","2","3"};
    ChoiceFormat format = new ChoiceFormat(limits, formats);
    System.out.println(format.format(0));
    System.out.println(format.format(1));
    System.out.println(format.format(2));
    System.out.println(format.format(3));
    System.out.println(format.format(4));
}

在这里插入图片描述
能完全满足上面的需求(number = 2时,取值1;number = 3时,取值2)。

ChoiceFormat(double[] limits, String[] formats)

构造函数中接收一个formats数组和一个limits数组,这两个数组必须具有相同数量的元素。

  • 第一个数组是原始双精度数组,表示每个间隔的最小值(起始值)。
  • 第二个数组是一个字符串数组,代表与每个间隔关联的名称。

limits数组实际上是个区间,可开可闭,并且必须按升序排列,如果不按升序排列,格式化结果将会不正确,还可以使用\u221E(表示无穷大)。

匹配规则:limits[i] <= number <limits[i+1]

number表示使用format方法传入的值,i表示limit数组中的索引。当且仅当上述公式成立时,number匹配i,如果不能匹配,则会根据number是太小还是太大,匹配limits数组的第一个索引或最后一个索引,然后使用匹配的limits数组中的索引,去formats数组中寻找相同索引的值。

public static void main(String[] args) {
	double[] limits = {0, 1, 2, 3, 4, 5, 6};
	String[] formats = { "星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期日" };
	ChoiceFormat format = new ChoiceFormat(limits, formats);
	System.out.println(format.format(-1));// 星期一
	System.out.println(format.format(0));// 星期一
	System.out.println(format.format(1));// 星期二
	System.out.println(format.format(2.5));// 星期三
	System.out.println(format.format(6.6));// 星期日
	System.out.println(format.format(7));// 星期日
	System.out.println(format.format(8));// 星期日
}
namber取值范围匹配formats索引位置匹配值
number < 0匹配formats[0]星期一
0 <= number < 1匹配formats[0]星期一
1 <= number < 2匹配formats[1]星期二
2 <= number < 3匹配formats[2]星期三
3 <= number < 4匹配formats[3]星期四
4 <= number < 5匹配formats[4]星期五
5 <= number < 6匹配formats[5]星期六
numbe >= 6匹配formats[6]星期日
ChoiceFormat(String newPattern)

ChoiceFormat类的构造方法也允许我们传入一个模式字符串,format方法会根据这个模式字符串执行格式化操作。

模式元素的格式:doubleNum [占位符] formatStr

占位符
占位符描述
#等于
<大于
\u2264(<=)大于等于

注意:比较运算符和平时实现相反的,因为该地方类似于变量在比较运算符的右边(平时是在左边

模式字符串中的每个模式元素之间使用 | 分割,| 前后可以添加空格以美化代码。

其实在ChoiceFormat(String newPattern)构造方法的内部,模式字符串还是被转换为limits和formats两个数组。

public static void main(String[] args) {
	ChoiceFormat choice=new ChoiceFormat("1 # A | 2 < B | 3 \u2264 C | 5 # D");
	System.out.println(choice.format(0));
	System.out.println(choice.format(1));
	System.out.println(choice.format(2));
	System.out.println(choice.format(3));
	System.out.println(choice.format(4));
	System.out.println(choice.format(5));
	System.out.println(choice.format(6));
}

在这里插入图片描述

字符串格式化

1. MessageFormat

MessageFormat提供与语言环境无关的生成连接消息的方式。

通常用MessageFormat的静态方法format,该方法接收一个字符串的模式和一组对象(对象数组),按照模式形式将格式化的对象插入到模式中,然后返回字符串结果。

static String format(String pattern, Object … arguments)

  • pattern:字符串模式
  • arguments:对象数组
模式元素

模式元素格式:ArgumentIndex[,FormatType[,FormatStyle]]

  • ArgumentIndex:入参索引位置(从0开始)
  • FormatType:格式化类型
  • FormatStyle:格式化样式
格式化类型
  • date:调用DateFormat进行格式化
  • time:调用DateFormat进行格式化
  • number:调用NumberFormat进行格式化
  • choice:调用ChoiceFormat进行格式化
格式化样式
  • short
  • medium
  • long
  • full
  • integer
  • currency
  • percent
  • SubformatPattern(子模式)
使用示例
public static void main(String[] args) {
    Date date = new Date();
    System.out.println(MessageFormat.format("{0},{1},{2}", date, date, 1.11));
    System.out.println(MessageFormat.format("{0,date},{1,time},{2,number}", date, date, 1.11));
    System.out.println(MessageFormat.format("{0,date,MEDIUM},{1,time,MEDIUM},{2,number,integer},{3,number,#.#}", date, date, 1.11, 2.22));
}

输出:

22-9-5 下午10:47,22-9-5 下午10:47,1.11
2022-9-5,22:47:39,1.11
2022-9-5,22:47:39,1,2.2

2. String.format

String有两个格式化方法

  • format(String format, Object… args)
  • format(Locale l, String format, Object… args)
format参数

format参数格式:%[index$][flags][width][.precision]conversion

模块
模块是否必须描述
index$参数在参数列表中的位置,十进制整数。
第一个参数由 "1$" 引用,第二个参数由 "2$"引用
flags标识,用来控制输出格式
width输出的最小长度,正整数
.precision精度,限定输出字符数
conversion转换符,指定如何格式化参数
标识
标识描述
-在最小宽度内左对齐,不可与0标识一起使用
0若内容长度不足最小宽度,则在左边用0来填充
#对8进制和16进制,8进制前添加一个0,16进制前添加0x
+结果总包含一个+或-号
空格正数前加空格,负数前加-号
,只用与十进制,每3位数字间用,分隔
(若结果为负数,则用括号括住,且不显示符号
转换符
s字符串类型
c字符类型
b布尔类型,只要实参为非false的布尔类型,均格式化为字符串true,否则为字符串false
d整数类型(十进制)
x整数类型(八进制)
o整数类型(十六进制)
f浮点数型(十进制)。显示9位有效数字,且会进行四舍五入。如99.99
a浮点数型(十六进制)
g浮点数型(比%f,%a长度短些,显示6位有效数字,且会进行四舍五入)
e指数类型。如9.38e+5
h散列码
%百分比
tx日期与时间类型(x代表不同的日期与时间转换符)
n换行符

举例:

public static void main(String[] args) {
    System.out.println(String.format("%2$06.2f======%1$d", 2, 11.1111));// 011.11======2
}
  • 0
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值