gregoriancalendar.html
来自「j2se5-api-zh,java文档的中文版本」· HTML 代码 · 共 1,118 行 · 第 1/5 页
HTML
1,118 行
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc (build 1.5.0_03) on Wed Nov 02 09:50:50 CST 2005 --><META http-equiv="Content-Type" content="text/html; charset=gb2312"><TITLE>GregorianCalendar (Java 2 Platform SE 5.0)</TITLE><META NAME="keywords" CONTENT="java.util.GregorianCalendar class"><LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style"><SCRIPT type="text/javascript">function windowTitle(){ parent.document.title="GregorianCalendar (Java 2 Platform SE 5.0)";}</SCRIPT><NOSCRIPT></NOSCRIPT></HEAD><BODY BGCOLOR="white" onload="windowTitle();"><!-- ========= START OF TOP NAVBAR ======= --><A NAME="navbar_top"><!-- --></A><A HREF="#skip-navbar_top" title="跳过导航链接"></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""><TR><TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_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> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>类</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/GregorianCalendar.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM><b>Java<sup><font size=-2>TM</font></sup> 2 Platform<br>Standard Ed. 5.0</b></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="FormatterClosedException.html" title="java.util 中的类"><B>上一个类</B></A> <A HREF="HashMap.html" title="java.util 中的类"><B>下一个类</B></A></FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../index.html@java_2Futil_2FGregorianCalendar.html" target="_top"><B>框架</B></A> <A HREF="GregorianCalendar.html" target="_top"><B>无框架</B></A> <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"> 摘要： 嵌套 | <A HREF="#field_summary">字段</A> | <A HREF="#constructor_summary">构造方法</A> | <A HREF="#method_summary">方法</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">详细信息： <A HREF="#field_detail">字段</A> | <A HREF="#constructor_detail">构造方法</A> | <A HREF="#method_detail">方法</A></FONT></TD></TR></TABLE><A NAME="skip-navbar_top"></A><!-- ========= END OF TOP NAVBAR ========= --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">java.util</FONT><BR>类 GregorianCalendar</H2><PRE><A HREF="../lang/Object.html" title="java.lang 中的类">java.lang.Object</A> <IMG SRC="../../resources/inherit.gif" ALT="继承者 "><A HREF="Calendar.html" title="java.util 中的类">java.util.Calendar</A> <IMG SRC="../../resources/inherit.gif" ALT="继承者 "><B>java.util.GregorianCalendar</B></PRE><DL><DT><B>所有已实现的接口：</B> <DD>java.io.Serializable, <A HREF="../lang/Cloneable.html" title="java.lang 中的接口">Cloneable</A>, <A HREF="../lang/Comparable.html" title="java.lang 中的接口">Comparable</A><<A HREF="Calendar.html" title="java.util 中的类">Calendar</A>></DD></DL><HR><DL><DT><PRE>public class <B>GregorianCalendar</B><DT>extends <A HREF="Calendar.html" title="java.util 中的类">Calendar</A></DL></PRE><P><code>GregorianCalendar</code> 是 <code>Calendar</code> 的一个具体子类，提供了世界上大多数国家使用的标准日历系统。<p> <code>GregorianCalendar</code> 是一种混合日历，在单一间断性的支持下同时支持儒略历和格里高利历系统，在默认情况下，它对应格里高利日历创立时的格里高利历日期（某些国家是在 1582 年 10 月 15 日创立，在其他国家要晚一些）。可由调用方通过调用 <A HREF="GregorianCalendar.html#setGregorianChange(java.util.Date)"><CODE>setGregorianChange()</CODE></A> 来更改起始日期。 <p>历史上，在那些首先采用格里高利历的国家中，1582 年 10 月 4 日（儒略历）之后就是 1582 年 10 月 15 日（格里高利历）。此日历正确地模拟了这些变化。在开始格里高利历之前，<code>GregorianCalendar</code> 实现的是儒略历。格里高利历和儒略历之间的惟一区别就是闰年规则。儒略历指定每 4 年就为闰年，而格里高利历则忽略不能被 400 整除的世纪年。 <p><code>GregorianCalendar</code> 可实现<em>预期的</em> 格里高利历和儒略历。也就是说，可以通过在时间上无限地向后或向前外推当前规则来计算日期。因此，对于所有的年份，都可以使用 <code>GregorianCalendar</code> 来生成有意义并且一致的结果。但是，采用现代儒略历规则时，使用 <code>GregorianCalendar</code> 得到的日期只在历史上从公元 4 年 3 月 1 日之后是准确的。在此日期之前，闰年规则的应用没有规则性，在 45 BC 之前，甚至不存在儒略历。 <p>在格里高利历创立以前，新年是 3 月 25 日。为了避免混淆，此日历始终使用 1 月 1 日为新年。如果想要格里高利历转换之前并且处于 1 月 1 日和 3 月 24 日之间的日期，则可以进行手动调整。<p>为 <code>WEEK_OF_YEAR</code> 字段所计算的值的范围从 1 到 53。一年的第一个星期始于 <code>getFirstDayOfWeek()</code> 的最早 7 天，至少包含该年的 <code>getMinimalDaysInFirstWeek()</code> 各天。这取决于 <code>getMinimalDaysInFirstWeek()</code>、<code>getFirstDayOfWeek()</code> 的值以及 1 月 1 日是星期几。一年的第一个星期和下一年的第一个星期之间的各个星期按顺序从 2 到 52 或 53（根据需要）进行编号。<p>例如，1998 年 1 月 1 日是星期四。如果 <code>getFirstDayOfWeek()</code> 为 <code>MONDAY</code>，并且 <code>getMinimalDaysInFirstWeek()</code> 为 4（这些值反映了 ISO 8601 和很多国家标准），则 1998 年的第一个星期开始于 1997 年 12 月 29 日，结束于 1998 年 1 月 4 日。但是，如果 <code>getFirstDayOfWeek()</code> 为 <code>SUNDAY</code>，那么 1998 年的第一个星期开始于 1998 年 1 月 4 日，结束于 1998 年 1 月 10 日；1998 年头三天是 1997 年第 53 个星期的一部分。<p>为 <code>WEEK_OF_MONTH</code> 字段所计算的值的范围从 0 到 6。一个月的第一个星期（<code>WEEK_OF_MONTH = 1</code> 的日期）是该月至少连续 <code>getMinimalDaysInFirstWeek()</code> 天中的最早日期，结束于 <code>getFirstDayOfWeek()</code> 的前一天。与一年的第一个星期不同，一个月的第一个星期可能短于 7 天，也不必从 <code>getFirstDayOfWeek()</code> 这一天开始，并且不包括前一个月的日期。在第一个星期之前该月日期的 <code>WEEK_OF_MONTH</code> 为 0。<p>例如，如果 <code>getFirstDayOfWeek()</code> 为 <code>SUNDAY</code>，<code>getMinimalDaysInFirstWeek()</code> 为 4，那么 1998 年 1 月的第一个星期是从 1 月 4 日星期日到 1 月 10 日星期六。这些天的 <code>WEEK_OF_MONTH</code> 为 1。1 月 1 日星期四到 1 月 3 日星期六的 <code>WEEK_OF_MONTH</code> 为 0。如果 <code>getMinimalDaysInFirstWeek()</code> 变为 3，则 1 月 1 日到 1 月 3 日的 <code>WEEK_OF_MONTH</code> 为 1。<p><code>clear</code> 方法将日历字段设置为未定义。<code>GregorianCalendar</code> 为每个日历字段使用以下默认值（如果该值未定义）。 <table cellpadding="0" cellspacing="3" border="0" summary="GregorianCalendar default field values" style="text-align: left; width: 66%;"> <tbody> <tr><th style="vertical-align: top; background-color: rgb(204, 204, 255); text-align: center;">字段<br> </th><th style="vertical-align: top; background-color: rgb(204, 204, 255); text-align: center;">默认值<br> </th> </tr> <tr> <td style="vertical-align: middle;"> <code>ERA<br></code> </td> <td style="vertical-align: middle;"> <code>AD<br></code> </td> </tr> <tr> <td style="vertical-align: middle; background-color: rgb(238, 238, 255);"> <code>YEAR<br></code> </td> <td style="vertical-align: middle; background-color: rgb(238, 238, 255);"> <code>1970<br></code> </td> </tr> <tr> <td style="vertical-align: middle;"> <code>MONTH<br></code> </td> <td style="vertical-align: middle;"> <code>JANUARY<br></code> </td> </tr> <tr> <td style="vertical-align: top; background-color: rgb(238, 238, 255);"> <code>DAY_OF_MONTH<br></code> </td> <td style="vertical-align: top; background-color: rgb(238, 238, 255);"> <code>1<br></code> </td> </tr> <tr> <td style="vertical-align: middle;"> <code>DAY_OF_WEEK<br></code> </td> <td style="vertical-align: middle;"> <code>一个星期的第一天<br></code> </td> </tr> <tr> <td style="vertical-align: top; background-color: rgb(238, 238, 255);"> <code>WEEK_OF_MONTH<br></code> </td> <td style="vertical-align: top; background-color: rgb(238, 238, 255);"> <code>0<br></code> </td> </tr> <tr> <td style="vertical-align: top;"> <code>DAY_OF_WEEK_IN_MONTH<br></code> </td> <td style="vertical-align: top;"> <code>1<br></code> </td> </tr> <tr> <td style="vertical-align: middle; background-color: rgb(238, 238, 255);"> <code>AM_PM<br></code> </td> <td style="vertical-align: middle; background-color: rgb(238, 238, 255);"> <code>AM<br></code> </td> </tr> <tr> <td style="vertical-align: middle;"> <code>HOUR, HOUR_OF_DAY, MINUTE, SECOND, MILLISECOND<br></code> </td> <td style="vertical-align: middle;"> <code>0<br></code> </td> </tr> </tbody> </table><br>默认值不适用于以上未列出的字段。 <p><strong>示例：</strong> <blockquote> <pre> // get the supported ids for GMT-08:00 (Pacific Standard Time) String[] ids = TimeZone.getAvailableIDs(-8 * 60 * 60 * 1000); // if no ids were returned, something is wrong. get out. if (ids.length == 0)⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?