timezone.html

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

getDisplayName</H3>
<PRE>
public final <A HREF="../lang/String.html" title="java.lang 中的类">String</A> <B>getDisplayName</B>(<A HREF="Locale.html" title="java.util 中的类">Locale</A>&nbsp;locale)</PRE>
<DL>
<DD>返回适合于展示给指定区域的用户的时区名称。此方法返回长名称，不包括夏令时。如果显示名称对于区域不可用，那么此方法以<a href="#NormalizedCustomID">标准化自定义 ID 格式</a>返回一个字符串。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>locale</CODE> - 要提供显示名称的区域。
<DT><B>返回：</B><DD>给定区域中时区的可读名称，或者如果给定区域不可识别，则返回默认区域中时区的可读名称。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getDisplayName(boolean, int)"><!-- --></A><H3>
getDisplayName</H3>
<PRE>
public final <A HREF="../lang/String.html" title="java.lang 中的类">String</A> <B>getDisplayName</B>(boolean&nbsp;daylight,
                                   int&nbsp;style)</PRE>
<DL>
<DD>返回适合于展示给默认区域的用户的时区名称。如果显示名称对于区域不可用，那么此方法以<a href="#NormalizedCustomID">标准化自定义 ID 格式</a>返回一个字符串。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>daylight</CODE> - 如果为 true，则返回夏令时名称。<DD><CODE>style</CODE> - <code>LONG</code> 或 <code>SHORT</code>
<DT><B>返回：</B><DD>默认区域中时区的可读名称。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getDisplayName(boolean, int, java.util.Locale)"><!-- --></A><H3>
getDisplayName</H3>
<PRE>
public <A HREF="../lang/String.html" title="java.lang 中的类">String</A> <B>getDisplayName</B>(boolean&nbsp;daylight,
                             int&nbsp;style,
                             <A HREF="Locale.html" title="java.util 中的类">Locale</A>&nbsp;locale)</PRE>
<DL>
<DD>返回适合于展示给指定区域的用户的时区名称。如果显示名称对于区域不可用，那么此方法以<a href="#NormalizedCustomID">标准化自定义 ID 格式</a>返回一个字符串。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>daylight</CODE> - 如果为 true，返回夏令时名称。<DD><CODE>style</CODE> - <code>LONG</code> 或 <code>SHORT</code><DD><CODE>locale</CODE> - 要提供显示名称的区域。
<DT><B>返回：</B><DD>给定区域中时区的可读名称，或者如果给定的区域不可识别，则返回默认区域中时区的可读名称。
<DT><B>抛出：</B>
<DD><CODE><A HREF="../lang/IllegalArgumentException.html" title="java.lang 中的类">IllegalArgumentException</A></CODE> - 风格是无效的。<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getDSTSavings()"><!-- --></A><H3>
getDSTSavings</H3>
<PRE>
public int <B>getDSTSavings</B>()</PRE>
<DL>
<DD>返回要添加到本地标准时间以获取本地挂钟时间的时间量。
 <p>
如果此时区遵守夏令时规则，则默认的实现始终返回 3600000 毫秒（即 1 小时）。否则，返回 0（零）。
 <p>
如果基础 TimeZone 实现子类支持历史夏令时变化，则此方法返回已知的最新夏令时值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>节约的时间量（以毫秒为单位）<DT><B>从以下版本开始：</B></DT>
  <DD>1.4</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="useDaylightTime()"><!-- --></A><H3>
useDaylightTime</H3>
<PRE>
public abstract boolean <B>useDaylightTime</B>()</PRE>
<DL>
<DD>查询此时区是否使用夏令时。
 <p>
如果基础 <code>TimeZone</code> 实现子类支持历史夏令时安排变化，那么方法引用最新的夏令时安排信息。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>如果此时区使用夏令时，则返回 true，否则返回 false。</DL>
</DD>
</DL>
<HR>

<A NAME="inDaylightTime(java.util.Date)"><!-- --></A><H3>
inDaylightTime</H3>
<PRE>
public abstract boolean <B>inDaylightTime</B>(<A HREF="Date.html" title="java.util 中的类">Date</A>&nbsp;date)</PRE>
<DL>
<DD>查询给定的日期是否在此时区的夏令时中。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>date</CODE> - 给定的日期。
<DT><B>返回：</B><DD>如果给定的日期在夏令时中，则返回 true，否则返回 false。</DL>
</DD>
</DL>
<HR>

<A NAME="getTimeZone(java.lang.String)"><!-- --></A><H3>
getTimeZone</H3>
<PRE>
public static <A HREF="TimeZone.html" title="java.util 中的类">TimeZone</A> <B>getTimeZone</B>(<A HREF="../lang/String.html" title="java.lang 中的类">String</A>&nbsp;ID)</PRE>
<DL>
<DD>获取给定 ID 的 <code>TimeZone</code>。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>ID</CODE> - <code>TimeZone</code> 的 ID，要么是缩写（如 &quot;PST&quot; ），要么是全名（如 &quot;America/Los_Angeles&quot;），要么是自定义 ID（如 &quot;GMT-8:00&quot;）。注意，对缩写的支持只是出于 JDK 1.1.x 兼容性的考虑，因此应该使用全名。
<DT><B>返回：</B><DD>指定的 <code>TimeZone</code>，或者如果给定的 ID 无法理解，则返回 GMT 区域。</DL>
</DD>
</DL>
<HR>

<A NAME="getAvailableIDs(int)"><!-- --></A><H3>
getAvailableIDs</H3>
<PRE>
public static <A HREF="../lang/String.html" title="java.lang 中的类">String</A>[] <B>getAvailableIDs</B>(int&nbsp;rawOffset)</PRE>
<DL>
<DD>根据给定的时区偏移量获取可用的 ID。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>rawOffset</CODE> - 给定的时区 GMT 偏移量。
<DT><B>返回：</B><DD>一组 ID，其中该 ID 时区具有指定的 GMT 偏移量。例如，&quot;America/Phoenix&quot; 和 &quot;America/Denver&quot; 都有 GMT-07:00，但其夏令时行为是不同的。</DL>
</DD>
</DL>
<HR>

<A NAME="getAvailableIDs()"><!-- --></A><H3>
getAvailableIDs</H3>
<PRE>
public static <A HREF="../lang/String.html" title="java.lang 中的类">String</A>[] <B>getAvailableIDs</B>()</PRE>
<DL>
<DD>获取受支持的所有可用 ID。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>一组 ID。</DL>
</DD>
</DL>
<HR>

<A NAME="getDefault()"><!-- --></A><H3>
getDefault</H3>
<PRE>
public static <A HREF="TimeZone.html" title="java.util 中的类">TimeZone</A> <B>getDefault</B>()</PRE>
<DL>
<DD>获取此主机的默认 <code>TimeZone</code>。默认 <code>TimeZone</code> 的来源可能随实现的变化而变化。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>默认的 <code>TimeZone</code>。<DT><B>另请参见：</B><DD><A HREF="TimeZone.html#setDefault(java.util.TimeZone)"><CODE>setDefault(java.util.TimeZone)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setDefault(java.util.TimeZone)"><!-- --></A><H3>
setDefault</H3>
<PRE>
public static void <B>setDefault</B>(<A HREF="TimeZone.html" title="java.util 中的类">TimeZone</A>&nbsp;zone)</PRE>
<DL>
<DD>设置由 <code>getDefault</code> 方法返回的 <code>TimeZone</code>。如果 <code>zone</code> 为 null，把默认值重设为第一次启动虚拟机时的最初值。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>zone</CODE> - 新的默认时区<DT><B>另请参见：</B><DD><A HREF="TimeZone.html#getDefault()"><CODE>getDefault()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="hasSameRules(java.util.TimeZone)"><!-- --></A><H3>
hasSameRules</H3>
<PRE>
public boolean <B>hasSameRules</B>(<A HREF="TimeZone.html" title="java.util 中的类">TimeZone</A>&nbsp;other)</PRE>
<DL>
<DD>如果此区域和另一个区域具有相同的规则和偏移量，也就是说，如果此区域只可能在 ID 上与另一个区域不同，则返回 true。如果其他区域为 null，则返回 false。
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>other</CODE> - 要进行比较的 <code>TimeZone</code> 对象
<DT><B>返回：</B><DD>如果其他区域不为 null，并且与此区域不同（可能只有 ID 不同），则返回 true<DT><B>从以下版本开始：</B></DT>
  <DD>1.2</DD>
</DL>
</DD>
</DL>
<HR>

<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>创建此 <code>TimeZone</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#clone()">clone</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>此 <code>TimeZone</code> 的一个副本<DT><B>另请参见：</B><DD><A HREF="../lang/Cloneable.html" title="java.lang 中的接口"><CODE>Cloneable</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/TimeZone.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="TimerTask.html" title="java.util 中的类"><B>上一个类</B></A>&nbsp;
&nbsp;<A HREF="TooManyListenersException.html" title="java.util 中的类"><B>下一个类</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../index.html@java_2Futil_2FTimeZone.html" target="_top"><B>框架</B></A>  &nbsp;
&nbsp;<A HREF="TimeZone.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;<A HREF="#field_summary">字段</A>&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;<A HREF="#field_detail">字段</A>&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>