date.html

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

<DD>分配 <code>Date</code> 对象并初始化此对象，以表示由 <code>year</code>、<code>month</code> 和 <code>date</code> 参数指定的一天的开始时间（本地时间晚上 12 时）。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>year</CODE> - 减 1900 的年份。<DD><CODE>month</CODE> - 0-11 的月份。<DD><CODE>date</CODE> - 一月中 1-31 之间的某一天。<DT><B>另请参见：</B><DD><A HREF="Calendar.html" title="java.util 中的类"><CODE>Calendar</CODE></A></DL>
</DL>
<HR>

<A NAME="Date(int, int, int, int, int)"><!-- --></A><H3>
Date</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public <B>Date</B>(int&nbsp;year,
                       int&nbsp;month,
                       int&nbsp;date,
                       int&nbsp;hrs,
                       int&nbsp;min)</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>Calendar.set(year + 1900, month, date, hrs, min)</code> 或 <code>GregorianCalendar(year + 1900, month, date, hrs, min)</code> 取代。</I>
<P>
<DD>分配 <code>Date</code> 对象并初始化此对象，以表示本地时区中由 <code>year</code>、<code>month</code>、<code>date</code>、<code>hrs</code> 和 <code>min</code> 参数指定的分钟的开始瞬间。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>year</CODE> - 减 1900 的年份。<DD><CODE>month</CODE> - 0-11 之间的月份。<DD><CODE>date</CODE> - 一月中 1-31 之间的某一天。<DD><CODE>hrs</CODE> - 0-23 之间的小时数。<DD><CODE>min</CODE> - 0-59 之间的分钟数。<DT><B>另请参见：</B><DD><A HREF="Calendar.html" title="java.util 中的类"><CODE>Calendar</CODE></A></DL>
</DL>
<HR>

<A NAME="Date(int, int, int, int, int, int)"><!-- --></A><H3>
Date</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public <B>Date</B>(int&nbsp;year,
                       int&nbsp;month,
                       int&nbsp;date,
                       int&nbsp;hrs,
                       int&nbsp;min,
                       int&nbsp;sec)</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>Calendar.set(year + 1900, month, date, hrs, min, sec)</code> 或 <code>GregorianCalendar(year + 1900, month, date, hrs, min, sec)</code> 取代。</I>
<P>
<DD>分配 <code>Date</code> 对象，并初始化此对象，以表示本地时区中由 <code>year</code>、<code>month</code>、<code>date</code>、<code>hrs</code>、<code>min</code> 和 <code>sec</code> 参数指定的秒的开始瞬间。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>year</CODE> - 减 1900 的年份。<DD><CODE>month</CODE> - 0-11 之间的月份。<DD><CODE>date</CODE> - 一月中 1-31 之间的某一天。<DD><CODE>hrs</CODE> - 0-23 之间的小时数。<DD><CODE>min</CODE> - 0-59 之间的分钟数。<DD><CODE>sec</CODE> - 0-59 之间的秒数。<DT><B>另请参见：</B><DD><A HREF="Calendar.html" title="java.util 中的类"><CODE>Calendar</CODE></A></DL>
</DL>
<HR>

<A NAME="Date(java.lang.String)"><!-- --></A><H3>
Date</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public <B>Date</B>(<A HREF="../lang/String.html" title="java.lang 中的类">String</A>&nbsp;s)</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>DateFormat.parse(String s)</code> 取代。</I>
<P>
<DD>分配 <code>Date</code> 对象并初始化此对象，以表示字符串 <code>s</code> 指出的日期和时间，就像通过 <A HREF="Date.html#parse(java.lang.String)"><CODE>parse(java.lang.String)</CODE></A> 方法解释一样。
<P>
<DL>
<DT><B>参数：</B><DD><CODE>s</CODE> - 日期的字符串表示形式。<DT><B>另请参见：</B><DD><CODE>DateFormat</CODE>, 
<A HREF="Date.html#parse(java.lang.String)"><CODE>parse(java.lang.String)</CODE></A></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="clone()"><!-- --></A><H3>
clone</H3>
<PRE>
public <A HREF="../lang/Object.html" title="java.lang 中的类">Object</A> <B>clone</B>()</PRE>
<DL>
<DD>返回此对象的副本。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="../lang/Object.html" title="java.lang 中的类">Object</A></CODE> 中的 <CODE><A HREF="../lang/Object.html#clone()">clone</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此实例的一个克隆。<DT><B>另请参见：</B><DD><A HREF="../lang/Cloneable.html" title="java.lang 中的接口"><CODE>Cloneable</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="UTC(int, int, int, int, int, int)"><!-- --></A><H3>
UTC</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public static long <B>UTC</B>(int&nbsp;year,
                                  int&nbsp;month,
                                  int&nbsp;date,
                                  int&nbsp;hrs,
                                  int&nbsp;min,
                                  int&nbsp;sec)</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>Calendar.set(year + 1900, month, date, hrs, min, sec)</code> 或 <code>GregorianCalendar(year + 1900, month, date, hrs, min, sec)</code> 取代，使用 UTC <code>TimeZone</code>，后跟 <code>Calendar.getTime().getTime()</code>。</I>
<P>
<DD>根据参数确定日期和时间。这些参数被解释为年份、月份、月中某一天、一天中的某一小时、小时中某一分钟和分钟中的某一秒。除了相对于 UTC 而不是本地时区解释这些参数之外，该方法与带 6 个参数的 <tt>Date</tt> 构造方法完全相同。该方法将返回指示的时间，用该时间与历元（1970 年 1 月 1 日，00:00:00 GMT）的时间差来表示（以毫秒为单位）。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>year</CODE> - 减 1900 的年份。<DD><CODE>month</CODE> - 0-11 之间的月份。<DD><CODE>date</CODE> - 一月中 1-31 之间的某一天。<DD><CODE>hrs</CODE> - 0-23 之间的小时数。<DD><CODE>min</CODE> - 0-59 之间的分钟数。<DD><CODE>sec</CODE> - 0-59 之间的秒数。
<DT><B>返回：</B><DD>对于参数指定的日期和时间，返回自 1970 年 1 月 1 日 00:00:00 GMT 以来的毫秒数。<DT><B>另请参见：</B><DD><A HREF="Calendar.html" title="java.util 中的类"><CODE>Calendar</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="parse(java.lang.String)"><!-- --></A><H3>
parse</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public static long <B>parse</B>(<A HREF="../lang/String.html" title="java.lang 中的类">String</A>&nbsp;s)</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>DateFormat.parse(String s)</code> 取代。</I>
<P>
<DD>尝试把字符串 <tt>s</tt> 解释为日期和时间的表示形式。如果尝试成功，则返回指示的时间，用该时间与历元（1970 年 1 月 1 日，00:00:00 GMT）的时间差来表示（以毫秒为单位）。如果尝试失败，则抛出 <tt>IllegalArgumentException</tt>。
 <p>
它接受许多语法；特别是它识别 IETF 标准日期语法：&quot;Sat, 12 Aug 1995 13:30:00 GMT&quot;。它也了解美国大陆时区缩写，但对于一般用途，应该使用时区偏移量：&quot;Sat, 12 Aug 1995 13:30:00 GMT+0430&quot;（比格林威治子午线晚 4 小时 30 分）。如果没有指定时区，则假定用本地时区。GMT 和 UTC 被认为是相同的。
 <p>
系统将从左到右处理字符串 <tt>s</tt>，从中查找相应的数据。<tt>s</tt> 中包括在 ASCII 括号字符 <tt>(</tt> 和 <tt>)</tt> 中的任何内容都将被忽略。括号可以进行嵌套。另外，<tt>s</tt> 中只允许使用以下 ASCII 字符：
 <blockquote><pre>
 abcdefghijklmnopqrstuvwxyz
 ABCDEFGHIJKLMNOPQRSTUVWXYZ
 0123456789,+-:/</pre></blockquote>
以及空白字符。<p>
连续的十进制位序列被当成十进制数：<ul>
<li>如果数字前面有 <tt>+</tt> 或 <tt>-</tt>，并且已经识别了年份，那么数字就是一个时区偏移量。如果数字少于 24，那么它是以小时进行测量的偏移量。否则，它被认为是以分钟进行测量的偏移量，用没有标点的 24 小时时间格式来表示。前面的 <tt>-</tt> 意味着向西的偏移量。时区偏移量始终相对于 UTC（格林威治）。因此，例如，在字符串中出现的 <tt>-5</tt> 意味着&ldquo;比格林威治时间晚 5 小时&rdquo;，<tt>+0430</tt> 将意味着&ldquo;比格林威治时间早 4 小时 30 分&rdquo;。允许字符串冗余地指定 <tt>GMT</tt>、<tt>UT</tt> 或 <tt>UTC</tt>&mdash;&mdash;例如，<tt>GMT-5</tt> 或 <tt>utc+0430</tt>。
<li>如果下面条件之一为真，数字就被认为是年数：
 <ul>
<li>数字等于或大于 70，并且后跟一个空格、逗号、斜杠或结束字符串
<li>数字小于 70，并且已经识别月份和月中的某一天</li>
 </ul>
如果被识别的年数小于 100，它就被解释为相对于其日期所在世纪的缩写年，缩写年的日期位于初始化 Date 类的时间的 80 年以前和 19 年以后之间。在调整年数后，从其减去 1900。例如，如果当前的年份是 1999，那么范围 19 至 99 的年数就被假定表示 1919 至 1999，而 0 至 18 的年数就被假定表示 2000 至 2018。注意，这与 <CODE>SimpleDateFormat</CODE> 中使用的小于 100 的年份具有稍微不同的解释。
<li>如果数字后跟一个冒号，则认为是小时，如果小时已经被识别，则认为是分钟。
<li>如果数字后跟一个斜杠，则认为是月份（把它减 1，以便产生范围 <tt>0</tt> 至 <tt>11</tt> 的数字），如果月份已经被识别，则认为它是月中的某一天。
<li>如果数字后跟空白、逗号、连字符或结束字符串，那么如果小时已识别但分钟未识别，则认为是分钟；否则，如果分钟已识别，而秒没有识别，则认为是秒；否则，它被认为是月中的某一天。 </ul><p>
连续的字母序列被认为是单词，并按以下方法进行处理：<ul>
<li>忽略匹配 <tt>AM</tt>（忽略大小写）的单词（但如果小时尚未识别，或者小时小于 <tt>1</tt> 或大于 <tt>12</tt>，则分析失败）。
<li>匹配 <tt>PM</tt>（忽略大小写）的单词，添加 <tt>12</tt> 到小时（但如果小时尚未识别，或者小时小于 <tt>1</tt> 或大于 <tt>12</tt>，则分析失败）。
<li>忽略匹配 <tt>SUNDAY、MONDAY、TUESDAY、WEDNESDAY、THURSDAY、FRIDAY</tt> 或 <tt>SATURDAY</tt> 的任何前缀（忽略大小写）的任何单词。例如，<tt>sat、Friday、TUE</tt> 和 <tt>Thurs</tt> 会被忽略。
<li>否则，匹配 <tt>JANUARY、FEBRUARY、MARCH、APRIL、MAY、JUNE、JULY、AUGUST、SEPTEMBER、OCTOBER、NOVEMBER</tt> 或 <tt>DECEMBER</tt> 的任何前缀（忽略大小写，并按这里给出的顺序考虑它们）的任何单词都被识别为指定月份，并被转换成一个数字（<tt>0</tt> 至 <tt>11</tt>）。例如，<tt>aug、Sept、april</tt> 和 <tt>NOV</tt> 被识别为月份。<tt>Ma</tt> 也是这样，它被识别为 <tt>MARCH</tt>，而不是 <tt>MAY</tt>。
<li>匹配 <tt>GMT、UT</tt> 或 <tt>UTC</tt>（忽略大小写）的任何单词都认为是指 UTC。 
<li>匹配 <tt>EST、CST、MST</tt> 或 <tt>PST</tt>（忽略大小写）的任何单词都被认为是指北美的时区，该时区分别比格林威治时间晚 5、6、7 或 8 小时。匹配 <tt>EDT、CDT、MDT</tt> 或 <tt>PDT</tt>（忽略大小写）的任何单词都被识别为在夏令时期间分别指相同的时区。</ul><p>
一旦扫描了整个字符串，就以两种方式之一把它转换成时间结果。如果已经识别时区或时区偏移量，那么年、月、月中某一天、小时、分钟和秒以 UTC 进行解释，然后应用时区偏移量。否则，年、月、月中某一天、小时、分钟和秒用本地时区进行解释。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>s</CODE> - 要解析为日期的字符串。
<DT><B>返回：</B><DD>自 1970 年 1 月 1 日 00:00:00 GMT 以来字符串参数表示的毫秒数。<DT><B>另请参见：</B><DD><CODE>DateFormat</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="getYear()"><!-- --></A><H3>
getYear</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public int <B>getYear</B>()</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>Calendar.get(Calendar.YEAR) - 1900</code> 取代。</I>
<P>
<DD>返回一个值，此值是从包含或开始于此 <code>Date</code> 对象表示的瞬间的年份减去 1900 的结果（用本地时区进行解释）。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>日期表示的年份减去 1900。<DT><B>另请参见：</B><DD><A HREF="Calendar.html" title="java.util 中的类"><CODE>Calendar</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setYear(int)"><!-- --></A><H3>
setYear</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public void <B>setYear</B>(int&nbsp;year)</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>Calendar.set(Calendar.YEAR, year + 1900)</code> 取代。</I>
<P>
<DD>把此 <tt>Date</tt> 对象的年份设置为指定的值加 1900。修改此 <code>Date</code> 对象，以便它用与以前相同的月份、日期、小时、分钟和秒表示指定年份中的时间点（用本地时区进行解释）。（当然，例如，如果日期是 2 月 29 日，并且年份被设置到非闰年，那么新日期将被看作 3 月 1 日。）
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>year</CODE> - 年份值。<DT><B>另请参见：</B><DD><A HREF="Calendar.html" title="java.util 中的类"><CODE>Calendar</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getMonth()"><!-- --></A><H3>
getMonth</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public int <B>getMonth</B>()</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>Calendar.get(Calendar.MONTH)</code> 取代。</I>
<P>
<DD>返回表示月份的数字，该月份包含或开始于此 <tt>Date</tt> 对象所表示的瞬间。返回的值在 <code>0</code> 和 <code>11</code> 之间，值 <code>0</code> 表示 1 月。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此日期所表示的月份。<DT><B>另请参见：</B><DD><A HREF="Calendar.html" title="java.util 中的类"><CODE>Calendar</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setMonth(int)"><!-- --></A><H3>
setMonth</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public void <B>setMonth</B>(int&nbsp;month)</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>Calendar.set(Calendar.MONTH, int month)</code> 取代。</I>
<P>
<DD>把此日期的月份设置为指定值。修改此 <tt>Date</tt> 对象，以便它用与以前一样的年份、日期、小时、分钟和秒表示指定月份中的时间点（用本地时区进行解释）。例如，如果日期是 10 月 31 日，并将月份设置为 6 月，那么新日期将被看作 7 月 1 日，因为 6 月只有 30 天。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>month</CODE> - 0-11 之间的月份值。<DT><B>另请参见：</B><DD><A HREF="Calendar.html" title="java.util 中的类"><CODE>Calendar</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getDate()"><!-- --></A><H3>
getDate</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public int <B>getDate</B>()</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>Calendar.get(Calendar.DAY_OF_MONTH)</code> 取代。</I>