Java Doc for Calendar.java in  » 6.0-JDK-Core » Collections-Jar-Zip-Logging-regex » java » util » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Home
Java Source Code / Java Documentation
1.6.0 JDK Core
2.6.0 JDK Modules
3.6.0 JDK Modules com.sun
4.6.0 JDK Modules com.sun.java
5.6.0 JDK Modules sun
6.6.0 JDK Platform
7.Ajax
8.Apache Harmony Java SE
9.Aspect oriented
10.Authentication Authorization
11.Blogger System
12.Build
13.Byte Code
14.Cache
15.Chart
16.Chat
17.Code Analyzer
18.Collaboration
19.Content Management System
20.Database Client
21.Database DBMS
22.Database JDBC Connection Pool
23.Database ORM
24.Development
25.EJB Server
26.ERP CRM Financial
27.ESB
28.Forum
29.Game
30.GIS
31.Graphic 3D
32.Graphic Library
33.Groupware
34.HTML Parser
35.IDE
36.IDE Eclipse
37.IDE Netbeans
38.Installer
39.Internationalization Localization
40.Inversion of Control
41.Issue Tracking
42.J2EE
43.J2ME
44.JBoss
45.JMS
46.JMX
47.Library
48.Mail Clients
49.Music
50.Net
51.Parser
52.PDF
53.Portal
54.Profiler
55.Project Management
56.Report
57.RSS RDF
58.Rule Engine
59.Science
60.Scripting
61.Search Engine
62.Security
63.Sevlet Container
64.Source Control
65.Swing Library
66.Template Engine
67.Test Coverage
68.Testing
69.UML
70.Web Crawler
71.Web Framework
72.Web Mail
73.Web Server
74.Web Services
75.Web Services apache cxf 2.2.6
76.Web Services AXIS2
77.Wiki Engine
78.Workflow Engines
79.XML
80.XML UI
Java Source Code / Java Documentation » 6.0 JDK Core » Collections Jar Zip Logging regex » java.util 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   java.util.Calendar

All known Subclasses:   java.util.JapaneseImperialCalendar,  java.util.GregorianCalendar,
Calendar
abstract public class Calendar implements Serializable,Cloneable,Comparable<Calendar>(Code)
The Calendar class is an abstract class that provides methods for converting between a specific instant in time and a set of Calendar.fields 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. An instant in time can be represented by a millisecond value that is an offset from the Epoch, January 1, 1970 00:00:00.000 GMT (Gregorian).

The class also provides additional fields and methods for implementing a concrete calendar system outside the package. Those fields and methods are defined as protected.

Like other locale-sensitive classes, Calendar provides a class method, getInstance, for getting a generally useful object of this type. Calendar's getInstance method returns a Calendar object whose calendar fields have been initialized with the current date and time:

 Calendar rightNow = Calendar.getInstance();
 

A Calendar object can produce all the calendar field values needed to implement the date-time formatting for a particular language and calendar style (for example, Japanese-Gregorian, Japanese-Traditional). Calendar defines the range of values returned by certain calendar fields, as well as their meaning. For example, the first month of the calendar system has value MONTH == JANUARY for all calendars. Other values are defined by the concrete subclass, such as ERA. See individual field documentation and subclass documentation for details.

Getting and Setting Calendar Field Values

The calendar field values can be set by calling the set methods. Any field values set in a Calendar will not be interpreted until it needs to calculate its time value (milliseconds from the Epoch) or values of the calendar fields. Calling the get, getTimeInMillis, getTime, add and roll involves such calculation.

Leniency

Calendar has two modes for interpreting the calendar fields, lenient and non-lenient. When a Calendar is in lenient mode, it accepts a wider range of calendar field values than it produces. When a Calendar recomputes calendar field values for return by get(), all of the calendar fields are normalized. For example, a lenient GregorianCalendar interprets MONTH == JANUARY, DAY_OF_MONTH == 32 as February 1.

When a Calendar is in non-lenient mode, it throws an exception if there is any inconsistency in its calendar fields. For example, a GregorianCalendar always produces DAY_OF_MONTH values between 1 and the length of the month. A non-lenient GregorianCalendar throws an exception upon calculating its time or calendar field values if any out-of-range field value has been set.

First Week

Calendar defines a locale-specific seven day week using two parameters: the first day of the week and the minimal days in first week (from 1 to 7). These numbers are taken from the locale resource data when a Calendar is constructed. They may also be specified explicitly through the methods for setting their values.

When setting or getting the WEEK_OF_MONTH or WEEK_OF_YEAR fields, Calendar must determine the first week of the month or year as a reference point. The first week of a month or year is defined as the earliest seven day period beginning on getFirstDayOfWeek() and containing at least getMinimalDaysInFirstWeek() days of that month or year. Weeks numbered ..., -1, 0 precede the first week; weeks numbered 2, 3,... follow it. Note that the normalized numbering returned by get() may be different. For example, a specific Calendar subclass may designate the week before week 1 of a year as week n of the previous year.

Calendar Fields Resolution

When computing a date and time from the calendar fields, there may be insufficient information for the computation (such as only year and month with no day of month), or there may be inconsistent information (such as Tuesday, July 15, 1996 (Gregorian) -- July 15, 1996 is actually a Monday). Calendar will resolve calendar field values to determine the date and time in the following way.

If there is any conflict in calendar field values, Calendar gives priorities to calendar fields that have been set more recently. The following are the default combinations of the calendar fields. The most recent combination, as determined by the most recently set single field, will be used.

For the date fields:

 YEAR + MONTH + DAY_OF_MONTH
 YEAR + MONTH + WEEK_OF_MONTH + DAY_OF_WEEK
 YEAR + MONTH + DAY_OF_WEEK_IN_MONTH + DAY_OF_WEEK
 YEAR + DAY_OF_YEAR
 YEAR + DAY_OF_WEEK + WEEK_OF_YEAR
 
For the time of day fields:
 HOUR_OF_DAY
 AM_PM + HOUR
 

If there are any calendar fields whose values haven't been set in the selected field combination, Calendar uses their default values. The default value of each field may vary by concrete calendar systems. For example, in GregorianCalendar, the default of a field is the same as that of the start of the Epoch: i.e., YEAR = 1970, MONTH = JANUARY, DAY_OF_MONTH = 1, etc.

Note: There are certain possible ambiguities in interpretation of certain singular times, which are resolved in the following ways:

  1. 23:59 is the last minute of the day and 00:00 is the first minute of the next day. Thus, 23:59 on Dec 31, 1999 < 00:00 on Jan 1, 2000 < 00:01 on Jan 1, 2000.
  2. Although historically not precise, midnight also belongs to "am", and noon belongs to "pm", so on the same day, 12:00 am (midnight) < 12:01 am, and 12:00 pm (noon) < 12:01 pm

The date or time format strings are not part of the definition of a calendar, as those must be modifiable or overridable by the user at runtime. Use DateFormat to format dates.

Field Manipulation

The calendar fields can be changed using three methods: set(), add(), and roll().

set(f, value) changes calendar field f to value. In addition, it sets an internal member variable to indicate that calendar field f has been changed. Although calendar field f is changed immediately, the calendar's time value in milliseconds is not recomputed until the next call to get(), getTime(), getTimeInMillis(), add(), or roll() is made. Thus, multiple calls to set() do not trigger multiple, unnecessary computations. As a result of changing a calendar field using set(), other calendar fields may also change, depending on the calendar field, the calendar field value, and the calendar system. In addition, get(f) will not necessarily return value set by the call to the set method after the calendar fields have been recomputed. The specifics are determined by the concrete calendar class.

Example: Consider a GregorianCalendar originally set to August 31, 1999. Calling set(Calendar.MONTH, Calendar.SEPTEMBER) sets the date to September 31, 1999. This is a temporary internal representation that resolves to October 1, 1999 if getTime()is then called. However, a call to set(Calendar.DAY_OF_MONTH, 30) before the call to getTime() sets the date to September 30, 1999, since no recomputation occurs after set() itself.

add(f, delta) adds delta to field f. This is equivalent to calling set(f, get(f) + delta) with two adjustments:

Add rule 1. The value of field f after the call minus the value of field f before the call is delta, modulo any overflow that has occurred in field f. Overflow occurs when a field value exceeds its range and, as a result, the next larger field is incremented or decremented and the field value is adjusted back into its range.

Add rule 2. If a smaller field is expected to be invariant, but it is impossible for it to be equal to its prior value because of changes in its minimum or maximum after field f is changed or other constraints, such as time zone offset changes, then its value is adjusted to be as close as possible to its expected value. A smaller field represents a smaller unit of time. HOUR is a smaller field than DAY_OF_MONTH. No adjustment is made to smaller fields that are not expected to be invariant. The calendar system determines what fields are expected to be invariant.

In addition, unlike set(), add() forces an immediate recomputation of the calendar's milliseconds and all fields.

Example: Consider a GregorianCalendar originally set to August 31, 1999. Calling add(Calendar.MONTH, 13) sets the calendar to September 30, 2000. Add rule 1 sets the MONTH field to September, since adding 13 months to August gives September of the next year. Since DAY_OF_MONTH cannot be 31 in September in a GregorianCalendar, add rule 2 sets the DAY_OF_MONTH to 30, the closest possible value. Although it is a smaller field, DAY_OF_WEEK is not adjusted by rule 2, since it is expected to change when the month changes in a GregorianCalendar.

roll(f, delta) adds delta to field f without changing larger fields. This is equivalent to calling add(f, delta) with the following adjustment:

Roll rule. Larger fields are unchanged after the call. A larger field represents a larger unit of time. DAY_OF_MONTH is a larger field than HOUR.

Example: See java.util.GregorianCalendar.roll(intint) .

Usage model. To motivate the behavior of add() and roll(), consider a user interface component with increment and decrement buttons for the month, day, and year, and an underlying GregorianCalendar. If the interface reads January 31, 1999 and the user presses the month increment button, what should it read? If the underlying implementation uses set(), it might read March 3, 1999. A better result would be February 28, 1999. Furthermore, if the user presses the month increment button again, it should read March 31, 1999, not March 28, 1999. By saving the original date and using either add() or roll(), depending on whether larger fields should be affected, the user interface can behave as most users will intuitively expect.


See Also:   java.lang.System.currentTimeMillis
See Also:   Date
See Also:   GregorianCalendar
See Also:   TimeZone
See Also:   java.text.DateFormat
version:
   1.95, 05/05/07
author:
   Mark Davis, David Goldsmith, Chen-Lieh Huang, Alan Liu
since:
   JDK1.1


Field Summary
final static  intALL_FIELDS
     The mask value that represents all of the fields.
final public static  intALL_STYLES
     A style specifier for Calendar.getDisplayNames(int,int,Locale)getDisplayNames indicating names in all styles, such as "January" and "Jan".
final public static  intAM
     Value of the Calendar.AM_PM field indicating the period of the day from midnight to just before noon.
final public static  intAM_PM
     Field number for get and set indicating whether the HOUR is before or after noon.
final static  intAM_PM_MASK
    
final public static  intAPRIL
     Value of the Calendar.MONTH field indicating the fourth month of the year in the Gregorian and Julian calendars.
final public static  intAUGUST
     Value of the Calendar.MONTH field indicating the eighth month of the year in the Gregorian and Julian calendars.
final public static  intDATE
     Field number for get and set indicating the day of the month.
final static  intDATE_MASK
    
final public static  intDAY_OF_MONTH
     Field number for get and set indicating the day of the month.
final static  intDAY_OF_MONTH_MASK
    
final public static  intDAY_OF_WEEK
     Field number for get and set indicating the day of the week.
final public static  intDAY_OF_WEEK_IN_MONTH
     Field number for get and set indicating the ordinal number of the day of the week within the current month.
final static  intDAY_OF_WEEK_IN_MONTH_MASK
    
final static  intDAY_OF_WEEK_MASK
    
final public static  intDAY_OF_YEAR
     Field number for get and set indicating the day number within the current year.
final static  intDAY_OF_YEAR_MASK
    
final public static  intDECEMBER
     Value of the Calendar.MONTH field indicating the twelfth month of the year in the Gregorian and Julian calendars.
final public static  intDST_OFFSET
     Field number for get and set indicating the daylight savings offset in milliseconds.
final static  intDST_OFFSET_MASK
    
final public static  intERA
     Field number for get and set indicating the era, e.g., AD or BC in the Julian calendar.
final static  intERA_MASK
    
final public static  intFEBRUARY
     Value of the Calendar.MONTH field indicating the second month of the year in the Gregorian and Julian calendars.
final public static  intFIELD_COUNT
     The number of distinct fields recognized by get and set.
final public static  intFRIDAY
     Value of the Calendar.DAY_OF_WEEK field indicating Friday.
final public static  intHOUR
     Field number for get and set indicating the hour of the morning or afternoon.
final static  intHOUR_MASK
    
final public static  intHOUR_OF_DAY
     Field number for get and set indicating the hour of the day.
final static  intHOUR_OF_DAY_MASK
    
final public static  intJANUARY
     Value of the Calendar.MONTH field indicating the first month of the year in the Gregorian and Julian calendars.
final public static  intJULY
     Value of the Calendar.MONTH field indicating the seventh month of the year in the Gregorian and Julian calendars.
final public static  intJUNE
     Value of the Calendar.MONTH field indicating the sixth month of the year in the Gregorian and Julian calendars.
final public static  intLONG
     A style specifier for Calendar.getDisplayName(int,int,Locale)getDisplayName and Calendar.getDisplayNames(int,int,Locale)getDisplayNames indicating a long name, such as "January".
final public static  intMARCH
     Value of the Calendar.MONTH field indicating the third month of the year in the Gregorian and Julian calendars.
final public static  intMAY
     Value of the Calendar.MONTH field indicating the fifth month of the year in the Gregorian and Julian calendars.
final public static  intMILLISECOND
     Field number for get and set indicating the millisecond within the second.
final static  intMILLISECOND_MASK
    
final public static  intMINUTE
     Field number for get and set indicating the minute within the hour.
final static  intMINUTE_MASK
    
final public static  intMONDAY
     Value of the Calendar.DAY_OF_WEEK field indicating Monday.
final public static  intMONTH
     Field number for get and set indicating the month.
final static  intMONTH_MASK
    
final public static  intNOVEMBER
     Value of the Calendar.MONTH field indicating the eleventh month of the year in the Gregorian and Julian calendars.
final public static  intOCTOBER
     Value of the Calendar.MONTH field indicating the tenth month of the year in the Gregorian and Julian calendars.
final public static  intPM
     Value of the Calendar.AM_PM field indicating the period of the day from noon to just before midnight.
final public static  intSATURDAY
     Value of the Calendar.DAY_OF_WEEK field indicating Saturday.
final public static  intSECOND
     Field number for get and set indicating the second within the minute.
final static  intSECOND_MASK
    
final public static  intSEPTEMBER
     Value of the Calendar.MONTH field indicating the ninth month of the year in the Gregorian and Julian calendars.
final public static  intSHORT
     A style specifier for Calendar.getDisplayName(int,int,Locale)getDisplayName and Calendar.getDisplayNames(int,int,Locale)getDisplayNames indicating a short name, such as "Jan".
final public static  intSUNDAY
     Value of the Calendar.DAY_OF_WEEK field indicating Sunday.
final public static  intTHURSDAY
     Value of the Calendar.DAY_OF_WEEK field indicating Thursday.
final public static  intTUESDAY
     Value of the Calendar.DAY_OF_WEEK field indicating Tuesday.
final public static  intUNDECIMBER
     Value of the Calendar.MONTH field indicating the thirteenth month of the year.
final public static  intWEDNESDAY
     Value of the Calendar.DAY_OF_WEEK field indicating Wednesday.
final public static  intWEEK_OF_MONTH
     Field number for get and set indicating the week number within the current month.
final static  intWEEK_OF_MONTH_MASK
    
final public static  intWEEK_OF_YEAR
     Field number for get and set indicating the week number within the current year.
final static  intWEEK_OF_YEAR_MASK
    
final public static  intYEAR
     Field number for get and set indicating the year.
final static  intYEAR_MASK
    
final public static  intZONE_OFFSET
     Field number for get and set indicating the raw offset from GMT in milliseconds.
final static  intZONE_OFFSET_MASK
    
transient  booleanareAllFieldsSet
     True if all fields have been set.
protected  booleanareFieldsSet
     True if fields[] are in sync with the currently set time.
final static  intcurrentSerialVersion
    
protected  intfields
     The calendar field values for the currently set time for this calendar.
protected  booleanisSet
     The flags which tell if a specified calendar field for the calendar is set. A new object has no fields set.
protected  booleanisTimeSet
     True if then the value of time is valid.
final static  longserialVersionUID
    
protected  longtime
     The currently set time for this calendar, expressed in milliseconds after January 1, 1970, 0:00:00 GMT.

Constructor Summary
protected  Calendar()
     Constructs a Calendar with the default time zone and locale.
protected  Calendar(TimeZone zone, Locale aLocale)
     Constructs a calendar with the specified time zone and locale.

Method Summary
abstract public  voidadd(int field, int amount)
     Adds or subtracts the specified amount of time to the given calendar field, based on the calendar's rules.
public  booleanafter(Object when)
     Returns whether this Calendar represents a time after the time represented by the specified Object.
public  booleanbefore(Object when)
     Returns whether this Calendar represents a time before the time represented by the specified Object.
 booleancheckDisplayNameParams(int field, int style, int minStyle, int maxStyle, Locale locale, int fieldMask)
    
final public  voidclear()
     Sets all the calendar field values and the time value (millisecond offset from the Epoch) of this Calendar undefined.
final public  voidclear(int field)
     Sets the given calendar field value and the time value (millisecond offset from the Epoch) of this Calendar undefined.
public  Objectclone()
     Creates and returns a copy of this object.
public  intcompareTo(Calendar anotherCalendar)
     Compares the time values (millisecond offsets from the Epoch) represented by two Calendar objects.
Parameters:
  anotherCalendar - the Calendar to be compared.
protected  voidcomplete()
     Fills in any unset fields in the calendar fields.
abstract protected  voidcomputeFields()
     Converts the current millisecond time value Calendar.time to calendar field values in Calendar.fields fields[] . This allows you to sync up the calendar field values with a new time that is set for the calendar.
abstract protected  voidcomputeTime()
     Converts the current calendar field values in Calendar.fields fields[] to the millisecond time value Calendar.time .
public  booleanequals(Object obj)
     Compares this Calendar to the specified Object.
public  intget(int field)
     Returns the value of the given calendar field.
public  intgetActualMaximum(int field)
     Returns the maximum value that the specified calendar field could have, given the time value of this Calendar.
public  intgetActualMinimum(int field)
     Returns the minimum value that the specified calendar field could have, given the time value of this Calendar.

The default implementation of this method uses an iterative algorithm to determine the actual minimum value for the calendar field.

public static synchronized  Locale[]getAvailableLocales()
     Returns an array of all locales for which the getInstance methods of this class can return localized instances.
public  StringgetDisplayName(int field, int style, Locale locale)
     Returns the string representation of the calendar field value in the given style and locale.
public  Map<String, Integer>getDisplayNames(int field, int style, Locale locale)
     Returns a Map containing all names of the calendar field in the given style and locale and their corresponding field values.
final static  StringgetFieldName(int field)
     Returns the name of the specified calendar field.
public  intgetFirstDayOfWeek()
     Gets what the first day of the week is; e.g., SUNDAY in the U.S., MONDAY in France.
abstract public  intgetGreatestMinimum(int field)
     Returns the highest minimum value for the given calendar field of this Calendar instance.
public static  CalendargetInstance()
     Gets a calendar using the default time zone and locale.
public static  CalendargetInstance(TimeZone zone)
     Gets a calendar using the specified time zone and default locale. The Calendar returned is based on the current time in the given time zone with the default locale.
public static  CalendargetInstance(Locale aLocale)
     Gets a calendar using the default time zone and specified locale.
public static  CalendargetInstance(TimeZone zone, Locale aLocale)
     Gets a calendar with the specified time zone and locale.
abstract public  intgetLeastMaximum(int field)
     Returns the lowest maximum value for the given calendar field of this Calendar instance.
abstract public  intgetMaximum(int field)
     Returns the maximum value for the given calendar field of this Calendar instance.
public  intgetMinimalDaysInFirstWeek()
     Gets what the minimal days required in the first week of the year are; e.g., if the first week is defined as one that contains the first day of the first month of a year, this method returns 1.
abstract public  intgetMinimum(int field)
     Returns the minimum value for the given calendar field of this Calendar instance.
final  intgetSetStateFields()
     Returns a field mask (bit mask) indicating all calendar fields that have the state of externally or internally set.
final public  DategetTime()
     Returns a Date object representing this Calendar's time value (millisecond offset from the Epoch").
public  longgetTimeInMillis()
     Returns this Calendar's time value in milliseconds.
public  TimeZonegetTimeZone()
     Gets the time zone.
 TimeZonegetZone()
     Returns the time zone (without cloning).
public  inthashCode()
     Returns a hash code for this calendar. a hash code value for this object.
final protected  intinternalGet(int field)
     Returns the value of the given calendar field.
final  voidinternalSet(int field, int value)
     Sets the value of the given calendar field.
final  booleanisExternallySet(int field)
     Returns whether the value of the specified calendar field has been set externally by calling one of the setter methods rather than by the internal time calculation.
final static  booleanisFieldSet(int fieldMask, int field)
     Returns whether the specified field is on in the fieldMask.
final  booleanisFullyNormalized()
     Returns whether the calendar fields are fully in sync with the time value.
public  booleanisLenient()
     Tells whether date/time interpretation is to be lenient.
final  booleanisPartiallyNormalized()
     Returns whether the calendar fields are partially in sync with the time value or fully in sync but not stamp values are not normalized yet.
final public  booleanisSet(int field)
     Determines if the given calendar field has a value set, including cases that the value has been set by internal fields calculations triggered by a get method call.
abstract public  voidroll(int field, boolean up)
     Adds or subtracts (up/down) a single unit of time on the given time field without changing larger fields.
public  voidroll(int field, int amount)
     Adds the specified (signed) amount to the specified calendar field without changing larger fields.
final  intselectFields()
     Returns a field mask indicating which calendar field values to be used to calculate the time value.
public  voidset(int field, int value)
     Sets the given calendar field to the given value.
final public  voidset(int year, int month, int date)
     Sets the values for the calendar fields YEAR, MONTH, and DAY_OF_MONTH. Previous values of other calendar fields are retained.
final public  voidset(int year, int month, int date, int hourOfDay, int minute)
     Sets the values for the calendar fields YEAR, MONTH, DAY_OF_MONTH, HOUR_OF_DAY, and MINUTE. Previous values of other fields are retained.
final public  voidset(int year, int month, int date, int hourOfDay, int minute, int second)
     Sets the values for the fields YEAR, MONTH, DAY_OF_MONTH, HOUR, MINUTE, and SECOND. Previous values of other fields are retained.
final  voidsetFieldsComputed(int fieldMask)
     Sets the state of the specified calendar fields to computed.
final  voidsetFieldsNormalized(int fieldMask)
     Sets the state of the calendar fields that are not specified by fieldMask to unset.
public  voidsetFirstDayOfWeek(int value)
     Sets what the first day of the week is; e.g., SUNDAY in the U.S., MONDAY in France.
public  voidsetLenient(boolean lenient)
     Specifies whether or not date/time interpretation is to be lenient.
public  voidsetMinimalDaysInFirstWeek(int value)
     Sets what the minimal days required in the first week of the year are; For example, if the first week is defined as one that contains the first day of the first month of a year, call this method with value 1.
final public  voidsetTime(Date date)
     Sets this Calendar's time with the given Date.
public  voidsetTimeInMillis(long millis)
     Sets this Calendar's current time from the given long value.
public  voidsetTimeZone(TimeZone value)
     Sets the time zone with the given time zone value.
final  voidsetUnnormalized()
     Marks this Calendar as not sync'd.
 voidsetZoneShared(boolean shared)
     Sets the sharedZone flag to shared.
public  StringtoString()
     Return a string representation of this calendar.

Field Detail
ALL_FIELDS
final static int ALL_FIELDS(Code)
The mask value that represents all of the fields.



ALL_STYLES
final public static int ALL_STYLES(Code)
A style specifier for Calendar.getDisplayNames(int,int,Locale)getDisplayNames indicating names in all styles, such as "January" and "Jan".
See Also:   Calendar.SHORT
See Also:   Calendar.LONG
since:
   1.6



AM
final public static int AM(Code)
Value of the Calendar.AM_PM field indicating the period of the day from midnight to just before noon.



AM_PM
final public static int AM_PM(Code)
Field number for get and set indicating whether the HOUR is before or after noon. E.g., at 10:04:15.250 PM the AM_PM is PM.
See Also:   Calendar.AM
See Also:   Calendar.PM
See Also:   Calendar.HOUR



AM_PM_MASK
final static int AM_PM_MASK(Code)



APRIL
final public static int APRIL(Code)
Value of the Calendar.MONTH field indicating the fourth month of the year in the Gregorian and Julian calendars.



AUGUST
final public static int AUGUST(Code)
Value of the Calendar.MONTH field indicating the eighth month of the year in the Gregorian and Julian calendars.



DATE
final public static int DATE(Code)
Field number for get and set indicating the day of the month. This is a synonym for DAY_OF_MONTH. The first day of the month has value 1.
See Also:   Calendar.DAY_OF_MONTH



DATE_MASK
final static int DATE_MASK(Code)



DAY_OF_MONTH
final public static int DAY_OF_MONTH(Code)
Field number for get and set indicating the day of the month. This is a synonym for DATE. The first day of the month has value 1.
See Also:   Calendar.DATE



DAY_OF_MONTH_MASK
final static int DAY_OF_MONTH_MASK(Code)



DAY_OF_WEEK
final public static int DAY_OF_WEEK(Code)
Field number for get and set indicating the day of the week. This field takes values SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, and SATURDAY.
See Also:   Calendar.SUNDAY
See Also:   Calendar.MONDAY
See Also:   Calendar.TUESDAY
See Also:   Calendar.WEDNESDAY
See Also:   Calendar.THURSDAY
See Also:   Calendar.FRIDAY
See Also:   Calendar.SATURDAY



DAY_OF_WEEK_IN_MONTH
final public static int DAY_OF_WEEK_IN_MONTH(Code)
Field number for get and set indicating the ordinal number of the day of the week within the current month. Together with the DAY_OF_WEEK field, this uniquely specifies a day within a month. Unlike WEEK_OF_MONTH and WEEK_OF_YEAR, this field's value does not depend on getFirstDayOfWeek() or getMinimalDaysInFirstWeek(). DAY_OF_MONTH 1 through 7 always correspond to DAY_OF_WEEK_IN_MONTH 1; 8 through 14 correspond to DAY_OF_WEEK_IN_MONTH 2, and so on. DAY_OF_WEEK_IN_MONTH 0 indicates the week before DAY_OF_WEEK_IN_MONTH 1. Negative values count back from the end of the month, so the last Sunday of a month is specified as DAY_OF_WEEK = SUNDAY, DAY_OF_WEEK_IN_MONTH = -1. Because negative values count backward they will usually be aligned differently within the month than positive values. For example, if a month has 31 days, DAY_OF_WEEK_IN_MONTH -1 will overlap DAY_OF_WEEK_IN_MONTH 5 and the end of 4.
See Also:   Calendar.DAY_OF_WEEK
See Also:   Calendar.WEEK_OF_MONTH



DAY_OF_WEEK_IN_MONTH_MASK
final static int DAY_OF_WEEK_IN_MONTH_MASK(Code)



DAY_OF_WEEK_MASK
final static int DAY_OF_WEEK_MASK(Code)



DAY_OF_YEAR
final public static int DAY_OF_YEAR(Code)
Field number for get and set indicating the day number within the current year. The first day of the year has value 1.



DAY_OF_YEAR_MASK
final static int DAY_OF_YEAR_MASK(Code)



DECEMBER
final public static int DECEMBER(Code)
Value of the Calendar.MONTH field indicating the twelfth month of the year in the Gregorian and Julian calendars.



DST_OFFSET
final public static int DST_OFFSET(Code)
Field number for get and set indicating the daylight savings offset in milliseconds.

This field reflects the correct daylight saving offset value of the time zone of this Calendar if the TimeZone implementation subclass supports historical Daylight Saving Time schedule changes.




DST_OFFSET_MASK
final static int DST_OFFSET_MASK(Code)



ERA
final public static int ERA(Code)
Field number for get and set indicating the era, e.g., AD or BC in the Julian calendar. This is a calendar-specific value; see subclass documentation.
See Also:   GregorianCalendar.AD
See Also:   GregorianCalendar.BC



ERA_MASK
final static int ERA_MASK(Code)



FEBRUARY
final public static int FEBRUARY(Code)
Value of the Calendar.MONTH field indicating the second month of the year in the Gregorian and Julian calendars.



FIELD_COUNT
final public static int FIELD_COUNT(Code)
The number of distinct fields recognized by get and set. Field numbers range from 0..FIELD_COUNT-1.



FRIDAY
final public static int FRIDAY(Code)
Value of the Calendar.DAY_OF_WEEK field indicating Friday.



HOUR
final public static int HOUR(Code)
Field number for get and set indicating the hour of the morning or afternoon. HOUR is used for the 12-hour clock (0 - 11). Noon and midnight are represented by 0, not by 12. E.g., at 10:04:15.250 PM the HOUR is 10.
See Also:   Calendar.AM_PM
See Also:   Calendar.HOUR_OF_DAY



HOUR_MASK
final static int HOUR_MASK(Code)



HOUR_OF_DAY
final public static int HOUR_OF_DAY(Code)
Field number for get and set indicating the hour of the day. HOUR_OF_DAY is used for the 24-hour clock. E.g., at 10:04:15.250 PM the HOUR_OF_DAY is 22.
See Also:   Calendar.HOUR



HOUR_OF_DAY_MASK
final static int HOUR_OF_DAY_MASK(Code)



JANUARY
final public static int JANUARY(Code)
Value of the Calendar.MONTH field indicating the first month of the year in the Gregorian and Julian calendars.



JULY
final public static int JULY(Code)
Value of the Calendar.MONTH field indicating the seventh month of the year in the Gregorian and Julian calendars.



JUNE
final public static int JUNE(Code)
Value of the Calendar.MONTH field indicating the sixth month of the year in the Gregorian and Julian calendars.



LONG
final public static int LONG(Code)
A style specifier for Calendar.getDisplayName(int,int,Locale)getDisplayName and Calendar.getDisplayNames(int,int,Locale)getDisplayNames indicating a long name, such as "January".
See Also:   Calendar.SHORT
since:
   1.6



MARCH
final public static int MARCH(Code)
Value of the Calendar.MONTH field indicating the third month of the year in the Gregorian and Julian calendars.



MAY
final public static int MAY(Code)
Value of the Calendar.MONTH field indicating the fifth month of the year in the Gregorian and Julian calendars.



MILLISECOND
final public static int MILLISECOND(Code)
Field number for get and set indicating the millisecond within the second. E.g., at 10:04:15.250 PM the MILLISECOND is 250.



MILLISECOND_MASK
final static int MILLISECOND_MASK(Code)



MINUTE
final public static int MINUTE(Code)
Field number for get and set indicating the minute within the hour. E.g., at 10:04:15.250 PM the MINUTE is 4.



MINUTE_MASK
final static int MINUTE_MASK(Code)



MONDAY
final public static int MONDAY(Code)
Value of the Calendar.DAY_OF_WEEK field indicating Monday.



MONTH
final public static int MONTH(Code)
Field number for get and set indicating the month. This is a calendar-specific value. The first month of the year in the Gregorian and Julian calendars is JANUARY which is 0; the last depends on the number of months in a year.
See Also:   Calendar.JANUARY
See Also:   Calendar.FEBRUARY
See Also:   Calendar.MARCH
See Also:   Calendar.APRIL
See Also:   Calendar.MAY
See Also:   Calendar.JUNE
See Also:   Calendar.JULY
See Also:   Calendar.AUGUST
See Also:   Calendar.SEPTEMBER
See Also:   Calendar.OCTOBER
See Also:   Calendar.NOVEMBER
See Also:   Calendar.DECEMBER
See Also:   Calendar.UNDECIMBER



MONTH_MASK
final static int MONTH_MASK(Code)



NOVEMBER
final public static int NOVEMBER(Code)
Value of the Calendar.MONTH field indicating the eleventh month of the year in the Gregorian and Julian calendars.



OCTOBER
final public static int OCTOBER(Code)
Value of the Calendar.MONTH field indicating the tenth month of the year in the Gregorian and Julian calendars.



PM
final public static int PM(Code)
Value of the Calendar.AM_PM field indicating the period of the day from noon to just before midnight.



SATURDAY
final public static int SATURDAY(Code)
Value of the Calendar.DAY_OF_WEEK field indicating Saturday.



SECOND
final public static int SECOND(Code)
Field number for get and set indicating the second within the minute. E.g., at 10:04:15.250 PM the SECOND is 15.



SECOND_MASK
final static int SECOND_MASK(Code)



SEPTEMBER
final public static int SEPTEMBER(Code)
Value of the Calendar.MONTH field indicating the ninth month of the year in the Gregorian and Julian calendars.



SHORT
final public static int SHORT(Code)
A style specifier for Calendar.getDisplayName(int,int,Locale)getDisplayName and Calendar.getDisplayNames(int,int,Locale)getDisplayNames indicating a short name, such as "Jan".
See Also:   Calendar.LONG
since:
   1.6



SUNDAY
final public static int SUNDAY(Code)
Value of the Calendar.DAY_OF_WEEK field indicating Sunday.



THURSDAY
final public static int THURSDAY(Code)
Value of the Calendar.DAY_OF_WEEK field indicating Thursday.



TUESDAY
final public static int TUESDAY(Code)
Value of the Calendar.DAY_OF_WEEK field indicating Tuesday.



UNDECIMBER
final public static int UNDECIMBER(Code)
Value of the Calendar.MONTH field indicating the thirteenth month of the year. Although GregorianCalendar does not use this value, lunar calendars do.



WEDNESDAY
final public static int WEDNESDAY(Code)
Value of the Calendar.DAY_OF_WEEK field indicating Wednesday.



WEEK_OF_MONTH
final public static int WEEK_OF_MONTH(Code)
Field number for get and set indicating the week number within the current month. The first week of the month, as defined by getFirstDayOfWeek() and getMinimalDaysInFirstWeek(), has value 1. Subclasses define the value of WEEK_OF_MONTH for days before the first week of the month.
See Also:   Calendar.getFirstDayOfWeek
See Also:   Calendar.getMinimalDaysInFirstWeek



WEEK_OF_MONTH_MASK
final static int WEEK_OF_MONTH_MASK(Code)



WEEK_OF_YEAR
final public static int WEEK_OF_YEAR(Code)
Field number for get and set indicating the week number within the current year. The first week of the year, as defined by getFirstDayOfWeek() and getMinimalDaysInFirstWeek(), has value 1. Subclasses define the value of WEEK_OF_YEAR for days before the first week of the year.
See Also:   Calendar.getFirstDayOfWeek
See Also:   Calendar.getMinimalDaysInFirstWeek



WEEK_OF_YEAR_MASK
final static int WEEK_OF_YEAR_MASK(Code)



YEAR
final public static int YEAR(Code)
Field number for get and set indicating the year. This is a calendar-specific value; see subclass documentation.



YEAR_MASK
final static int YEAR_MASK(Code)



ZONE_OFFSET
final public static int ZONE_OFFSET(Code)
Field number for get and set indicating the raw offset from GMT in milliseconds.

This field reflects the correct GMT offset value of the time zone of this Calendar if the TimeZone implementation subclass supports historical GMT offset changes.




ZONE_OFFSET_MASK
final static int ZONE_OFFSET_MASK(Code)



areAllFieldsSet
transient boolean areAllFieldsSet(Code)
True if all fields have been set.



areFieldsSet
protected boolean areFieldsSet(Code)
True if fields[] are in sync with the currently set time. If false, then the next attempt to get the value of a field will force a recomputation of all fields from the current value of time.



currentSerialVersion
final static int currentSerialVersion(Code)



fields
protected int fields(Code)
The calendar field values for the currently set time for this calendar. This is an array of FIELD_COUNT integers, with index values ERA through DST_OFFSET.



isSet
protected boolean isSet(Code)
The flags which tell if a specified calendar field for the calendar is set. A new object has no fields set. After the first call to a method which generates the fields, they all remain set after that. This is an array of FIELD_COUNT booleans, with index values ERA through DST_OFFSET.



isTimeSet
protected boolean isTimeSet(Code)
True if then the value of time is valid. The time is made invalid by a change to an item of field[].
See Also:   Calendar.time



serialVersionUID
final static long serialVersionUID(Code)



time
protected long time(Code)
The currently set time for this calendar, expressed in milliseconds after January 1, 1970, 0:00:00 GMT.
See Also:   Calendar.isTimeSet




Constructor Detail
Calendar
protected Calendar()(Code)
Constructs a Calendar with the default time zone and locale.
See Also:   TimeZone.getDefault



Calendar
protected Calendar(TimeZone zone, Locale aLocale)(Code)
Constructs a calendar with the specified time zone and locale.
Parameters:
  zone - the time zone to use
Parameters:
  aLocale - the locale for the week data




Method Detail
add
abstract public void add(int field, int amount)(Code)
Adds or subtracts the specified amount of time to the given calendar field, based on the calendar's rules. For example, to subtract 5 days from the current time of the calendar, you can achieve it by calling:

add(Calendar.DAY_OF_MONTH, -5).
Parameters:
  field - the calendar field.
Parameters:
  amount - the amount of date or time to be added to the field.
See Also:   Calendar.roll(int,int)
See Also:   Calendar.set(int,int)




after
public boolean after(Object when)(Code)
Returns whether this Calendar represents a time after the time represented by the specified Object. This method is equivalent to:
compareTo(when) > 0
if and only if when is a Calendar instance. Otherwise, the method returns false.
Parameters:
  when - the Object to be compared true if the time of this Calendar isafter the time represented by when; falseotherwise.
See Also:   Calendar.compareTo(Calendar)



before
public boolean before(Object when)(Code)
Returns whether this Calendar represents a time before the time represented by the specified Object. This method is equivalent to:
compareTo(when) < 0
if and only if when is a Calendar instance. Otherwise, the method returns false.
Parameters:
  when - the Object to be compared true if the time of thisCalendar is before the time represented bywhen; false otherwise.
See Also:   Calendar.compareTo(Calendar)



checkDisplayNameParams
boolean checkDisplayNameParams(int field, int style, int minStyle, int maxStyle, Locale locale, int fieldMask)(Code)



clear
final public void clear()(Code)
Sets all the calendar field values and the time value (millisecond offset from the Epoch) of this Calendar undefined. This means that Calendar.isSet(int) isSet() will return false for all the calendar fields, and the date and time calculations will treat the fields as if they had never been set. A Calendar implementation class may use its specific default field values for date/time calculations. For example, GregorianCalendar uses 1970 if the YEAR field value is undefined.
See Also:   Calendar.clear(int)



clear
final public void clear(int field)(Code)
Sets the given calendar field value and the time value (millisecond offset from the Epoch) of this Calendar undefined. This means that Calendar.isSet(int) isSet(field) will return false, and the date and time calculations will treat the field as if it had never been set. A Calendar implementation class may use the field's specific default value for date and time calculations.

The Calendar.HOUR_OF_DAY , Calendar.HOUR and Calendar.AM_PM fields are handled independently and the the resolution rule for the time of day is applied. Clearing one of the fields doesn't reset the hour of day value of this Calendar. Use Calendar.set(int,int) set(Calendar.HOUR_OF_DAY, 0) to reset the hour value.
Parameters:
  field - the calendar field to be cleared.
See Also:   Calendar.clear()




clone
public Object clone()(Code)
Creates and returns a copy of this object. a copy of this object.



compareTo
public int compareTo(Calendar anotherCalendar)(Code)
Compares the time values (millisecond offsets from the Epoch) represented by two Calendar objects.
Parameters:
  anotherCalendar - the Calendar to be compared. the value 0 if the time represented by the argumentis equal to the time represented by this Calendar; a valueless than 0 if the time of this Calendar isbefore the time represented by the argument; and a value greater than0 if the time of this Calendar is after thetime represented by the argument.
exception:
  NullPointerException - if the specified Calendar isnull.
exception:
  IllegalArgumentException - if the time value of thespecified Calendar object can't be obtained due toany invalid calendar values.
since:
   1.5



complete
protected void complete()(Code)
Fills in any unset fields in the calendar fields. First, the Calendar.computeTime() method is called if the time value (millisecond offset from the Epoch) has not been calculated from calendar field values. Then, the Calendar.computeFields() method is called to calculate all calendar field values.



computeFields
abstract protected void computeFields()(Code)
Converts the current millisecond time value Calendar.time to calendar field values in Calendar.fields fields[] . This allows you to sync up the calendar field values with a new time that is set for the calendar. The time is not recomputed first; to recompute the time, then the fields, call the Calendar.complete() method.
See Also:   Calendar.computeTime()



computeTime
abstract protected void computeTime()(Code)
Converts the current calendar field values in Calendar.fields fields[] to the millisecond time value Calendar.time .
See Also:   Calendar.complete()
See Also:   Calendar.computeFields()



equals
public boolean equals(Object obj)(Code)
Compares this Calendar to the specified Object. The result is true if and only if the argument is a Calendar object of the same calendar system that represents the same time value (millisecond offset from the Epoch) under the same Calendar parameters as this object.

The Calendar parameters are the values represented by the isLenient, getFirstDayOfWeek, getMinimalDaysInFirstWeek and getTimeZone methods. If there is any difference in those parameters between the two Calendars, this method returns false.

Use the Calendar.compareTo(Calendar) compareTo method to compare only the time values.
Parameters:
  obj - the object to compare with. true if this object is equal to obj;false otherwise.




get
public int get(int field)(Code)
Returns the value of the given calendar field. In lenient mode, all calendar fields are normalized. In non-lenient mode, all calendar fields are validated and this method throws an exception if any calendar fields have out-of-range values. The normalization and validation are handled by the Calendar.complete() method, which process is calendar system dependent.
Parameters:
  field - the given calendar field. the value for the given calendar field.
throws:
  ArrayIndexOutOfBoundsException - if the specified field is out of range(field < 0 || field >= FIELD_COUNT).
See Also:   Calendar.set(int,int)
See Also:   Calendar.complete()



getActualMaximum
public int getActualMaximum(int field)(Code)
Returns the maximum value that the specified calendar field could have, given the time value of this Calendar. For example, the actual maximum value of the MONTH field is 12 in some years, and 13 in other years in the Hebrew calendar system.

The default implementation of this method uses an iterative algorithm to determine the actual maximum value for the calendar field. Subclasses should, if possible, override this with a more efficient implementation.
Parameters:
  field - the calendar field the maximum of the given calendar field for the timevalue of this Calendar
See Also:   Calendar.getMinimum(int)
See Also:   Calendar.getMaximum(int)
See Also:   Calendar.getGreatestMinimum(int)
See Also:   Calendar.getLeastMaximum(int)
See Also:   Calendar.getActualMinimum(int)
since:
   1.2




getActualMinimum
public int getActualMinimum(int field)(Code)
Returns the minimum value that the specified calendar field could have, given the time value of this Calendar.

The default implementation of this method uses an iterative algorithm to determine the actual minimum value for the calendar field. Subclasses should, if possible, override this with a more efficient implementation - in many cases, they can simply return getMinimum().
Parameters:
  field - the calendar field the minimum of the given calendar field for the timevalue of this Calendar
See Also:   Calendar.getMinimum(int)
See Also:   Calendar.getMaximum(int)
See Also:   Calendar.getGreatestMinimum(int)
See Also:   Calendar.getLeastMaximum(int)
See Also:   Calendar.getActualMaximum(int)
since:
   1.2




getAvailableLocales
public static synchronized Locale[] getAvailableLocales()(Code)
Returns an array of all locales for which the getInstance methods of this class can return localized instances. The array returned must contain at least a Locale instance equal to java.util.Locale.US Locale.US . An array of locales for which localizedCalendar instances are available.



getDisplayName
public String getDisplayName(int field, int style, Locale locale)(Code)
Returns the string representation of the calendar field value in the given style and locale. If no string representation is applicable, null is returned. This method calls Calendar.get(int) get(field) to get the calendar field value if the string representation is applicable to the given calendar field.

For example, if this Calendar is a GregorianCalendar and its date is 2005-01-01, then the string representation of the Calendar.MONTH field would be "January" in the long style in an English locale or "Jan" in the short style. However, no string representation would be available for the Calendar.DAY_OF_MONTH field, and this method would return null.

The default implementation supports the calendar fields for which a DateFormatSymbols has names in the given locale.
Parameters:
  field - the calendar field for which the string representationis returned
Parameters:
  style - the style applied to the string representation; one ofCalendar.SHORT or Calendar.LONG.
Parameters:
  locale - the locale for the string representation the string representation of the givenfield in the given style, ornull if no string representation isapplicable.
exception:
  IllegalArgumentException - if field or style is invalid,or if this Calendar is non-lenient and anyof the calendar fields have invalid values
exception:
  NullPointerException - if locale is null
since:
   1.6




getDisplayNames
public Map<String, Integer> getDisplayNames(int field, int style, Locale locale)(Code)
Returns a Map containing all names of the calendar field in the given style and locale and their corresponding field values. For example, if this Calendar is a GregorianCalendar , the returned map would contain "Jan" to Calendar.JANUARY , "Feb" to Calendar.FEBRUARY , and so on, in the style in an English locale.

The values of other calendar fields may be taken into account to determine a set of display names. For example, if this Calendar is a lunisolar calendar system and the year value given by the Calendar.YEAR field has a leap month, this method would return month names containing the leap month name, and month names are mapped to their values specific for the year.

The default implementation supports display names contained in a DateFormatSymbols . For example, if field is Calendar.MONTH and style is Calendar.ALL_STYLES , this method returns a Map containing all strings returned by DateFormatSymbols.getShortMonths and DateFormatSymbols.getMonths .
Parameters:
  field - the calendar field for which the display names are returned
Parameters:
  style - the style applied to the display names; one of Calendar.SHORT, Calendar.LONG, or Calendar.ALL_STYLES.
Parameters:
  locale - the locale for the display names a Map containing all display names instyle and locale and theirfield values, or null if no display namesare defined for field
exception:
  IllegalArgumentException - if field or style is invalid,or if this Calendar is non-lenient and anyof the calendar fields have invalid values
exception:
  NullPointerException - if locale is null
since:
   1.6




getFieldName
final static String getFieldName(int field)(Code)
Returns the name of the specified calendar field.
Parameters:
  field - the calendar field the calendar field name
exception:
  IndexOutOfBoundsException - if field is negative,equal to or greater then FIELD_COUNT.



getFirstDayOfWeek
public int getFirstDayOfWeek()(Code)
Gets what the first day of the week is; e.g., SUNDAY in the U.S., MONDAY in France. the first day of the week.
See Also:   Calendar.setFirstDayOfWeek(int)
See Also:   Calendar.getMinimalDaysInFirstWeek()



getGreatestMinimum
abstract public int getGreatestMinimum(int field)(Code)
Returns the highest minimum value for the given calendar field of this Calendar instance. The highest minimum value is defined as the largest value returned by Calendar.getActualMinimum(int) for any possible time value. The greatest minimum value depends on calendar system specific parameters of the instance.
Parameters:
  field - the calendar field. the highest minimum value for the given calendar field.
See Also:   Calendar.getMinimum(int)
See Also:   Calendar.getMaximum(int)
See Also:   Calendar.getLeastMaximum(int)
See Also:   Calendar.getActualMinimum(int)
See Also:   Calendar.getActualMaximum(int)



getInstance
public static Calendar getInstance()(Code)
Gets a calendar using the default time zone and locale. The Calendar returned is based on the current time in the default time zone with the default locale. a Calendar.



getInstance
public static Calendar getInstance(TimeZone zone)(Code)
Gets a calendar using the specified time zone and default locale. The Calendar returned is based on the current time in the given time zone with the default locale.
Parameters:
  zone - the time zone to use a Calendar.



getInstance
public static Calendar getInstance(Locale aLocale)(Code)
Gets a calendar using the default time zone and specified locale. The Calendar returned is based on the current time in the default time zone with the given locale.
Parameters:
  aLocale - the locale for the week data a Calendar.



getInstance
public static Calendar getInstance(TimeZone zone, Locale aLocale)(Code)
Gets a calendar with the specified time zone and locale. The Calendar returned is based on the current time in the given time zone with the given locale.
Parameters:
  zone - the time zone to use
Parameters:
  aLocale - the locale for the week data a Calendar.



getLeastMaximum
abstract public int getLeastMaximum(int field)(Code)
Returns the lowest maximum value for the given calendar field of this Calendar instance. The lowest maximum value is defined as the smallest value returned by Calendar.getActualMaximum(int) for any possible time value. The least maximum value depends on calendar system specific parameters of the instance. For example, a Calendar for the Gregorian calendar system returns 28 for the DAY_OF_MONTH field, because the 28th is the last day of the shortest month of this calendar, February in a common year.
Parameters:
  field - the calendar field. the lowest maximum value for the given calendar field.
See Also:   Calendar.getMinimum(int)
See Also:   Calendar.getMaximum(int)
See Also:   Calendar.getGreatestMinimum(int)
See Also:   Calendar.getActualMinimum(int)
See Also:   Calendar.getActualMaximum(int)



getMaximum
abstract public int getMaximum(int field)(Code)
Returns the maximum value for the given calendar field of this Calendar instance. The maximum value is defined as the largest value returned by the Calendar.get(int) get method for any possible time value. The maximum value depends on calendar system specific parameters of the instance.
Parameters:
  field - the calendar field. the maximum value for the given calendar field.
See Also:   Calendar.getMinimum(int)
See Also:   Calendar.getGreatestMinimum(int)
See Also:   Calendar.getLeastMaximum(int)
See Also:   Calendar.getActualMinimum(int)
See Also:   Calendar.getActualMaximum(int)



getMinimalDaysInFirstWeek
public int getMinimalDaysInFirstWeek()(Code)
Gets what the minimal days required in the first week of the year are; e.g., if the first week is defined as one that contains the first day of the first month of a year, this method returns 1. If the minimal days required must be a full week, this method returns 7. the minimal days required in the first week of the year.
See Also:   Calendar.setMinimalDaysInFirstWeek(int)



getMinimum
abstract public int getMinimum(int field)(Code)
Returns the minimum value for the given calendar field of this Calendar instance. The minimum value is defined as the smallest value returned by the Calendar.get(int) get method for any possible time value. The minimum value depends on calendar system specific parameters of the instance.
Parameters:
  field - the calendar field. the minimum value for the given calendar field.
See Also:   Calendar.getMaximum(int)
See Also:   Calendar.getGreatestMinimum(int)
See Also:   Calendar.getLeastMaximum(int)
See Also:   Calendar.getActualMinimum(int)
See Also:   Calendar.getActualMaximum(int)



getSetStateFields
final int getSetStateFields()(Code)
Returns a field mask (bit mask) indicating all calendar fields that have the state of externally or internally set. a bit mask indicating set state fields



getTime
final public Date getTime()(Code)
Returns a Date object representing this Calendar's time value (millisecond offset from the Epoch"). a Date representing the time value.
See Also:   Calendar.setTime(Date)
See Also:   Calendar.getTimeInMillis()



getTimeInMillis
public long getTimeInMillis()(Code)
Returns this Calendar's time value in milliseconds. the current time as UTC milliseconds from the epoch.
See Also:   Calendar.getTime()
See Also:   Calendar.setTimeInMillis(long)



getTimeZone
public TimeZone getTimeZone()(Code)
Gets the time zone. the time zone object associated with this calendar.



getZone
TimeZone getZone()(Code)
Returns the time zone (without cloning).



hashCode
public int hashCode()(Code)
Returns a hash code for this calendar. a hash code value for this object.
since:
   1.2



internalGet
final protected int internalGet(int field)(Code)
Returns the value of the given calendar field. This method does not involve normalization or validation of the field value.
Parameters:
  field - the given calendar field. the value for the given calendar field.
See Also:   Calendar.get(int)



internalSet
final void internalSet(int field, int value)(Code)
Sets the value of the given calendar field. This method does not affect any setting state of the field in this Calendar instance.
throws:
  IndexOutOfBoundsException - if the specified field is out of range(field < 0 || field >= FIELD_COUNT).
See Also:   Calendar.areFieldsSet
See Also:   Calendar.isTimeSet
See Also:   Calendar.areAllFieldsSet
See Also:   Calendar.set(int,int)



isExternallySet
final boolean isExternallySet(int field)(Code)
Returns whether the value of the specified calendar field has been set externally by calling one of the setter methods rather than by the internal time calculation. true if the field has been set externally,false otherwise.
exception:
  IndexOutOfBoundsException - if the specifiedfield is out of range(field < 0 || field >= FIELD_COUNT).
See Also:   Calendar.selectFields()
See Also:   Calendar.setFieldsComputed(int)



isFieldSet
final static boolean isFieldSet(int fieldMask, int field)(Code)
Returns whether the specified field is on in the fieldMask.



isFullyNormalized
final boolean isFullyNormalized()(Code)
Returns whether the calendar fields are fully in sync with the time value.



isLenient
public boolean isLenient()(Code)
Tells whether date/time interpretation is to be lenient. true if the interpretation mode of this calendar is lenient;false otherwise.
See Also:   Calendar.setLenient(boolean)



isPartiallyNormalized
final boolean isPartiallyNormalized()(Code)
Returns whether the calendar fields are partially in sync with the time value or fully in sync but not stamp values are not normalized yet.



isSet
final public boolean isSet(int field)(Code)
Determines if the given calendar field has a value set, including cases that the value has been set by internal fields calculations triggered by a get method call. true if the given calendar field has a value set;false otherwise.



roll
abstract public void roll(int field, boolean up)(Code)
Adds or subtracts (up/down) a single unit of time on the given time field without changing larger fields. For example, to roll the current date up by one day, you can achieve it by calling:

roll(Calendar.DATE, true). When rolling on the year or Calendar.YEAR field, it will roll the year value in the range between 1 and the value returned by calling getMaximum(Calendar.YEAR). When rolling on the month or Calendar.MONTH field, other fields like date might conflict and, need to be changed. For instance, rolling the month on the date 01/31/96 will result in 02/29/96. When rolling on the hour-in-day or Calendar.HOUR_OF_DAY field, it will roll the hour value in the range between 0 and 23, which is zero-based.
Parameters:
  field - the time field.
Parameters:
  up - indicates if the value of the specified time field is to berolled up or rolled down. Use true if rolling up, false otherwise.
See Also:   Calendar.add(intint)
See Also:   Calendar.set(intint)




roll
public void roll(int field, int amount)(Code)
Adds the specified (signed) amount to the specified calendar field without changing larger fields. A negative amount means to roll down.

NOTE: This default implementation on Calendar just repeatedly calls the version of Calendar.roll(int,boolean) roll() that rolls by one unit. This may not always do the right thing. For example, if the DAY_OF_MONTH field is 31, rolling through February will leave it set to 28. The GregorianCalendar version of this function takes care of this problem. Other subclasses should also provide overrides of this function that do the right thing.
Parameters:
  field - the calendar field.
Parameters:
  amount - the signed amount to add to the calendar field.
since:
   1.2
See Also:   Calendar.roll(int,boolean)
See Also:   Calendar.add(int,int)
See Also:   Calendar.set(int,int)




selectFields
final int selectFields()(Code)
Returns a field mask indicating which calendar field values to be used to calculate the time value. The calendar fields are returned as a bit mask, each bit of which corresponds to a field, i.e., the mask value of field is (1 << field). For example, 0x26 represents the YEAR, MONTH, and DAY_OF_MONTH fields (i.e., 0x26 is equal to (1<<YEAR)|(1<<MONTH)|(1<<DAY_OF_MONTH)).

This method supports the calendar fields resolution as described in the class description. If the bit mask for a given field is on and its field has not been set (i.e., isSet(field) is false), then the default value of the field has to be used, which case means that the field has been selected because the selected combination involves the field. a bit mask of selected fields
See Also:   Calendar.isExternallySet(int)
See Also:   Calendar.setInternallySetState(int)




set
public void set(int field, int value)(Code)
Sets the given calendar field to the given value. The value is not interpreted by this method regardless of the leniency mode.
Parameters:
  field - the given calendar field.
Parameters:
  value - the value to be set for the given calendar field.
throws:
  ArrayIndexOutOfBoundsException - if the specified field is out of range(field < 0 || field >= FIELD_COUNT).in non-lenient mode.
See Also:   Calendar.set(int,int,int)
See Also:   Calendar.set(int,int,int,int,int)
See Also:   Calendar.set(int,int,int,int,int,int)
See Also:   Calendar.get(int)



set
final public void set(int year, int month, int date)(Code)
Sets the values for the calendar fields YEAR, MONTH, and DAY_OF_MONTH. Previous values of other calendar fields are retained. If this is not desired, call Calendar.clear() first.
Parameters:
  year - the value used to set the YEAR calendar field.
Parameters:
  month - the value used to set the MONTH calendar field.Month value is 0-based. e.g., 0 for January.
Parameters:
  date - the value used to set the DAY_OF_MONTH calendar field.
See Also:   Calendar.set(int,int)
See Also:   Calendar.set(int,int,int,int,int)
See Also:   Calendar.set(int,int,int,int,int,int)



set
final public void set(int year, int month, int date, int hourOfDay, int minute)(Code)
Sets the values for the calendar fields YEAR, MONTH, DAY_OF_MONTH, HOUR_OF_DAY, and MINUTE. Previous values of other fields are retained. If this is not desired, call Calendar.clear() first.
Parameters:
  year - the value used to set the YEAR calendar field.
Parameters:
  month - the value used to set the MONTH calendar field.Month value is 0-based. e.g., 0 for January.
Parameters:
  date - the value used to set the DAY_OF_MONTH calendar field.
Parameters:
  hourOfDay - the value used to set the HOUR_OF_DAY calendar field.
Parameters:
  minute - the value used to set the MINUTE calendar field.
See Also:   Calendar.set(int,int)
See Also:   Calendar.set(int,int,int)
See Also:   Calendar.set(int,int,int,int,int,int)



set
final public void set(int year, int month, int date, int hourOfDay, int minute, int second)(Code)
Sets the values for the fields YEAR, MONTH, DAY_OF_MONTH, HOUR, MINUTE, and SECOND. Previous values of other fields are retained. If this is not desired, call Calendar.clear() first.
Parameters:
  year - the value used to set the YEAR calendar field.
Parameters:
  month - the value used to set the MONTH calendar field.Month value is 0-based. e.g., 0 for January.
Parameters:
  date - the value used to set the DAY_OF_MONTH calendar field.
Parameters:
  hourOfDay - the value used to set the HOUR_OF_DAY calendar field.
Parameters:
  minute - the value used to set the MINUTE calendar field.
Parameters:
  second - the value used to set the SECOND calendar field.
See Also:   Calendar.set(int,int)
See Also:   Calendar.set(int,int,int)
See Also:   Calendar.set(int,int,int,int,int)



setFieldsComputed
final void setFieldsComputed(int fieldMask)(Code)
Sets the state of the specified calendar fields to computed. This state means that the specified calendar fields have valid values that have been set by internal time calculation rather than by calling one of the setter methods.
Parameters:
  fieldMask - the field to be marked as computed.
exception:
  IndexOutOfBoundsException - if the specifiedfield is out of range(field < 0 || field >= FIELD_COUNT).
See Also:   Calendar.isExternallySet(int)
See Also:   Calendar.selectFields()



setFieldsNormalized
final void setFieldsNormalized(int fieldMask)(Code)
Sets the state of the calendar fields that are not specified by fieldMask to unset. If fieldMask specifies all the calendar fields, then the state of this Calendar becomes that all the calendar fields are in sync with the time value (millisecond offset from the Epoch).
Parameters:
  fieldMask - the field mask indicating which calendar fields are insync with the time value.
exception:
  IndexOutOfBoundsException - if the specifiedfield is out of range(field < 0 || field >= FIELD_COUNT).
See Also:   Calendar.isExternallySet(int)
See Also:   Calendar.selectFields()



setFirstDayOfWeek
public void setFirstDayOfWeek(int value)(Code)
Sets what the first day of the week is; e.g., SUNDAY in the U.S., MONDAY in France.
Parameters:
  value - the given first day of the week.
See Also:   Calendar.getFirstDayOfWeek()
See Also:   Calendar.getMinimalDaysInFirstWeek()



setLenient
public void setLenient(boolean lenient)(Code)
Specifies whether or not date/time interpretation is to be lenient. With lenient interpretation, a date such as "February 942, 1996" will be treated as being equivalent to the 941st day after February 1, 1996. With strict (non-lenient) interpretation, such dates will cause an exception to be thrown. The default is lenient.
Parameters:
  lenient - true if the lenient mode is to be turnedon; false if it is to be turned off.
See Also:   Calendar.isLenient()
See Also:   java.text.DateFormat.setLenient



setMinimalDaysInFirstWeek
public void setMinimalDaysInFirstWeek(int value)(Code)
Sets what the minimal days required in the first week of the year are; For example, if the first week is defined as one that contains the first day of the first month of a year, call this method with value 1. If it must be a full week, use value 7.
Parameters:
  value - the given minimal days required in the first weekof the year.
See Also:   Calendar.getMinimalDaysInFirstWeek()



setTime
final public void setTime(Date date)(Code)
Sets this Calendar's time with the given Date.

Note: Calling setTime() with Date(Long.MAX_VALUE) or Date(Long.MIN_VALUE) may yield incorrect field values from get().
Parameters:
  date - the given Date.
See Also:   Calendar.getTime()
See Also:   Calendar.setTimeInMillis(long)




setTimeInMillis
public void setTimeInMillis(long millis)(Code)
Sets this Calendar's current time from the given long value.
Parameters:
  millis - the new time in UTC milliseconds from the epoch.
See Also:   Calendar.setTime(Date)
See Also:   Calendar.getTimeInMillis()



setTimeZone
public void setTimeZone(TimeZone value)(Code)
Sets the time zone with the given time zone value.
Parameters:
  value - the given time zone.



setUnnormalized
final void setUnnormalized()(Code)
Marks this Calendar as not sync'd.



setZoneShared
void setZoneShared(boolean shared)(Code)
Sets the sharedZone flag to shared.



toString
public String toString()(Code)
Return a string representation of this calendar. This method is intended to be used only for debugging purposes, and the format of the returned string may vary between implementations. The returned string may be empty but may not be null. a string representation of this calendar.



Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.