gregoriancalendar.html

来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 1,118 行 · 第 1/5 页

<DD>在具有给定语言环境的给定时区内构造一个基于当前时间的 <code>GregorianCalendar</code>。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>zone</CODE> - 给定的时区。<DD><CODE>aLocale</CODE> - 给定的语言环境。</DL>
</DL>
<HR>

<A NAME="GregorianCalendar(int, int, int)"><!-- --></A><H3>
GregorianCalendar</H3>
<PRE>
public <B>GregorianCalendar</B>(int&nbsp;year,
                         int&nbsp;month,
                         int&nbsp;dayOfMonth)</PRE>
<DL>
<DD>在具有默认语言环境的默认时区内构造一个带有给定日期设置的 <code>GregorianCalendar</code>。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>year</CODE> - 用来在日历中设置 <code>YEAR</code> 日历字段的值。<DD><CODE>month</CODE> - 用来在日历中设置 <code>MONTH</code> 日历字段的值。Month 值是基于 0 的，例如，0 表示 1 月。<DD><CODE>dayOfMonth</CODE> - 用来在日历中设置 <code>DAY_OF_MONTH</code> 日历字段的值。</DL>
</DL>
<HR>

<A NAME="GregorianCalendar(int, int, int, int, int)"><!-- --></A><H3>
GregorianCalendar</H3>
<PRE>
public <B>GregorianCalendar</B>(int&nbsp;year,
                         int&nbsp;month,
                         int&nbsp;dayOfMonth,
                         int&nbsp;hourOfDay,
                         int&nbsp;minute)</PRE>
<DL>
<DD>为具有默认语言环境的默认时区构造一个具有给定日期和时间设置的 <code>GregorianCalendar</code>。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>year</CODE> - 用来在日历中设置 <code>YEAR</code> 日历字段的值。<DD><CODE>month</CODE> - 用来在日历中设置 <code>MONTH</code> 日历字段的值。Month 值是基于 0 的，例如，0 表示 1 月。<DD><CODE>dayOfMonth</CODE> - 用来在日历中设置 <code>DAY_OF_MONTH</code> 日历字段的值。<DD><CODE>hourOfDay</CODE> - 用来在日历中设置 <code>HOUR_OF_DAY</code> 日历字段的值。<DD><CODE>minute</CODE> - 用来在日历中设置 <code>MINUTE</code> 日历字段的值。</DL>
</DL>
<HR>

<A NAME="GregorianCalendar(int, int, int, int, int, int)"><!-- --></A><H3>
GregorianCalendar</H3>
<PRE>
public <B>GregorianCalendar</B>(int&nbsp;year,
                         int&nbsp;month,
                         int&nbsp;dayOfMonth,
                         int&nbsp;hourOfDay,
                         int&nbsp;minute,
                         int&nbsp;second)</PRE>
<DL>
<DD>为具有默认语言环境的默认时区构造一个具有给定日期和时间设置的 GregorianCalendar。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>year</CODE> - 用来在日历中设置 <code>YEAR</code> 日历字段的值。<DD><CODE>month</CODE> - 用来在日历中设置 <code>MONTH</code> 日历字段的值。Month 值是基于 0 的，例如，0 表示 1 月。<DD><CODE>dayOfMonth</CODE> - 用来在日历中设置 <code>DAY_OF_MONTH</code> 日历字段的值。<DD><CODE>hourOfDay</CODE> - 用来在日历中设置 <code>HOUR_OF_DAY</code> 日历字段的值。<DD><CODE>minute</CODE> - 用来在日历中设置 <code>MINUTE</code> 日历字段的值。<DD><CODE>second</CODE> - 用来在日历中设置 <code>SECOND</code> 日历字段的值。</DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>方法详细信息</B></FONT></TH>
</TR>
</TABLE>

<A NAME="setGregorianChange(java.util.Date)"><!-- --></A><H3>
setGregorianChange</H3>
<PRE>
public void <B>setGregorianChange</B>(<A HREF="Date.html" title="java.util 中的类">Date</A>&nbsp;date)</PRE>
<DL>
<DD>设置 <code>GregorianCalendar</code> 的更改日期。这是发生从儒略历日期切换到格里高利历日期的点。默认时间是 1582 年 10 月 15 日（格里高利历）。在此之前，日期是按照儒略历计算的。
 <p>
要得到纯粹的儒略历日历，可将更改日期设置为 <code>Date(Long.MAX_VALUE)</code>。要得到一个纯粹的格里高利历日历，可将更改日期设置为 <code>Date(Long.MIN_VALUE)</code>。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>date</CODE> - 给定的格里高利历起始日期。</DL>
</DD>
</DL>
<HR>

<A NAME="getGregorianChange()"><!-- --></A><H3>
getGregorianChange</H3>
<PRE>
public final <A HREF="Date.html" title="java.util 中的类">Date</A> <B>getGregorianChange</B>()</PRE>
<DL>
<DD>获得格里高利历的更改日期。这是发生从儒略历日期切换到格里高利历日期的点。默认时间是 1582 年 10 月 15 日（格里高利历）。在此之前，日期是按照儒略历计算的。
<P>
<DD><DL>

<DT><B>返回：</B><DD>此 <code>GregorianCalendar</code> 对象的格里高利历起始日期。</DL>
</DD>
</DL>
<HR>

<A NAME="isLeapYear(int)"><!-- --></A><H3>
isLeapYear</H3>
<PRE>
public boolean <B>isLeapYear</B>(int&nbsp;year)</PRE>
<DL>
<DD>确定给定的年份是否为闰年。如果给定的年份是闰年，则返回 <code>true</code>。要指定 BC 年份，必须给定 <code>1 - 年份</code>。例如，指定 -3 为 BC 4 年。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>year</CODE> - 给定的年份。
<DT><B>返回：</B><DD>如果给定的年份为闰年，则返回 <code>true</code>；否则返回 <code>false</code>。</DL>
</DD>
</DL>
<HR>

<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
equals</H3>
<PRE>
public boolean <B>equals</B>(<A HREF="../lang/Object.html" title="java.lang 中的类">Object</A>&nbsp;obj)</PRE>
<DL>
<DD>比较此 <code>GregorianCalendar</code> 与指定的 <code>Object</code>。当且仅当参数是一个 <code>GregorianCalendar</code> 对象，并且这个对象表示在相同的 <code>Calendar</code> 参数和格里高利历更改日期下与此对象具有相同的时间值（从 <a href="Calendar.html#Epoch">Epoch</a> 至现在的毫秒偏移量）时，结果为 <code>true</code>。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="Calendar.html" title="java.util 中的类">Calendar</A></CODE> 中的 <CODE><A HREF="Calendar.html#equals(java.lang.Object)">equals</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 要与之比较的对象。
<DT><B>返回：</B><DD>如果此对象等于 <code>obj</code>，则返回 <code>true</code>；否则返回 <code>false</code>。<DT><B>另请参见：</B><DD><A HREF="Calendar.html#compareTo(java.util.Calendar)"><CODE>Calendar.compareTo(Calendar)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="hashCode()"><!-- --></A><H3>
hashCode</H3>
<PRE>
public int <B>hashCode</B>()</PRE>
<DL>
<DD>生成此 <code>GregorianCalendar</code> 对象的哈希代码。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="Calendar.html" title="java.util 中的类">Calendar</A></CODE> 中的 <CODE><A HREF="Calendar.html#hashCode()">hashCode</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此对象的哈希代码值。<DT><B>另请参见：</B><DD><A HREF="../lang/Object.html#equals(java.lang.Object)"><CODE>Object.equals(java.lang.Object)</CODE></A>, 
<A HREF="Hashtable.html" title="java.util 中的类"><CODE>Hashtable</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="add(int, int)"><!-- --></A><H3>
add</H3>
<PRE>
public void <B>add</B>(int&nbsp;field,
                int&nbsp;amount)</PRE>
<DL>
<DD>根据日历规则，将指定的（有符号的）时间量添加到给定的日历字段中。

<p><em>添加规则 1</em>。调用之后的 <code>field</code> 字段的值减去调用之前的 <code>field</code> 字段的值等于 <code>amount</code>，以 <code>field</code> 中发生的任何溢出为模。溢出发生在字段值超出其范围时，结果，下一个更大的字段会递增或递减，字段值被调整回其范围内。</p>

<p><em>添加规则 2</em>。如果期望某一个更小的字段是无变化的，但让它等于以前的值是不可能的，因为在字段 <code>field</code> 发生更改之后，它的最大值和最小值也在发生更改，然后它的值被调整为尽量接近于所期望的值。更小的字段表示一个更小的时间单元。<code>HOUR</code> 是一个比 <code>DAY_OF_MONTH</code> 更小的字段。对于不期望是无变化字段的更小字段，无需进行任何调整。日历系统确定期望是无变化字段的那些字段。</p>
<P>
<DD><DL>
<DT><B>指定者：</B><DD>类 <CODE><A HREF="Calendar.html" title="java.util 中的类">Calendar</A></CODE> 中的 <CODE><A HREF="Calendar.html#add(int, int)">add</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>field</CODE> - 日历字段。<DD><CODE>amount</CODE> - 为字段添加的日期或时间量。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <code>field</code> 为 <code>ZONE_OFFSET</code>、<code>DST_OFFSET</code>，或未知，或者如果任何日历字段在 non-lenient 模式下具有超出范围的值。<DT><B>另请参见：</B><DD><A HREF="Calendar.html#roll(int, int)"><CODE>Calendar.roll(int,int)</CODE></A>, 
<A HREF="Calendar.html#set(int, int)"><CODE>Calendar.set(int,int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="roll(int, boolean)"><!-- --></A><H3>
roll</H3>
<PRE>
public void <B>roll</B>(int&nbsp;field,
                 boolean&nbsp;up)</PRE>
<DL>
<DD>在给定的时间字段上添加或减去（上/下）单个时间单元，不更改更大的字段。 
 <p>
<em>示例</em>：考虑原来设置为 1999 年 12 月 31 日的 <code>GregorianCalendar</code> 。现在调用 <A HREF="GregorianCalendar.html#roll(int, boolean)"><CODE>roll(Calendar.MONTH, true)</CODE></A> 将该日历设置为 1999 年 1 月 31 日。<code>YEAR</code> 字段未改变，因为它是一个比 <code>MONTH</code> 更大的字段。</p>
<P>
<DD><DL>
<DT><B>指定者：</B><DD>类 <CODE><A HREF="Calendar.html" title="java.util 中的类">Calendar</A></CODE> 中的 <CODE><A HREF="Calendar.html#roll(int, boolean)">roll</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>up</CODE> - 指出指定日历字段的值是上升还是下降。如果上升了，则使用 <code>true</code>；否则使用 <code>false</code>。<DD><CODE>field</CODE> - 时间字段。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <code>field</code> 为 <code>ZONE_OFFSET</code>、<code>DST_OFFSET</code>，或未知，或者如果任何日历字段在 non-lenient 模式下具有超出范围的值。<DT><B>另请参见：</B><DD><A HREF="GregorianCalendar.html#add(int, int)"><CODE>add(int,int)</CODE></A>, 
<A HREF="Calendar.html#set(int, int)"><CODE>Calendar.set(int,int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="roll(int, int)"><!-- --></A><H3>
roll</H3>
<PRE>
public void <B>roll</B>(int&nbsp;field,
                 int&nbsp;amount)</PRE>
<DL>
<DD>向指定日历字段添加有符号的时间量，不更改更大的字段。负的波动量表示从字段减去时间量，不更改更大的字段。如果指定的量为 0，则此方法不执行任何操作。

<p>此方法在添加时间量前调用 <A HREF="Calendar.html#complete()"><CODE>Calendar.complete()</CODE></A>，使得所有的日历字段都标准化。如果任何日历字段在 non-lenient 模式下具有超出范围的值，则抛出 <code>IllegalArgumentException</code>。

 <p>
<em>示例</em>：考虑原来设置为 1999 年 8 月 31 日的 <code>GregorianCalendar</code> 。现在调用 <code>roll(Calendar.MONTH, 8)</code> 将该日历设置为 <strong>1999</strong> 年 4 月 30 日。如果使用 <code>GregorianCalendar</code>，则 4 月份的 <code>DAY_OF_MONTH</code> 字段不可能为 31。将 <code>DAY_OF_MONTH</code> 设置为最可能接近的值 30。<code>YEAR</code> 字段保持为值 1999，因为它是一个比 <code>MONTH</code> 更大的字段。
 <p>
<em>示例</em>：考虑原来设置为 1999 年 6 月 6 日星期日的 <code>GregorianCalendar</code> 。现在调用 <code>roll(Calendar.WEEK_OF_MONTH, -1)</code> 将该日历设置为 1999 年 6 月 1 日星期二，而调用 <code>add(Calendar.WEEK_OF_MONTH, -1)</code> 则将日历设置为 1999 年 5 月 30 日星期日。这是因为上升和下降规则施加了其他的约束：<code>WEEK_OF_MONTH</code> 改变时 <code>MONTH</code> 必须不变。根据添加规则 1，所得日期必定在 6 月 1 日星期二和 6 月 5 日星期六之间。根据添加规则 2，<code>DAY_OF_WEEK</code>（在改变 <code>WEEK_OF_MONTH</code> 时它是一个不变量）被设置为 Tuesday，是最接近 Sunday 的可能值（其中星期日是一个星期的第一天）。</p>
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="Calendar.html" title="java.util 中的类">Calendar</A></CODE> 中的 <CODE><A HREF="Calendar.html#roll(int, int)">roll</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>field</CODE> - 日历字段。<DD><CODE>amount</CODE> - 添加到 <code>field</code> 的有符号时间量。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <code>field</code> 为 <code>ZONE_OFFSET</code>、<code>DST_OFFSET</code>　或未知，或者如果任何日历字段在 non-lenient 模式下具有超出范围的值。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
<DT><B>另请参见：</B><DD><A HREF="GregorianCalendar.html#roll(int, boolean)"><CODE>roll(int,boolean)</CODE></A>, 
<A HREF="GregorianCalendar.html#add(int, int)"><CODE>add(int,int)</CODE></A>, 
<A HREF="Calendar.html#set(int, int)"><CODE>Calendar.set(int,int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getMinimum(int)"><!-- --></A><H3>
getMinimum</H3>
<PRE>
public int <B>getMinimum</B>(int&nbsp;field)</PRE>
<DL>
<DD>返回此 <code>GregorianCalendar</code> 实例的给定日历字段的最小值。考虑到 <A HREF="Calendar.html#getFirstDayOfWeek()"><CODE>getFirstDayOfWeek</CODE></A>、<A HREF="Calendar.html#getMinimalDaysInFirstWeek()"><CODE>getMinimalDaysInFirstWeek</CODE></A>、<CODE>getGregorianChange</CODE> 和 <A HREF="Calendar.html#getTimeZone()"><CODE>getTimeZone</CODE></A> 方法的当前值，最小值定义为由 <A HREF="Calendar.html#get(int)"><CODE>get</CODE></A> 方法为所有可能的时间值所返回的最小值。
<P>