Java Calendar getDisplayNames()方法与示例

日历类getDisplayNames()方法

• getDisplayNames()方法在java.util包中可用。

• getDisplayNames()方法用于返回包含日历所有字段名称的Map，该日历将在给定style(st)和Locale(lo)的给定field(fi)值中更新。

• getDisplayNames()方法是一个非静态方法，可通过类对象访问，如果尝试使用类名称访问该方法，则会收到错误消息。

• getDisplayNames()方法在返回Map对象时可能会引发异常。

• IllegalArgumentException：如果给定的field(fi)或style(st)无效，则可能引发此异常。

• NullPointerException：如果给定参数Locale(lo)为null，则可能引发此异常。

语法：

    public Map getDisplayNames(int fi, int st, Locale lo);

参数：

• int fi –它代表此日历的字段(fi)。

• int st –它表示将对字符串符号实施的样式。

• 语言环境lo –它表示字符串符号的语言环境。

返回值：

该方法的返回类型为String，它返回Map对象，该对象包含以给定样式和语言环境显示的名称及其所需的field(fi)值，否则，当不存在任何字符串表示形式时，返回null。

示例

//Java程序演示的例子
//getDisplayNames()日历的映射方法

import java.util.*;

public class GetDisplayNames {
    public static void main(String args[]) {
        //实例化Calendar对象
        Calendar ca = Calendar.getInstance();

        //实例化语言环境对象
        Locale lo = Locale.getDefault();

        //通过使用getDisplayNames()方法是
        //显示名称
        Map < String, Integer > m = ca.getDisplayNames(Calendar.DAY_OF_WEEK,
            Calendar.LONG, lo);

        NavigableMap < String, Integer > nm = new TreeMap < String, Integer > (m);

        //显示结果 
        System.out.println(" ca.getDisplayNames(): " + nm);
    }
}

输出结果

ca.getDisplayNames(): {Friday=6, Monday=2, Saturday=7, Sunday=1, Thursday=5, Tuesday=3, Wednesday=4}