<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<!--NewPage-->
<html>
<head>
<!-- Generated by javadoc on Wed Jul 28 01:21:15 GMT 1999 -->
<title>
  Class java.util.Calendar
</title>
</head>
<body>
<a name="_top_"></a>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.util.html">This Package</a>  <a href="java.util.BitSet.html#_top_">Previous</a>  <a href="java.util.Date.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
<hr>
<h1>
  Class java.util.Calendar
</h1>
<pre>
<a href="java.lang.Object.html#_top_">java.lang.Object</a>
   |
   +----java.util.Calendar
</pre>
<hr>
<dl>
  <dt> public abstract class <b>Calendar</b>
  <dt> extends <a href="java.lang.Object.html#_top_">Object</a>
  <dt> implements <a href="java.io.Serializable.html#_top_">Serializable</a>, <a href="java.lang.Cloneable.html#_top_">Cloneable</a>
</dl>
<code>Calendar</code> is an abstract base class for converting between
 a <code>Date</code> object and a set of integer fields such as
 <code>YEAR</code>, <code>MONTH</code>, <code>DAY</code>, <code>HOUR</code>,
 and so on. (A <code>Date</code> object represents a specific instant in
 time with millisecond precision. See
 <a href="java.util.Date.html"><code>java.util.Date</code></a>
 for information about the <code>Date</code> class.)
 <p>
 Subclasses of <code>Calendar</code> interpret a <code>Date</code>
 according to the rules of a specific calendar system. The JDK
 provides one concrete subclass of <code>Calendar</code>:
 <code>GregorianCalendar</code>. Future subclasses could represent
 the various types of lunar calendars in use in many parts of the world.
 <p>
 Like other locale-sensitive classes, <code>Calendar</code> provides a
 class method, <code>getInstance</code>, for getting a generally useful
 object of this type. <code>Calendar</code>'s <code>getInstance</code> method
 returns a <code>GregorianCalendar</code> object whose
 time fields have been initialized with the current date and time:
 <blockquote>
 <pre>
 Calendar rightNow = Calendar.getInstance();
 </pre>
 </blockquote>
 <p>
 A <code>Calendar</code> object can produce all the time field values
 needed to implement the date-time formatting for a particular language
 and calendar style (for example, Japanese-Gregorian, Japanese-Traditional).
 <p>
 When computing a <code>Date</code> from time fields, two special circumstances
 may arise: there may be insufficient information to compute the
 <code>Date</code> (such as only year and month but no day in the month),
 or there may be inconsistent information (such as "Tuesday, July 15, 1996"
 -- July 15, 1996 is actually a Monday).
 <p>
 <strong>Insufficient information.</strong> The calendar will use default
 information to specify the missing fields. This may vary by calendar; for
 the Gregorian calendar, the default for a field is the same as that of the
 start of the epoch: i.e., YEAR = 1970, MONTH = JANUARY, DATE = 1, etc.
 <p>
 <strong>Inconsistent information.</strong> If fields conflict, the calendar
 will give preference to fields set more recently. For example, when
 determining the day, the calendar will look for one of the following
 combinations of fields.  The most recent combination, as determined by the
 most recently set single field, will be used.
 <blockquote>
 <pre>
 MONTH + DAY_OF_MONTH
 MONTH + WEEK_OF_MONTH + DAY_OF_WEEK
 MONTH + DAY_OF_WEEK_IN_MONTH + DAY_OF_WEEK
 DAY_OF_YEAR
 DAY_OF_WEEK + WEEK_OF_YEAR
 </pre>
 </blockquote>
 For the time of day:
 <blockquote>
 <pre>
 HOUR_OF_DAY
 AM_PM + HOUR
 </pre>
 </blockquote>
 <p>
 <strong>Note:</strong> for some non-Gregorian calendars, different
 fields may be necessary for complete disambiguation. For example, a full
 specification of the historial Arabic astronomical calendar requires year,
 month, day-of-month <em>and</em> day-of-week in some cases.
 <p>
 <strong>Note:</strong> There are certain possible ambiguities in
 interpretation of certain singular times, which are resolved in the
 following ways:
 <ol>
     <li> 24:00:00 "belongs" to the following day. That is,
          23:59 on Dec 31, 1969 &lt; 24:00 on Jan 1, 1970 &lt; 24:01:00 on Jan 1, 1970
     <li> Although historically not precise, midnight also belongs to "am",
          and noon belongs to "pm", so on the same day,
          12:00 am (midnight) &lt; 12:01 am, and 12:00 pm (noon) &lt; 12:01 pm
 </ol>
 <p>
 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 <a href="java.text.DateFormat.html">java.text.DateFormat</a>
 to format dates.
 <p>
 <code>Calendar</code> provides an API for field "rolling", where fields
 can be incremented or decremented, but wrap around. For example, rolling the
 month up in the date "September 12, 1996" results in "October 12, 1996".
 <p>
 <code>Calendar</code> also provides a date arithmetic function for
 adding the specified (signed) amount of time to a particular time field.
 For example, subtracting 5 days from the date "September 12, 1996" results
 in "September 7, 1996".
<p>
<dl>
    <dt> <b>See Also:</b>
    <dd> <a href="java.util.Date.html#_top_">Date</a>, <a href="java.util.GregorianCalendar.html#_top_">GregorianCalendar</a>, <a href="java.util.TimeZone.html#_top_">TimeZone</a>, <a href="java.text.DateFormat.html#_top_">DateFormat</a>
</dl>
<hr>
<a name="index"></a>
<h2>
  <img src="images/variable-index.gif" width=207 height=38 alt="Variable Index">
</h2>
<dl>
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#AM"><b>AM</b></a>
  <dd>  Useful constant for hour in 12-hour clock.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#AM_PM"><b>AM_PM</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#APRIL"><b>APRIL</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/magenta-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#areFieldsSet"><b>areFieldsSet</b></a>
  <dd>  True if the fields are in sync with the currently set time of this Calendar.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#AUGUST"><b>AUGUST</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#DATE"><b>DATE</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#DAY_OF_MONTH"><b>DAY_OF_MONTH</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#DAY_OF_WEEK"><b>DAY_OF_WEEK</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#DAY_OF_WEEK_IN_MONTH"><b>DAY_OF_WEEK_IN_MONTH</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#DAY_OF_YEAR"><b>DAY_OF_YEAR</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#DECEMBER"><b>DECEMBER</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#DST_OFFSET"><b>DST_OFFSET</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#ERA"><b>ERA</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#FEBRUARY"><b>FEBRUARY</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#FIELD_COUNT"><b>FIELD_COUNT</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/magenta-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#fields"><b>fields</b></a>
  <dd>  The time fields containing values into which the millis is computed.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#FRIDAY"><b>FRIDAY</b></a>
  <dd>  Useful constant for days of week.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#HOUR"><b>HOUR</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#HOUR_OF_DAY"><b>HOUR_OF_DAY</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/magenta-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#isSet"><b>isSet</b></a>
  <dd>  The flags which tell if a specified time field for the calendar is set.
  <dt> <img src="images/magenta-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#isTimeSet"><b>isTimeSet</b></a>
  <dd>  The flag which indicates if the current time is set for the calendar.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#JANUARY"><b>JANUARY</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#JULY"><b>JULY</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#JUNE"><b>JUNE</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#MARCH"><b>MARCH</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#MAY"><b>MAY</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#MILLISECOND"><b>MILLISECOND</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#MINUTE"><b>MINUTE</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#MONDAY"><b>MONDAY</b></a>
  <dd>  Useful constant for days of week.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#MONTH"><b>MONTH</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#NOVEMBER"><b>NOVEMBER</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#OCTOBER"><b>OCTOBER</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#PM"><b>PM</b></a>
  <dd>  Useful constant for hour in 12-hour clock.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#SATURDAY"><b>SATURDAY</b></a>
  <dd>  Useful constant for days of week.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#SECOND"><b>SECOND</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#SEPTEMBER"><b>SEPTEMBER</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#SUNDAY"><b>SUNDAY</b></a>
  <dd>  Useful constant for days of week.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#THURSDAY"><b>THURSDAY</b></a>
  <dd>  Useful constant for days of week.
  <dt> <img src="images/magenta-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#time"><b>time</b></a>
  <dd>  The current time set for the calendar.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#TUESDAY"><b>TUESDAY</b></a>
  <dd>  Useful constant for days of week.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#UNDECIMBER"><b>UNDECIMBER</b></a>
  <dd>  Useful constant for month.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#WEDNESDAY"><b>WEDNESDAY</b></a>
  <dd>  Useful constant for days of week.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#WEEK_OF_MONTH"><b>WEEK_OF_MONTH</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#WEEK_OF_YEAR"><b>WEEK_OF_YEAR</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#YEAR"><b>YEAR</b></a>
  <dd>  Useful constant for date and time.
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#ZONE_OFFSET"><b>ZONE_OFFSET</b></a>
  <dd>  Useful constant for date and time.
</dl>
<h2>
  <img src="images/constructor-index.gif" width=275 height=38 alt="Constructor Index">
</h2>
<dl>
  <dt> <img src="images/yellow-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#Calendar()"><b>Calendar</b></a>()
  <dd>  Constructs a Calendar with the default time zone as returned
 by TimeZone.getDefault(), and the default locale.
  <dt> <img src="images/yellow-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#Calendar(java.util.TimeZone, java.util.Locale)"><b>Calendar</b></a>(TimeZone, Locale)
  <dd>  Constructs a Calendar with the given time zone and locale.
</dl>
<h2>
  <img src="images/method-index.gif" width=207 height=38 alt="Method Index">
</h2>
<dl>
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#add(int, int)"><b>add</b></a>(int, int)
  <dd>  Date Arithmetic function.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#after(java.lang.Object)"><b>after</b></a>(Object)
  <dd>  Compares the time field records.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#before(java.lang.Object)"><b>before</b></a>(Object)
  <dd>  Compares the time field records.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#clear()"><b>clear</b></a>()
  <dd>  Clears the values of all the time fields.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#clear(int)"><b>clear</b></a>(int)
  <dd>  Clears the value in the given time field.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#clone()"><b>clone</b></a>()
  <dd>  Overrides Cloneable

  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#complete()"><b>complete</b></a>()
  <dd>  Fills in any unset fields in the time field list.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#computeFields()"><b>computeFields</b></a>()
  <dd>  Converts UTC as milliseconds to time field values.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#computeTime()"><b>computeTime</b></a>()
  <dd>  Converts Calendar's time field values to UTC as milliseconds.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#equals(java.lang.Object)"><b>equals</b></a>(Object)
  <dd>  Compares this calendar to the specified object.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#get(int)"><b>get</b></a>(int)
  <dd>  Gets the value for a given time field.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getAvailableLocales()"><b>getAvailableLocales</b></a>()
  <dd>  Gets the set of locales for which Calendars are installed.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getFirstDayOfWeek()"><b>getFirstDayOfWeek</b></a>()
  <dd>  Gets what the first day of the week is; e.g., Sunday in US,
 Monday in France.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getGreatestMinimum(int)"><b>getGreatestMinimum</b></a>(int)
  <dd>  Gets the highest minimum value for the given field if varies.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getInstance()"><b>getInstance</b></a>()
  <dd>  Gets a Calendar using the default timezone and locale.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getInstance(java.util.Locale)"><b>getInstance</b></a>(Locale)
  <dd>  Gets a Calendar using the default timezone and given locale.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getInstance(java.util.TimeZone)"><b>getInstance</b></a>(TimeZone)
  <dd>  Gets a Calendar using the given timezone and default locale.
  <dt> <img src="images/green-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getInstance(java.util.TimeZone, java.util.Locale)"><b>getInstance</b></a>(TimeZone, Locale)
  <dd>  Gets a Calendar using the given timezone and given locale.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getLeastMaximum(int)"><b>getLeastMaximum</b></a>(int)
  <dd>  Gets the lowest maximum value for the given field if varies.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getMaximum(int)"><b>getMaximum</b></a>(int)
  <dd>  Gets the maximum value for the given time field.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getMinimalDaysInFirstWeek()"><b>getMinimalDaysInFirstWeek</b></a>()
  <dd>  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, getMinimalDaysInFirstWeek returns 1.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getMinimum(int)"><b>getMinimum</b></a>(int)
  <dd>  Gets the minimum value for the given time field.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getTime()"><b>getTime</b></a>()
  <dd>  Gets this Calendar's current time.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getTimeInMillis()"><b>getTimeInMillis</b></a>()
  <dd>  Gets this Calendar's current time as a long.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#getTimeZone()"><b>getTimeZone</b></a>()
  <dd>  Gets the time zone.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#internalGet(int)"><b>internalGet</b></a>(int)
  <dd>  Gets the value for a given time field.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#isLenient()"><b>isLenient</b></a>()
  <dd>  Tell whether date/time interpretation is to be lenient.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#isSet(int)"><b>isSet</b></a>(int)
  <dd>  Determines if the given time field has a value set.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#roll(int, boolean)"><b>roll</b></a>(int, boolean)
  <dd>  Time Field Rolling function.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#set(int, int)"><b>set</b></a>(int, int)
  <dd>  Sets the time field with the given value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#set(int, int, int)"><b>set</b></a>(int, int, int)
  <dd>  Sets the values for the fields year, month, and date.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#set(int, int, int, int, int)"><b>set</b></a>(int, int, int, int, int)
  <dd>  Sets the values for the fields year, month, date, hour, and minute.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#set(int, int, int, int, int, int)"><b>set</b></a>(int, int, int, int, int, int)
  <dd>  Sets the values for the fields year, month, date, hour, minute, and second.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setFirstDayOfWeek(int)"><b>setFirstDayOfWeek</b></a>(int)
  <dd>  Sets what the first day of the week is; e.g., Sunday in US,
 Monday in France.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setLenient(boolean)"><b>setLenient</b></a>(boolean)
  <dd>  Specify whether or not date/time interpretation is to be lenient.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setMinimalDaysInFirstWeek(int)"><b>setMinimalDaysInFirstWeek</b></a>(int)
  <dd>  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 the method with value 1.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setTime(java.util.Date)"><b>setTime</b></a>(Date)
  <dd>  Sets this Calendar's current time with the given Date.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setTimeInMillis(long)"><b>setTimeInMillis</b></a>(long)
  <dd>  Sets this Calendar's current time from the given long value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#setTimeZone(java.util.TimeZone)"><b>setTimeZone</b></a>(TimeZone)
  <dd>  Sets the time zone with the given time zone value.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#toString()"><b>toString</b></a>()
  <dd>  Return a string representation of this calendar.
</dl>
<a name="variables"></a>
<h2>
  <img src="images/variables.gif" width=153 height=38 alt="Variables">
</h2>
<a name="ERA"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>ERA</b>
<pre>
 public static final int ERA
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.
 ERA is calendar specific.<p>
</dl>
<a name="YEAR"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>YEAR</b>
<pre>
 public static final int YEAR
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="MONTH"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>MONTH</b>
<pre>
 public static final int MONTH
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="WEEK_OF_YEAR"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>WEEK_OF_YEAR</b>
<pre>
 public static final int WEEK_OF_YEAR
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="WEEK_OF_MONTH"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>WEEK_OF_MONTH</b>
<pre>
 public static final int WEEK_OF_MONTH
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="DATE"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>DATE</b>
<pre>
 public static final int DATE
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.
 This is a synonym for DAY_OF_MONTH.<p>
</dl>
<a name="DAY_OF_MONTH"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>DAY_OF_MONTH</b>
<pre>
 public static final int DAY_OF_MONTH
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.
 This is a synonym for DATE.<p>
</dl>
<a name="DAY_OF_YEAR"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>DAY_OF_YEAR</b>
<pre>
 public static final int DAY_OF_YEAR
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="DAY_OF_WEEK"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>DAY_OF_WEEK</b>
<pre>
 public static final int DAY_OF_WEEK
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="DAY_OF_WEEK_IN_MONTH"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>DAY_OF_WEEK_IN_MONTH</b>
<pre>
 public static final int DAY_OF_WEEK_IN_MONTH
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="AM_PM"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>AM_PM</b>
<pre>
 public static final int AM_PM
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="HOUR"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>HOUR</b>
<pre>
 public static final int HOUR
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.
 HOUR is used for the 12-hour clock.<p>
</dl>
<a name="HOUR_OF_DAY"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>HOUR_OF_DAY</b>
<pre>
 public static final int HOUR_OF_DAY
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.
 HOUR_OF_DAY is used for the 24-hour clock.<p>
</dl>
<a name="MINUTE"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>MINUTE</b>
<pre>
 public static final int MINUTE
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="SECOND"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>SECOND</b>
<pre>
 public static final int SECOND
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="MILLISECOND"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>MILLISECOND</b>
<pre>
 public static final int MILLISECOND
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="ZONE_OFFSET"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>ZONE_OFFSET</b>
<pre>
 public static final int ZONE_OFFSET
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="DST_OFFSET"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>DST_OFFSET</b>
<pre>
 public static final int DST_OFFSET
</pre>
<dl>
  <dd> Useful constant for date and time. Used in time fields.<p>
</dl>
<a name="FIELD_COUNT"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>FIELD_COUNT</b>
<pre>
 public static final int FIELD_COUNT
</pre>
<dl>
  <dd> Useful constant for date and time.
 FIELD_COUNT is used for the time field array creation.<p>
</dl>
<a name="SUNDAY"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>SUNDAY</b>
<pre>
 public static final int SUNDAY
</pre>
<dl>
  <dd> Useful constant for days of week. Used in GregorianCalendar.<p>
</dl>
<a name="MONDAY"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>MONDAY</b>
<pre>
 public static final int MONDAY
</pre>
<dl>
  <dd> Useful constant for days of week. Used in GregorianCalendar.<p>
</dl>
<a name="TUESDAY"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>TUESDAY</b>
<pre>
 public static final int TUESDAY
</pre>
<dl>
  <dd> Useful constant for days of week. Used in GregorianCalendar.<p>
</dl>
<a name="WEDNESDAY"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>WEDNESDAY</b>
<pre>
 public static final int WEDNESDAY
</pre>
<dl>
  <dd> Useful constant for days of week. Used in GregorianCalendar.<p>
</dl>
<a name="THURSDAY"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>THURSDAY</b>
<pre>
 public static final int THURSDAY
</pre>
<dl>
  <dd> Useful constant for days of week. Used in GregorianCalendar.<p>
</dl>
<a name="FRIDAY"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>FRIDAY</b>
<pre>
 public static final int FRIDAY
</pre>
<dl>
  <dd> Useful constant for days of week. Used in GregorianCalendar.<p>
</dl>
<a name="SATURDAY"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>SATURDAY</b>
<pre>
 public static final int SATURDAY
</pre>
<dl>
  <dd> Useful constant for days of week. Used in GregorianCalendar.<p>
</dl>
<a name="JANUARY"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>JANUARY</b>
<pre>
 public static final int JANUARY
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.
 Note: Calendar month is now 0-based.<p>
</dl>
<a name="FEBRUARY"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>FEBRUARY</b>
<pre>
 public static final int FEBRUARY
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.<p>
</dl>
<a name="MARCH"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>MARCH</b>
<pre>
 public static final int MARCH
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.<p>
</dl>
<a name="APRIL"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>APRIL</b>
<pre>
 public static final int APRIL
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.<p>
</dl>
<a name="MAY"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>MAY</b>
<pre>
 public static final int MAY
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.<p>
</dl>
<a name="JUNE"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>JUNE</b>
<pre>
 public static final int JUNE
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.<p>
</dl>
<a name="JULY"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>JULY</b>
<pre>
 public static final int JULY
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.<p>
</dl>
<a name="AUGUST"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>AUGUST</b>
<pre>
 public static final int AUGUST
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.<p>
</dl>
<a name="SEPTEMBER"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>SEPTEMBER</b>
<pre>
 public static final int SEPTEMBER
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.<p>
</dl>
<a name="OCTOBER"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>OCTOBER</b>
<pre>
 public static final int OCTOBER
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.<p>
</dl>
<a name="NOVEMBER"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>NOVEMBER</b>
<pre>
 public static final int NOVEMBER
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.<p>
</dl>
<a name="DECEMBER"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>DECEMBER</b>
<pre>
 public static final int DECEMBER
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.<p>
</dl>
<a name="UNDECIMBER"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>UNDECIMBER</b>
<pre>
 public static final int UNDECIMBER
</pre>
<dl>
  <dd> Useful constant for month. Used in GregorianCalendar.
 UNDECIMBER is an artifical name. This 13th month is for lunar
 calendars.<p>
</dl>
<a name="AM"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>AM</b>
<pre>
 public static final int AM
</pre>
<dl>
  <dd> Useful constant for hour in 12-hour clock. Used in GregorianCalendar.<p>
</dl>
<a name="PM"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>PM</b>
<pre>
 public static final int PM
</pre>
<dl>
  <dd> Useful constant for hour in 12-hour clock. Used in GregorianCalendar.<p>
</dl>
<a name="fields"><img src="images/magenta-ball.gif" width=12 height=12 alt=" o "></a>
<b>fields</b>
<pre>
 protected int fields[]
</pre>
<dl>
  <dd> The time fields containing values into which the millis is computed.<p>
</dl>
<a name="isSet"><img src="images/magenta-ball.gif" width=12 height=12 alt=" o "></a>
<b>isSet</b>
<pre>
 protected boolean isSet[]
</pre>
<dl>
  <dd> The flags which tell if a specified time 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.<p>
</dl>
<a name="time"><img src="images/magenta-ball.gif" width=12 height=12 alt=" o "></a>
<b>time</b>
<pre>
 protected long time
</pre>
<dl>
  <dd> The current time set for the calendar.<p>
</dl>
<a name="isTimeSet"><img src="images/magenta-ball.gif" width=12 height=12 alt=" o "></a>
<b>isTimeSet</b>
<pre>
 protected boolean isTimeSet
</pre>
<dl>
  <dd> The flag which indicates if the current time is set for the calendar.
 The time is made invalid by the user setting an individual field.<p>
</dl>
<a name="areFieldsSet"><img src="images/magenta-ball.gif" width=12 height=12 alt=" o "></a>
<b>areFieldsSet</b>
<pre>
 protected boolean areFieldsSet
</pre>
<dl>
  <dd> True if the fields are in sync with the currently set time of this Calendar.
 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 the time
 field.
 This should really be named areFieldsInSync, but the old name is retained
 for backward compatibility.<p>
</dl>
<a name="constructors"></a>
<h2>
  <img src="images/constructors.gif" width=231 height=38 alt="Constructors">
</h2>
<a name="Calendar"></a>
<a name="Calendar()"><img src="images/yellow-ball.gif" width=12 height=12 alt=" o "></a>
<b>Calendar</b>
<pre>
 protected Calendar()
</pre>
<dl>
  <dd> Constructs a Calendar with the default time zone as returned
 by TimeZone.getDefault(), and the default locale.
<p>
  <dd><dl>
    <dt> <b>See Also:</b>
    <dd> <a href="java.util.TimeZone.html#getDefault">getDefault</a>
  </dl></dd>
</dl>
<a name="Calendar(java.util.TimeZone, java.util.Locale)"><img src="images/yellow-ball.gif" width=12 height=12 alt=" o "></a>
<b>Calendar</b>
<pre>
 protected Calendar(<a href="java.util.TimeZone.html#_top_">TimeZone</a> zone,
                    <a href="java.util.Locale.html#_top_">Locale</a> aLocale)
</pre>
<dl>
  <dd> Constructs a Calendar with the given time zone and locale.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> zone - the given time zone.
  </dl></dd>
</dl>
<a name="methods"></a>
<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<a name="getInstance()"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getInstance"><b>getInstance</b></a>
<pre>
 public static synchronized <a href="#_top_">Calendar</a> getInstance()
</pre>
<dl>
  <dd> Gets a Calendar using the default timezone and locale.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> a Calendar.
  </dl></dd>
</dl>
<a name="getInstance(java.util.TimeZone)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getInstance"><b>getInstance</b></a>
<pre>
 public static synchronized <a href="#_top_">Calendar</a> getInstance(<a href="java.util.TimeZone.html#_top_">TimeZone</a> zone)
</pre>
<dl>
  <dd> Gets a Calendar using the given timezone and default locale.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> zone - the given timezone.
    <dt> <b>Returns:</b>
    <dd> a Calendar.
  </dl></dd>
</dl>
<a name="getInstance(java.util.Locale)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getInstance"><b>getInstance</b></a>
<pre>
 public static synchronized <a href="#_top_">Calendar</a> getInstance(<a href="java.util.Locale.html#_top_">Locale</a> aLocale)
</pre>
<dl>
  <dd> Gets a Calendar using the default timezone and given locale.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> aLocale - the given locale.
    <dt> <b>Returns:</b>
    <dd> a Calendar.
  </dl></dd>
</dl>
<a name="getInstance(java.util.TimeZone, java.util.Locale)"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getInstance"><b>getInstance</b></a>
<pre>
 public static synchronized <a href="#_top_">Calendar</a> getInstance(<a href="java.util.TimeZone.html#_top_">TimeZone</a> zone,
                                                 <a href="java.util.Locale.html#_top_">Locale</a> aLocale)
</pre>
<dl>
  <dd> Gets a Calendar using the given timezone and given locale.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> zone - the given timezone.
    <dd> aLocale - the given locale.
    <dt> <b>Returns:</b>
    <dd> a Calendar.
  </dl></dd>
</dl>
<a name="getAvailableLocales()"><img src="images/green-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getAvailableLocales"><b>getAvailableLocales</b></a>
<pre>
 public static synchronized <a href="java.util.Locale.html#_top_">Locale</a>[] getAvailableLocales()
</pre>
<dl>
  <dd> Gets the set of locales for which Calendars are installed.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> the set of locales for which Calendars are installed.
  </dl></dd>
</dl>
<a name="computeTime()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="computeTime"><b>computeTime</b></a>
<pre>
 protected abstract void computeTime()
</pre>
<dl>
  <dd> Converts Calendar's time field values to UTC as milliseconds.
<p>
</dl>
<a name="computeFields()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="computeFields"><b>computeFields</b></a>
<pre>
 protected abstract void computeFields()
</pre>
<dl>
  <dd> Converts UTC as milliseconds to time field values.
 This allows you to sync up the time field values with
 a new time that is set for the calendar.  The time is <em>not</em>
 recomputed first; to recompute the time, then the fields, call the
 <code>complete</code> method.
<p>
  <dd><dl>
    <dt> <b>See Also:</b>
    <dd> <a href="#complete">complete</a>
  </dl></dd>
</dl>
<a name="getTime()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getTime"><b>getTime</b></a>
<pre>
 public final <a href="java.util.Date.html#_top_">Date</a> getTime()
</pre>
<dl>
  <dd> Gets this Calendar's current time.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> the current time.
  </dl></dd>
</dl>
<a name="setTime(java.util.Date)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setTime"><b>setTime</b></a>
<pre>
 public final void setTime(<a href="java.util.Date.html#_top_">Date</a> date)
</pre>
<dl>
  <dd> Sets this Calendar's current time with the given Date.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> date - the given Date.
  </dl></dd>
</dl>
<a name="getTimeInMillis()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getTimeInMillis"><b>getTimeInMillis</b></a>
<pre>
 protected long getTimeInMillis()
</pre>
<dl>
  <dd> Gets this Calendar's current time as a long.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> the current time as UTC milliseconds from the epoch.
  </dl></dd>
</dl>
<a name="setTimeInMillis(long)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setTimeInMillis"><b>setTimeInMillis</b></a>
<pre>
 protected void setTimeInMillis(long millis)
</pre>
<dl>
  <dd> Sets this Calendar's current time from the given long value.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> date - the new time in UTC milliseconds from the epoch.
  </dl></dd>
</dl>
<a name="get(int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="get"><b>get</b></a>
<pre>
 public final int get(int field)
</pre>
<dl>
  <dd> Gets the value for a given time field.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> field - the given time field.
    <dt> <b>Returns:</b>
    <dd> the value for the given time field.
  </dl></dd>
</dl>
<a name="internalGet(int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="internalGet"><b>internalGet</b></a>
<pre>
 protected final int internalGet(int field)
</pre>
<dl>
  <dd> Gets the value for a given time field. This is an internal
 fast time field value getter for the subclasses.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> field - the given time field.
    <dt> <b>Returns:</b>
    <dd> the value for the given time field.
  </dl></dd>
</dl>
<a name="set(int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="set"><b>set</b></a>
<pre>
 public final void set(int field,
                       int value)
</pre>
<dl>
  <dd> Sets the time field with the given value.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> field - the given time field.
    <dd> value - the value to be set for the given time field.
  </dl></dd>
</dl>
<a name="set(int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="set"><b>set</b></a>
<pre>
 public final void set(int year,
                       int month,
                       int date)
</pre>
<dl>
  <dd> Sets the values for the fields year, month, and date.
 Previous values of other fields are retained.  If this is not desired,
 call <code>clear</code> first.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> year - the value used to set the YEAR time field.
    <dd> month - the value used to set the MONTH time field.
 Month value is 0-based. e.g., 0 for January.
    <dd> date - the value used to set the DATE time field.
  </dl></dd>
</dl>
<a name="set(int, int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="set"><b>set</b></a>
<pre>
 public final void set(int year,
                       int month,
                       int date,
                       int hour,
                       int minute)
</pre>
<dl>
  <dd> Sets the values for the fields year, month, date, hour, and minute.
 Previous values of other fields are retained.  If this is not desired,
 call <code>clear</code> first.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> year - the value used to set the YEAR time field.
    <dd> month - the value used to set the MONTH time field.
 Month value is 0-based. e.g., 0 for January.
    <dd> date - the value used to set the DATE time field.
    <dd> hour - the value used to set the HOUR_OF_DAY time field.
    <dd> minute - the value used to set the MINUTE time field.
  </dl></dd>
</dl>
<a name="set(int, int, int, int, int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="set"><b>set</b></a>
<pre>
 public final void set(int year,
                       int month,
                       int date,
                       int hour,
                       int minute,
                       int second)
</pre>
<dl>
  <dd> Sets the values for the fields year, month, date, hour, minute, and second.
 Previous values of other fields are retained.  If this is not desired,
 call <code>clear</code> first.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> year - the value used to set the YEAR time field.
    <dd> month - the value used to set the MONTH time field.
 Month value is 0-based. e.g., 0 for January.
    <dd> date - the value used to set the DATE time field.
    <dd> hour - the value used to set the HOUR_OF_DAY time field.
    <dd> minute - the value used to set the MINUTE time field.
    <dd> second - the value used to set the SECOND time field.
  </dl></dd>
</dl>
<a name="clear()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="clear"><b>clear</b></a>
<pre>
 public final void clear()
</pre>
<dl>
  <dd> Clears the values of all the time fields.
<p>
</dl>
<a name="clear(int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="clear"><b>clear</b></a>
<pre>
 public final void clear(int field)
</pre>
<dl>
  <dd> Clears the value in the given time field.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> field - the time field to be cleared.
  </dl></dd>
</dl>
<a name="isSet(int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="isSet"><b>isSet</b></a>
<pre>
 public final boolean isSet(int field)
</pre>
<dl>
  <dd> Determines if the given time field has a value set.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> true if the given time field has a value set; false otherwise.
  </dl></dd>
</dl>
<a name="complete()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="complete"><b>complete</b></a>
<pre>
 protected void complete()
</pre>
<dl>
  <dd> Fills in any unset fields in the time field list.
<p>
</dl>
<a name="equals(java.lang.Object)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="equals"><b>equals</b></a>
<pre>
 public abstract boolean equals(<a href="java.lang.Object.html#_top_">Object</a> obj)
</pre>
<dl>
  <dd> Compares this calendar to the specified object.
 The result is <code>true</code> if and only if the argument is
 not <code>null</code> and is a <code>Calendar</code> object that
 represents the same calendar as this object.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> obj - the object to compare with.
    <dt> <b>Returns:</b>
    <dd> <code>true</code> if the objects are the same;
 <code>false</code> otherwise.
    <dt> <b>Overrides:</b>
    <dd> <a href="java.lang.Object.html#equals(java.lang.Object)">equals</a> in class <a href="java.lang.Object.html#_top_">Object</a>
  </dl></dd>
</dl>
<a name="before(java.lang.Object)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="before"><b>before</b></a>
<pre>
 public abstract boolean before(<a href="java.lang.Object.html#_top_">Object</a> when)
</pre>
<dl>
  <dd> Compares the time field records.
 Equivalent to comparing result of conversion to UTC.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> when - the Calendar to be compared with this Calendar.
    <dt> <b>Returns:</b>
    <dd> true if the current time of this Calendar is before
 the time of Calendar when; false otherwise.
  </dl></dd>
</dl>
<a name="after(java.lang.Object)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="after"><b>after</b></a>
<pre>
 public abstract boolean after(<a href="java.lang.Object.html#_top_">Object</a> when)
</pre>
<dl>
  <dd> Compares the time field records.
 Equivalent to comparing result of conversion to UTC.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> when - the Calendar to be compared with this Calendar.
    <dt> <b>Returns:</b>
    <dd> true if the current time of this Calendar is after
 the time of Calendar when; false otherwise.
  </dl></dd>
</dl>
<a name="add(int, int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="add"><b>add</b></a>
<pre>
 public abstract void add(int field,
                          int amount)
</pre>
<dl>
  <dd> Date Arithmetic function.
 Adds the specified (signed) amount of time to the given time 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:
 <p>add(Calendar.DATE, -5).
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> field - the time field.
    <dd> amount - the amount of date or time to be added to the field.
  </dl></dd>
</dl>
<a name="roll(int, boolean)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="roll"><b>roll</b></a>
<pre>
 public abstract void roll(int field,
                           boolean up)
</pre>
<dl>
  <dd> Time Field Rolling function.
 Rolls (up/down) a single unit of time on the given time field. For
 example, to roll the current date up by one day, you can achieve it
 by calling:
 <p>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 03/02/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.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> field - the time field.
    <dd> up - indicates if the value of the specified time field is to be
 rolled up or rolled down. Use true if rolling up, false otherwise.
  </dl></dd>
</dl>
<a name="setTimeZone(java.util.TimeZone)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setTimeZone"><b>setTimeZone</b></a>
<pre>
 public void setTimeZone(<a href="java.util.TimeZone.html#_top_">TimeZone</a> value)
</pre>
<dl>
  <dd> Sets the time zone with the given time zone value.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> value - the given time zone.
  </dl></dd>
</dl>
<a name="getTimeZone()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getTimeZone"><b>getTimeZone</b></a>
<pre>
 public <a href="java.util.TimeZone.html#_top_">TimeZone</a> getTimeZone()
</pre>
<dl>
  <dd> Gets the time zone.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> the time zone object associated with this calendar.
  </dl></dd>
</dl>
<a name="setLenient(boolean)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setLenient"><b>setLenient</b></a>
<pre>
 public void setLenient(boolean lenient)
</pre>
<dl>
  <dd> Specify 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 interpretation, such dates will cause an exception to be
 thrown.
<p>
  <dd><dl>
    <dt> <b>See Also:</b>
    <dd> <a href="java.text.DateFormat.html#setLenient">setLenient</a>
  </dl></dd>
</dl>
<a name="isLenient()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="isLenient"><b>isLenient</b></a>
<pre>
 public boolean isLenient()
</pre>
<dl>
  <dd> Tell whether date/time interpretation is to be lenient.
<p>
</dl>
<a name="setFirstDayOfWeek(int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setFirstDayOfWeek"><b>setFirstDayOfWeek</b></a>
<pre>
 public void setFirstDayOfWeek(int value)
</pre>
<dl>
  <dd> Sets what the first day of the week is; e.g., Sunday in US,
 Monday in France.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> value - the given first day of the week.
  </dl></dd>
</dl>
<a name="getFirstDayOfWeek()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getFirstDayOfWeek"><b>getFirstDayOfWeek</b></a>
<pre>
 public int getFirstDayOfWeek()
</pre>
<dl>
  <dd> Gets what the first day of the week is; e.g., Sunday in US,
 Monday in France.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> the first day of the week.
  </dl></dd>
</dl>
<a name="setMinimalDaysInFirstWeek(int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="setMinimalDaysInFirstWeek"><b>setMinimalDaysInFirstWeek</b></a>
<pre>
 public void setMinimalDaysInFirstWeek(int value)
</pre>
<dl>
  <dd> 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 the method with value 1. If it
 must be a full week, use value 7.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> value - the given minimal days required in the first week
 of the year.
  </dl></dd>
</dl>
<a name="getMinimalDaysInFirstWeek()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getMinimalDaysInFirstWeek"><b>getMinimalDaysInFirstWeek</b></a>
<pre>
 public int getMinimalDaysInFirstWeek()
</pre>
<dl>
  <dd> 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, getMinimalDaysInFirstWeek returns 1. If
 the minimal days required must be a full week, getMinimalDaysInFirstWeek
 returns 7.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> the minimal days required in the first week of the year.
  </dl></dd>
</dl>
<a name="getMinimum(int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getMinimum"><b>getMinimum</b></a>
<pre>
 public abstract int getMinimum(int field)
</pre>
<dl>
  <dd> Gets the minimum value for the given time field.
 e.g., for Gregorian DAY_OF_MONTH, 1.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> field - the given time field.
    <dt> <b>Returns:</b>
    <dd> the minimum value for the given time field.
  </dl></dd>
</dl>
<a name="getMaximum(int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getMaximum"><b>getMaximum</b></a>
<pre>
 public abstract int getMaximum(int field)
</pre>
<dl>
  <dd> Gets the maximum value for the given time field.
 e.g. for Gregorian DAY_OF_MONTH, 31.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> field - the given time field.
    <dt> <b>Returns:</b>
    <dd> the maximum value for the given time field.
  </dl></dd>
</dl>
<a name="getGreatestMinimum(int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getGreatestMinimum"><b>getGreatestMinimum</b></a>
<pre>
 public abstract int getGreatestMinimum(int field)
</pre>
<dl>
  <dd> Gets the highest minimum value for the given field if varies.
 Otherwise same as getMinimum(). For Gregorian, no difference.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> field - the given time field.
    <dt> <b>Returns:</b>
    <dd> the highest minimum value for the given time field.
  </dl></dd>
</dl>
<a name="getLeastMaximum(int)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="getLeastMaximum"><b>getLeastMaximum</b></a>
<pre>
 public abstract int getLeastMaximum(int field)
</pre>
<dl>
  <dd> Gets the lowest maximum value for the given field if varies.
 Otherwise same as getMaximum(). e.g., for Gregorian DAY_OF_MONTH, 28.
<p>
  <dd><dl>
    <dt> <b>Parameters:</b>
    <dd> field - the given time field.
    <dt> <b>Returns:</b>
    <dd> the lowest maximum value for the given time field.
  </dl></dd>
</dl>
<a name="clone()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="clone"><b>clone</b></a>
<pre>
 public <a href="java.lang.Object.html#_top_">Object</a> clone()
</pre>
<dl>
  <dd> Overrides Cloneable
<p>
  <dd><dl>
    <dt> <b>Overrides:</b>
    <dd> <a href="java.lang.Object.html#clone()">clone</a> in class <a href="java.lang.Object.html#_top_">Object</a>
  </dl></dd>
</dl>
<a name="toString()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="toString"><b>toString</b></a>
<pre>
 public <a href="java.lang.String.html#_top_">String</a> toString()
</pre>
<dl>
  <dd> Return a string representation of this calendar.
<p>
  <dd><dl>
    <dt> <b>Returns:</b>
    <dd> a string representation of this calendar.
    <dt> <b>Overrides:</b>
    <dd> <a href="java.lang.Object.html#toString()">toString</a> in class <a href="java.lang.Object.html#_top_">Object</a>
  </dl></dd>
</dl>
<hr>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.util.html">This Package</a>  <a href="java.util.BitSet.html#_top_">Previous</a>  <a href="java.util.Date.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>
