date.html

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

 <p>
因此，当且仅当 <code>getTime</code> 方法对于两个 <code>Date</code> 对象返回相同的 <code>long</code> 值时，这两个对象才是相等的。
<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#equals(java.lang.Object)">equals</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>obj</CODE> - 要与之比较的对象。
<DT><B>返回：</B><DD>如果对象相同，则返回 <code>true</code>；否则，返回 <code>false</code>。<DT><B>另请参见：</B><DD><A HREF="Date.html#getTime()"><CODE>getTime()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="compareTo(java.util.Date)"><!-- --></A><H3>
compareTo</H3>
<PRE>
public int <B>compareTo</B>(<A HREF="Date.html" title="java.util 中的类">Date</A>&nbsp;anotherDate)</PRE>
<DL>
<DD>比较两个日期的顺序。
<P>
<DD><DL>
<DT><B>指定者：</B><DD>接口 <CODE><A HREF="../lang/Comparable.html" title="java.lang 中的接口">Comparable</A>&lt;<A HREF="Date.html" title="java.util 中的类">Date</A>&gt;</CODE> 中的 <CODE><A HREF="../lang/Comparable.html#compareTo(T)">compareTo</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>anotherDate</CODE> - 要比较的 <code>Date</code>。
<DT><B>返回：</B><DD>如果参数 Date 等于此 Date，则返回值 <code>0</code>；如果此 Date 在 Date 参数之前，则返回小于 <code>0</code> 的值；如果此 Date 在 Date 参数之后，则返回大于 <code>0</code> 的值。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/NullPointerException.html" title="java.lang 中的类">NullPointerException</A></CODE> - 如果 <code>anotherDate</code> 为 null。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="hashCode()"><!-- --></A><H3>
hashCode</H3>
<PRE>
public int <B>hashCode</B>()</PRE>
<DL>
<DD>返回此对象的哈希代码值。结果是 <A HREF="Date.html#getTime()"><CODE>getTime()</CODE></A> 方法返回的基本 <tt>long</tt> 值的两部分的异或。也就是说，哈希码就是以下表达式的值：
 <blockquote><pre>
(int)(this.getTime()^(this.getTime() >>> 32))</pre></blockquote>
<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#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="toString()"><!-- --></A><H3>
toString</H3>
<PRE>
public <A HREF="../lang/String.html" title="java.lang 中的类">String</A> <B>toString</B>()</PRE>
<DL>
<DD>把此 <code>Date</code> 对象转换为以下形式的 <code>String</code>：
 <blockquote><pre>
 dow mon dd hh:mm:ss zzz yyyy</pre></blockquote>
其中：<ul>
<li><tt>dow</tt> 是一周中的某一天 (<tt>Sun, Mon, Tue, Wed, Thu, Fri, Sat</tt>)。
<li><tt>mon</tt> 是月份 (<tt>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</tt>)。
<li><tt>dd</tt> 是一月中的某一天（<tt>01</tt> 至 <tt>31</tt>），显示为两位十进制数。
<li><tt>hh</tt> 是一天中的小时（<tt>00</tt> 至 <tt>23</tt>），显示为两位十进制数。
<li><tt>mm</tt> 是小时中的分钟（<tt>00</tt> 至 <tt>59</tt>），显示为两位十进制数。
<li><tt>ss</tt> 是分钟中的秒数（<tt>00</tt> 至 <tt>61</tt>），显示为两位十进制数。
<li><tt>zzz</tt> 是时区（并可以反映夏令时）。标准时区缩写包括方法 <tt>parse</tt> 识别的时区缩写。如果不提供时区信息，则 <tt>zzz</tt> 为空，即根本不包括任何字符。
<li><tt>yyyy</tt> 是年份，显示为 4 位十进制数。
 </ul>
<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#toString()">toString</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此日期的字符串表示形式。<DT><B>另请参见：</B><DD><A HREF="Date.html#toLocaleString()"><CODE>toLocaleString()</CODE></A>, 
<A HREF="Date.html#toGMTString()"><CODE>toGMTString()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="toLocaleString()"><!-- --></A><H3>
toLocaleString</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public <A HREF="../lang/String.html" title="java.lang 中的类">String</A> <B>toLocaleString</B>()</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>DateFormat.format(Date date)</code> 取代。</I>
<P>
<DD>以与实现相关的方式创建此 <tt>Date</tt> 对象的字符串表示形式。其目的是这种形式应该为所有 Java 应用程序的用户所熟悉，而不管它运行在何处。它类似于 ISO C 的 <code>strftime()</code> 函数支持的 &quot;<code>%c</code>&quot; 格式。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此日期的字符串表示形式（使用语言环境约定）。<DT><B>另请参见：</B><DD><CODE>DateFormat</CODE>, 
<A HREF="Date.html#toString()"><CODE>toString()</CODE></A>, 
<A HREF="Date.html#toGMTString()"><CODE>toGMTString()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="toGMTString()"><!-- --></A><H3>
toGMTString</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public <A HREF="../lang/String.html" title="java.lang 中的类">String</A> <B>toGMTString</B>()</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>DateFormat.format(Date date)</code> 取代，使用 GMT <code>TimeZone</code>。</I>
<P>
<DD>创建此 <tt>Date</tt> 对象的字符串表示形式，如下：
 <blockquote<pre>
 d mon yyyy hh:mm:ss GMT</pre></blockquote>
其中：<ul>
<li><i>d</i> 是一月中的某一天（<tt>1</tt> 至 <tt>31</tt>），显示为一位或两位十进制数。
<li><i>mon</i> 是月份 (<tt>Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec</tt>)。
<li><i>yyyy</i> 是年份，显示为 4 位十进制数。
<li><i>hh</i> 是一天中的小时（<tt>00</tt> 至 <tt>23</tt>），显示为两位进制数。
<li><i>mm</i> 是小时中的分钟（<tt>00</tt> 至 <tt>59</tt>），显示为两位十进制数。
<li><i>ss</i> 分钟中的秒数（<tt>00</tt> 至 <tt>61</tt>），显示为两位十进制数。
<li><i>GMT</i> 就是 ASCII 字母 &quot;<tt>GMT</tt>&quot;，代表格林威治标准时 (Greenwich Mean Time)。
 </ul><p>
结果不依赖于本地时区。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此日期的字符串表示形式（使用 Internet GMT 约定）。<DT><B>另请参见：</B><DD><CODE>DateFormat</CODE>, 
<A HREF="Date.html#toString()"><CODE>toString()</CODE></A>, 
<A HREF="Date.html#toLocaleString()"><CODE>toLocaleString()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getTimezoneOffset()"><!-- --></A><H3>
getTimezoneOffset</H3>
<PRE>
<FONT SIZE="-1"><A HREF="../lang/Deprecated.html" title="java.lang 中的注释">@Deprecated</A>
</FONT>public int <B>getTimezoneOffset</B>()</PRE>
<DL>
<DD><B>已过时。</B>&nbsp;<I>从 JDK 1.1 开始，由 <code>-(Calendar.get(Calendar.ZONE_OFFSET) + Calendar.get(Calendar.DST_OFFSET)) / (60 * 1000)</code> 取代。</I>
<P>
<DD>返回相对于 UTC（相应于此 <code>Date</code> 对象表示的时间）的本地时区的偏移量（以分钟为单位）。 
 <p>
例如，在马萨诸塞州，比格林威治时间晚 5 个时区：
 <blockquote><pre>
new Date(96, 1, 14).getTimezoneOffset() 返回 300</pre></blockquote>
因为在 1996 年 2 月 14 日，使用标准时间（东部标准时间），此时间和 UTC 有 5 小时的偏移量；但是：
 <blockquote><pre>
new Date(96, 5, 1).getTimezoneOffset() 返回 240</pre></blockquote>
因为在 1996 年  6 月 1 日，使用夏令时（东部日光时间），此时间和 UTC 只有 4 小时的偏移量。<p>
此方法产生与以下计算方式相同的结果：
 <blockquote><pre>
 (this.getTime() - UTC(this.getYear(), 
                       this.getMonth(), 
                       this.getDate(),
                       this.getHours(), 
                       this.getMinutes(), 
                       this.getSeconds())) / (60 * 1000)
 </pre></blockquote>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><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>, 
<A HREF="TimeZone.html#getDefault()"><CODE>TimeZone.getDefault()</CODE></A></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="跳过导航链接"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>概述</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>类</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/Date.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup>&nbsp;2&nbsp;Platform<br>Standard&nbsp;Ed. 5.0</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="Currency.html" title="java.util 中的类"><B>上一个类</B></A>&nbsp;
&nbsp;<A HREF="Dictionary.html" title="java.util 中的类"><B>下一个类</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../index.html@java_2Futil_2FDate.html" target="_top"><B>框架</B></A>  &nbsp;
&nbsp;<A HREF="Date.html" target="_top"><B>无框架</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../allclasses-noframe.html"><B>所有类</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../allclasses-noframe.html"><B>所有类</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  摘要：&nbsp;嵌套&nbsp;|&nbsp;字段&nbsp;|&nbsp;<A HREF="#constructor_summary">构造方法</A>&nbsp;|&nbsp;<A HREF="#method_summary">方法</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
详细信息：&nbsp;字段&nbsp;|&nbsp;<A HREF="#constructor_detail">构造方法</A>&nbsp;|&nbsp;<A HREF="#method_detail">方法</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<font size="-1"><a href="../../../../../../../../java.sun.com/cgi-bin/bugreport.cgi">提交错误或意见</a><br>有关更多的 API 参考资料和开发人员文档，请参阅 <a href="../../../../../../../../java.sun.com/j2se/1.5.0/docs/relnotes/devdocs-vs-specs.html">Java 2 SDK SE 开发人员文档</a>。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。 <p>版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守<a href="../../../../../../../../java.sun.com/j2se/1.5.0/docs/relnotes/license.html">许可证条款</a>。另请参阅<a href="../../../../../../../../java.sun.com/docs/redist.html">文档重新分发政策</a>。</font>
</BODY>
</HTML>