simpletimezone.html

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

<!-- ============ 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="setStartYear(int)"><!-- --></A><H3>
setStartYear</H3>
<PRE>
public void <B>setStartYear</B>(int&nbsp;year)</PRE>
<DL>
<DD>设置夏令时的开始年份。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>year</CODE> - 夏令时的开始年份。</DL>
</DD>
</DL>
<HR>

<A NAME="setStartRule(int, int, int, int)"><!-- --></A><H3>
setStartRule</H3>
<PRE>
public void <B>setStartRule</B>(int&nbsp;startMonth,
                         int&nbsp;startDay,
                         int&nbsp;startDayOfWeek,
                         int&nbsp;startTime)</PRE>
<DL>
<DD>设置夏令时的开始规则。例如，如果夏令时在本地挂钟时间的 4 月第一个星期日的上午 2 点开始，则可以通过以下调用来设置开始规则：
<pre><code>setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2*60*60*1000);</code></pre>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>startMonth</CODE> - 夏令时开始的月份。月份是一个 <A HREF="Calendar.html#MONTH"><CODE>MONTH</CODE></A> 字段值（基于 0。例如，0 代表 1 月）。<DD><CODE>startDay</CODE> - 夏令时开始的日期。有关此参数的特殊情形，请参阅类的描述。<DD><CODE>startDayOfWeek</CODE> - 夏令时开始时是一周的星期几。有关此参数的特殊情形，请参阅类的描述。<DD><CODE>startTime</CODE> - 以本地挂钟时间表示的夏令时开始时间，在此情况下为本地标准时间。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <code>startMonth</code>、<code>startDay</code>、<code>startDayOfWeek</code> 或 <code>startTime</code> 参数超出范围。</DL>
</DD>
</DL>
<HR>

<A NAME="setStartRule(int, int, int)"><!-- --></A><H3>
setStartRule</H3>
<PRE>
public void <B>setStartRule</B>(int&nbsp;startMonth,
                         int&nbsp;startDay,
                         int&nbsp;startTime)</PRE>
<DL>
<DD>将夏令时开始规则设置为某个月份的固定日期。此方法等效于：
 <pre><code>setStartRule(startMonth, startDay, 0, startTime)</code></pre>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>startMonth</CODE> - 夏令时开始的月份。月份是一个 <A HREF="Calendar.html#MONTH"><CODE>MONTH</CODE></A> 字段值（基于 0。例如，0 代表 1 月）。<DD><CODE>startDay</CODE> - 夏令时开始的日期。<DD><CODE>startTime</CODE> - 以本地挂钟时间表示的夏令时开始时间，在此情况下为本地标准时间。有关此参数的特殊情形，请参阅类的描述。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <code>startMonth</code>、<code>startDayOfMonth</code> 或 <code>startTime</code> 参数超出范围。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="setStartRule(int, int, int, int, boolean)"><!-- --></A><H3>
setStartRule</H3>
<PRE>
public void <B>setStartRule</B>(int&nbsp;startMonth,
                         int&nbsp;startDay,
                         int&nbsp;startDayOfWeek,
                         int&nbsp;startTime,
                         boolean&nbsp;after)</PRE>
<DL>
<DD>将夏令时开始规则设置为某个月份给定日期之前或之后的星期几，例如，8 号或之后的第一个星期一。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>startMonth</CODE> - 夏令时开始的月份。月份是一个 <A HREF="Calendar.html#MONTH"><CODE>MONTH</CODE></A> 字段值（基于 0。例如，0 代表 1 月）。<DD><CODE>startDay</CODE> - 夏令时开始的日期。<DD><CODE>startDayOfWeek</CODE> - 夏令时开始时是一周的星期几。<DD><CODE>startTime</CODE> - 以本地挂钟时间表示的夏令时开始时间，在此情况下为本地标准时间。<DD><CODE>after</CODE> - 如果为 true，则此规则将选择 <code>dayOfMonth</code> 或它<em>之后</em> 的第一个 <code>dayOfWeek</code>。如果为 false，则此规则将选择 <code>dayOfMonth</code> 或它<em>之前</em> 的最后一个 <code>dayOfWeek</code>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <code>startMonth</code>、<code>startDay</code>、<code>startDayOfWeek</code> 或 <code>startTime</code> 参数超出范围。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="setEndRule(int, int, int, int)"><!-- --></A><H3>
setEndRule</H3>
<PRE>
public void <B>setEndRule</B>(int&nbsp;endMonth,
                       int&nbsp;endDay,
                       int&nbsp;endDayOfWeek,
                       int&nbsp;endTime)</PRE>
<DL>
<DD>设置夏令时结束规则。例如，如果夏令时在本地挂钟时间的 10 月最后一个星期天的上午 2 点结束，则可以通过以下调用来设置结束规则：<code>setEndRule(Calendar.OCTOBER, -1, Calendar.SUNDAY, 2*60*60*1000);</code>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>endMonth</CODE> - 夏令时结束的月份。月份是一个 <A HREF="Calendar.html#MONTH"><CODE>MONTH</CODE></A> 字段值（基于 0。例如，9 代表 10 月）。<DD><CODE>endDay</CODE> - 夏令时结束的日期。有关此参数的特殊情形，请参阅类的描述。<DD><CODE>endDayOfWeek</CODE> - 夏令时结束时是一周的星期几。有关此参数的特殊情形，请参阅类的描述。<DD><CODE>endTime</CODE> - 以本地挂钟时间表示的夏令时结束时间（此天中的毫秒数），在此情况下为本地标准时间。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <code>endMonth</code>、<code>endDay</code>、<code>endDayOfWeek</code> 或 <code>endTime</code> 参数超出范围。</DL>
</DD>
</DL>
<HR>

<A NAME="setEndRule(int, int, int)"><!-- --></A><H3>
setEndRule</H3>
<PRE>
public void <B>setEndRule</B>(int&nbsp;endMonth,
                       int&nbsp;endDay,
                       int&nbsp;endTime)</PRE>
<DL>
<DD>将夏令时结束规则设置为某个月份的固定日期。此方法等效于：
 <pre><code>setEndRule(endMonth, endDay, 0, endTime)</code></pre>
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>endMonth</CODE> - 夏令时结束的月份。月份是一个 <A HREF="Calendar.html#MONTH"><CODE>MONTH</CODE></A> 字段值（基于 0。例如，9 代表 10 月）。<DD><CODE>endDay</CODE> - 夏令时结束的日期。<DD><CODE>endTime</CODE> - 以本地挂钟时间表示的夏令时结束时间（此天中的毫秒数），在此情况下为本地标准时间。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <code>endMonth</code>、<code>endDay</code> 或 <code>endTime</code> 参数超出范围。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="setEndRule(int, int, int, int, boolean)"><!-- --></A><H3>
setEndRule</H3>
<PRE>
public void <B>setEndRule</B>(int&nbsp;endMonth,
                       int&nbsp;endDay,
                       int&nbsp;endDayOfWeek,
                       int&nbsp;endTime,
                       boolean&nbsp;after)</PRE>
<DL>
<DD>将夏令时结束规则设置为某个月份给定日期之前或之后的星期几，例如，8 号或之后的第一个星期一。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>endMonth</CODE> - 夏令时结束的月份。月份是一个 <A HREF="Calendar.html#MONTH"><CODE>MONTH</CODE></A> 字段值（基于 0。例如，9 代表 10 月）。<DD><CODE>endDay</CODE> - 夏令时结束的日期。<DD><CODE>endDayOfWeek</CODE> - 夏令时结束时是一周的星期几。<DD><CODE>endTime</CODE> - 以本地挂钟时间表示的夏令时结束时间（此天中的毫秒数），在此情况下为本地标准时间。<DD><CODE>after</CODE> - 如果为 true，则此规则将选择 <code>endDay</code> 或它<em>之后</em> 的第一个 <code>endDayOfWeek</code>。如果为 false，则此规则将选择该月份的 <code>endDay</code> 或它之前的最后一个 <code>endDayOfWeek</code>。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <code>endMonth</code>、<code>endDay</code>、<code>endDayOfWeek</code> 或 <code>endTime</code> 参数超出范围。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getOffset(long)"><!-- --></A><H3>
getOffset</H3>
<PRE>
public int <B>getOffset</B>(long&nbsp;date)</PRE>
<DL>
<DD>从给定时间的 UTC 返回此时区的偏移量。如果夏令时在给定的时间是有效的，就使用夏令时节省值调整偏移值。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="TimeZone.html" title="java.util 中的类">TimeZone</A></CODE> 中的 <CODE><A HREF="TimeZone.html#getOffset(long)">getOffset</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>date</CODE> - 出现时区偏移量的时间。
<DT><B>返回：</B><DD>添加到 UTC 以获取本地时间的时间量（以毫秒为单位）。<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
<DT><B>另请参见：</B><DD><A HREF="Calendar.html#ZONE_OFFSET"><CODE>Calendar.ZONE_OFFSET</CODE></A>, 
<A HREF="Calendar.html#DST_OFFSET"><CODE>Calendar.DST_OFFSET</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getOffset(int, int, int, int, int, int)"><!-- --></A><H3>
getOffset</H3>
<PRE>
public int <B>getOffset</B>(int&nbsp;era,
                     int&nbsp;year,
                     int&nbsp;month,
                     int&nbsp;day,
                     int&nbsp;dayOfWeek,
                     int&nbsp;millis)</PRE>
<DL>
<DD>返回以毫秒为单位的本地时间与 UTC 之间的差别，对于指定日期和时间，把原始偏移量和夏令时的效果同时考虑在内。此方法假定开始和结束月份是不同的。它还使用默认的 <A HREF="GregorianCalendar.html" title="java.util 中的类"><CODE>GregorianCalendar</CODE></A> 对象作为其基础日历，例如用于确定闰年。除默认的 <code>GregorianCalendar</code> 之外，请不要将此方法的结果与其他日历一起使用。

<p><em>注：一般情况下，客户应使用 <code>Calendar.get(ZONE_OFFSET) + Calendar.get(DST_OFFSET)</code> 而不调用此方法。</em>
<P>
<DD><DL>
<DT><B>指定者：</B><DD>类 <CODE><A HREF="TimeZone.html" title="java.util 中的类">TimeZone</A></CODE> 中的 <CODE><A HREF="TimeZone.html#getOffset(int, int, int, int, int, int)">getOffset</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>era</CODE> - 给定日期的年代。<DD><CODE>year</CODE> - 给定日期的年份。<DD><CODE>month</CODE> - 给定日期的月份。月份是以 0 为基础的，比如 0 代表 1 月。<DD><CODE>day</CODE> - 给定日期的月份中的某一天。<DD><CODE>dayOfWeek</CODE> - 给定日期的一周中的某一天。<DD><CODE>millis</CODE> - <em>标准</em> 本地时间中天的毫秒数。
<DT><B>返回：</B><DD>要添加到 UTC 以获取本地时间的毫秒数。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 如果 <code>era</code>、<code>month</code>、<code>day</code>、<code>dayOfWeek</code> 或 <code>millis</code> 参数超出范围。<DT><B>另请参见：</B><DD><A HREF="Calendar.html#ZONE_OFFSET"><CODE>Calendar.ZONE_OFFSET</CODE></A>, 
<A HREF="Calendar.html#DST_OFFSET"><CODE>Calendar.DST_OFFSET</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getRawOffset()"><!-- --></A><H3>
getRawOffset</H3>
<PRE>
public int <B>getRawOffset</B>()</PRE>
<DL>
<DD>获取此时区的 GMT 偏移量。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>类 <CODE><A HREF="TimeZone.html" title="java.util 中的类">TimeZone</A></CODE> 中的 <CODE><A HREF="TimeZone.html#getRawOffset()">getRawOffset</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>以毫秒为单位的 GMT 偏移量值。<DT><B>另请参见：</B><DD><A HREF="SimpleTimeZone.html#setRawOffset(int)"><CODE>setRawOffset(int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setRawOffset(int)"><!-- --></A><H3>
setRawOffset</H3>
<PRE>
public void <B>setRawOffset</B>(int&nbsp;offsetMillis)</PRE>
<DL>
<DD>把基准时区偏移量设置到 GMT。这是添加到 UTC 以获取本地时间的偏移量。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>类 <CODE><A HREF="TimeZone.html" title="java.util 中的类">TimeZone</A></CODE> 中的 <CODE><A HREF="TimeZone.html#setRawOffset(int)">setRawOffset</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>offsetMillis</CODE> - GMT 的给定基准时区偏移量。<DT><B>另请参见：</B><DD><A HREF="SimpleTimeZone.html#getRawOffset()"><CODE>getRawOffset()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setDSTSavings(int)"><!-- --></A><H3>