Home Whiteboard Practice Code Graphing Calculator Online Compilers Articles Tools
Tutorials Courses Jobs

Java Calendar Class

Previous
Quiz
Next

Introduction

The Java Calendar class is an abstract class that provides methods for converting between a specific instant in time and a set of calendar fields such as YEAR, MONTH, DAY_OF_MONTH, HOUR, and so on, and for manipulating the calendar fields, such as getting the date of the next week.Following are the important points about Calendar −

  • This class also provides additional fields and methods for implementing a concrete calendar system outside the package.

  • Calendar defines the range of values returned by certain calendar fields.

Class declaration

Following is the declaration for java.util.Calendar class −

public abstract class Calendar
   extends Object
   implements Serializable, Cloneable, Comparable<Calendar>

Field

Following are the fields for java.util.Calendar class −

  • static int ALL_STYLES − This is the style specifier for getDisplayNames indicating names in all styles, such as "January" and "Jan".

  • static int AM − This is the value of the AM_PM field indicating the period of the day from midnight to just before noon.

  • static int AM_PM − This is the field number for get and set indicating whether the HOUR is before or after noon.

  • static int APRIL − This is the value of the MONTH field indicating the fourth month of the year in the Gregorian and Julian calendars.

  • protected boolean areFieldsSet − This is true if fields[] are in sync with the currently set time.

  • static int AUGUST − This is the value of the MONTH field indicating the eighth month of the year in the Gregorian and Julian calendars.

  • static int DATE − This is the field number for get and set indicating the day of the month.

  • static int DAY_OF_MONTH − This is the field number for get and set indicating the day of the month.

  • static int DAY_OF_WEEK − This is the field number for get and set indicating the day of the week.

  • static int DAY_OF_WEEK_IN_MONTH − This is the field number for get and set indicating the ordinal number of the day of the week within the current month.

  • static int DAY_OF_YEAR − This is the field number for get and set indicating the day number within the current year.

  • static int DECEMBER − This is the value of the MONTH field indicating the twelfth month of the year in the Gregorian and Julian calendars.

  • static int DST_OFFSET − This is the field number for get and set indicating the daylight savings offset in milliseconds.

  • static int ERA − This is the field number for get and set indicating the era, e.g., AD or BC in the Julian calendar.

  • static int FEBRUARY − This is the value of the MONTH field indicating the second month of the year in the Gregorian and Julian calendars.

  • static int FIELD_COUNT − This is the number of distinct fields recognized by get and set.

  • protected int[] fields − This is the calendar field values for the currently set time for this calendar.

  • static int FRIDAY − This is the value of the DAY_OF_WEEK field indicating Friday.

  • static int HOUR − This is the field number for get and set indicating the hour of the morning or afternoon.

  • static int HOUR_OF_DAY − This is the field number for get and set indicating the hour of the day.

  • protected boolean[] isSet − This is the flags which tell if a specified calendar field for the calendar is set.

  • protected boolean isTimeSet − This is true if then the value of time is valid.

  • static int JANUARY − This is the value of the MONTH field indicating the first month of the year in the Gregorian and Julian calendars.

  • static int JULY − This is the value of the MONTH field indicating the seventh month of the year in the Gregorian and Julian calendars.

  • static int JUNE − This is the value of the MONTH field indicating the sixth month of the year in the Gregorian and Julian calendars.

  • static int LONG − This is the style specifier for getDisplayName and getDisplayNames indicating a long name, such as "January".

  • static int MARCH − This is the value of the MONTH field indicating the third month of the year in the Gregorian and Julian calendars.

  • static int MAY − This is the value of the MONTH field indicating the fifth month of the year in the Gregorian and Julian calendars.

  • static int MILLISECOND − This is the field number for get and set indicating the millisecond within the second.

  • static int MINUTE − This is the field number for get and set indicating the minute within the hour.

  • static int MONDAY − This is the value of the DAY_OF_WEEK field indicating Monday.

  • static int MONTH − This is the field number for get and set indicating the month.

  • static int NOVEMBER − This is the value of the MONTH field indicating the eleventh month of the year in the Gregorian and Julian calendars.

  • static int OCTOBER − This is the value of the MONTH field indicating the tenth month of the year in the Gregorian and Julian calendars.

  • static int PM − This is the value of the AM_PM field indicating the period of the day from noon to just before midnight.

  • static int SATURDAY − This is the value of the DAY_OF_WEEK field indicating Saturday.

  • static int SECOND − This is the field number for get and set indicating the second within the minute.

  • static int SEPTEMBER − This is the value of the MONTH field indicating the ninth month of the year in the Gregorian and Julian calendars.

  • static int SHORT − This is the style specifier for getDisplayName and getDisplayNames indicating a short name, such as "Jan".

  • static int SUNDAY − This is the value of the DAY_OF_WEEK field indicating Sunday.

  • static int THURSDAY − This is the value of the DAY_OF_WEEK field indicating Thursday.

  • protected long time − This is the the currently set time for this calendar, expressed in milliseconds after January 1, 1970, 0:00:00 GMT.

  • static int TUESDAY − This is the value of the DAY_OF_WEEK field indicating Tuesday.

  • static int UNDECIMBER − This is the value of the MONTH field indicating the thirteenth month of the year.

  • static int WEDNESDAY − This is the value of the DAY_OF_WEEK field indicating Wednesday.

  • static int WEEK_OF_MONTH − This is the field number for get and set indicating the week number within the current month.

  • static int WEEK_OF_YEAR − This is the Field number for get and set indicating the week number within the current year. .

  • static int YEAR − This is the field number for get and set indicating the year.

  • static int ZONE_OFFSET − This is the field number for get and set indicating the raw offset from GMT in milliseconds.

Class constructors

Sr.No. Constructor & Description
1

protected Calendar()

This constructor constructs a Calendar with the default time zone and locale.
2

protected Calendar(TimeZone zone, Locale aLocale)

This constructor constructs a calendar with the specified time zone and locale.

Class methods

Sr.No. Method & Description
1 abstract void add(int field, int amount)

This method adds or subtracts the specified amount of time to the given calendar field, based on the calendar's rules.
2 boolean after(Object when)

This method returns whether this Calendar represents a time after the time represented by the specified Object.
3 boolean before(Object when)

This method returns whether this Calendar represents a time before the time represented by the specified Object.
4 void clear()

This method sets all the calendar field values and the time value (millisecond offset from the Epoch) of this Calendar undefined.
6 Object clone()

This method creates and returns a copy of this object.
7 int compareTo(Calendar anotherCalendar)

This method compares the time values (millisecond offsets from the Epoch) represented by two Calendar objects.
8 boolean equals(Object obj)

This method compares this Calendar to the specified Object.
9 int get(int field)

This method returns the value of the given calendar field.
10 int getActualMaximum(int field)

This method returns the maximum value that the specified calendar field could have, given the time value of this Calendar.
11 int getActualMinimum(int field)

This method returns the minimum value that the specified calendar field could have, given the time value of this Calendar.
12 static Set<String> getAvailableCalendarTypes()

This method returns an unmodifiable Set containing all calendar types supported by Calendar in the runtime environment.
13 static Locale[] getAvailableLocales()

This method returns an array of all locales for which the getInstance methods of this class can return localized instances.
14 String getCalendarType()

This method returns the calendar type of this Calendar.
15 String getDisplayName(int field, int style, Locale locale)

This method returns the string representation of the calendar field value in the given style and locale.
16 Map<String,Integer> getDisplayNames(int field, int style, Locale locale)

This method returns a Map containing all names of the calendar field in the given style and locale and their corresponding field values.
17 int getFirstDayOfWeek()

This method gets what the first day of the week is; e.g., SUNDAY in the U.S., MONDAY in France.
18 abstract int getGreatestMinimum(int field)

This method returns the highest minimum value for the given calendar field of this Calendar instance.
19 static Calendar getInstance()

This method gets a calendar using the default time zone and locale.
20 abstract int getLeastMaximum(int field)

This method returns the lowest maximum value for the given calendar field of this Calendar instance.
21 abstract int getMaximum(int field)

This method returns the maximum value for the given calendar field of this Calendar instance.
22