Java.util.Calendar.getDisplayNames() Method



The java.util.Calendar.getDisplayNames() method returns a Map containing all names of the calendar field in the given style and locale and their corresponding field values.


Following is the declaration for java.util.Calendar.getDisplayNames() method

public Map<String,Integer> getDisplayNames(int field,int style,Locale locale)


  • field − the calendar field.

  • style − the style that will be applied to the string representations

  • locale − the string representation locale

Return Value

The method returns a Map containing all display names in style and locale and their field values, or null if no string representation is available.


  • IllegalArgumentException − if field or style are invalid, or if this Calendar is non-lenient and any of the fields has invalid values

  • NullPointerException − if locale is null


The following example shows the usage of java.util.calendar.getDisplayNames() method.

Live Demo
package com.tutorialspoint;

import java.util.*;

public class CalendarDemo {
   public static void main(String[] args) {

      // create calendar and locale
      Calendar now = Calendar.getInstance();
      Locale locale = Locale.getDefault();

      // call the getdisplaynames method
      Map< String, Integer> representations = 
      now.getDisplayNames(Calendar.DAY_OF_WEEK, Calendar.LONG, locale);
      NavigableMap< String, Integer> navMap =  
      new TreeMap< String, Integer>(representations);

      // print the results
      System.out.printf("Whole list:%n%s%n", navMap);

Let us compile and run the above program, this will produce the following result −

Whole list:
{Monday=2, Sunday=1, Thursday=5, Friday=6, Saturday=7, Wednesday=4, Tuesday=3}