GregorianCalendar 类

定义

[Android.Runtime.Register("java/util/GregorianCalendar", DoNotGenerateAcw=true)]
public class GregorianCalendar : Java.Util.Calendar

[<Android.Runtime.Register("java/util/GregorianCalendar", DoNotGenerateAcw=true)>]
type GregorianCalendar = class
    inherit Calendar

继承

Object

Object

Calendar

GregorianCalendar

属性

RegisterAttribute

注解

GregorianCalendar 是一个具体子类 Calendar ，提供世界上大多数使用的标准日历系统。

GregorianCalendar 是一个混合日历，支持朱利安和公历系统，支持单个不连续，默认情况下对应于公历的建立日期（10 月 15 日，1582 年 10 月 15 日在某些国家/地区，后来又在其他国家）。 调用方 #setGregorianChange(Date) setGregorianChange()可以更改直接转换日期。

从历史上看，在那些先采用公历的国家，1582年10月4日（朱利安）之后是1582年10月15日（公历）。 此日历可正确建模。 在公历直接转换之前， GregorianCalendar 实现朱利安日历。 公历和朱利安日历的唯一区别是跃年规则。 朱利安日历每四年指定一次跃年，而公历则省略百年，而 400 年不可见的世纪年。

GregorianCalendar <实现 em>proleptic</em> Gregorian 和 Julian 日历。 也就是说，通过无限期地向后和向前推断当前规则来计算日期。 因此， GregorianCalendar 可用于所有年份，以生成有意义的和一致的结果。 但是，使用日期 GregorianCalendar 在历史上仅从 3 月 1 日 4 AD 开始准确，当时采用现代朱利安日历规则。 在此日期之前，跳跃年规则被不规则地应用，在公元前45年之前，朱利安日历甚至不存在。

在公历机构之前，元旦是3月25日。 为了避免混淆，此日历始终使用 1 月 1 日。 如果需要在公历公历更改前的日期以及介于 1 月 1 日至 3 月 24 日期间的日期，可以进行手动调整。

<h2>“week_and_year”>年周和周年</h2>

为 Calendar#WEEK_OF_YEAR WEEK_OF_YEAR 字段计算的值范围为 1 到 53。 日历年的第一周是最早的七天时段，从该时间段开始 Calendar#getFirstDayOfWeek() getFirstDayOfWeek() ，该时间段至少包含该年份的 Calendar#getMinimalDaysInFirstWeek() getMinimalDaysInFirstWeek() 天数。 因此，这取决于 1 月 1 日一周的值getMinimalDaysInFirstWeek()getFirstDayOfWeek()和日期。 第 1 周到第二年的第 1 周（独占）按顺序编号为 2 到 52 或 53（除参与 Julian-Gregorian 过渡的年份除外）。

构造区域设置相关的资源时GregorianCalendar，使用getFirstDayOfWeek()依赖区域设置的资源初始化这些和getMinimalDaysInFirstWeek()值。 “iso8601_compatible_setting”>周确定与 ISO 8601 标准（如果为 MONDAYgetMinimalDaysInFirstWeek() 4）getFirstDayOfWeek()兼容，在首选标准的区域设置中使用哪些值。 可以通过调用 Calendar#setFirstDayOfWeek(int) setFirstDayOfWeek() 和 Calendar#setMinimalDaysInFirstWeek(int) setMinimalDaysInFirstWeek().

“week_year”><em>周年</em> 与周期 WEEK_OF_YEAR 同步。 第一周和最后几周（含）之间的所有周具有相同 <的 em>周年</em> 值。 因此，一周中的第一天和最后几天可能具有不同的日历年值。

例如，1998 年 1 月 1 日是星期四。 如果 getFirstDayOfWeek() 为 MONDAYgetMinimalDaysInFirstWeek() 4（ISO 8601 标准兼容设置），则 1998 年 12 月 29 日开始于 1997 年 12 月 29 日，结束于 1998 年 1 月 4 日。 1997年日历年的最后三天，该周年为1998年。 然而， getFirstDayOfWeek()SUNDAY如果是，则1998年1月4日的第1周从1998年1月4日开始，1998年1月10日结束;1998年的头三天则属于1997年第53周，其周年为1997年。

<h3>月</h3 周>

为 WEEK_OF_MONTH 字段范围从 0 到 6 计算的值。 一个月的第 1 周（ WEEK_OF_MONTH = 1与日）是该月中最早的 getMinimalDaysInFirstWeek() 连续天数集，结束于前一 getFirstDayOfWeek()天。 与一年的第 1 周不同，一个月的第 1 周可能短于 7 天，不需要开始 getFirstDayOfWeek()，并且不包括前一个月的天数。 第 1 周前一个月的天数为 WEEK_OF_MONTH 0。

例如，如果 getFirstDayOfWeek() 为 SUNDAYgetMinimalDaysInFirstWeek() 4，则 1998 年 1 月的第一周为 1 月 4 日至 1 月 10 日星期六。 这些天有 1 个 WEEK_OF_MONTH 。 星期四，1月1日至周六，1月3日有一个 WEEK_OF_MONTH 0。 如果 getMinimalDaysInFirstWeek() 更改为 3，则 1 月 1 日至 1 月 3 日有 1 个 WEEK_OF_MONTH 。

<h3>默认字段值</h3>

该方法 clear 设置未定义的日历字段。 GregorianCalendar 如果未定义日历字段的值，则为每个日历字段使用以下默认值。

<table class=“striped” style=“text-align： left;width： 66%;”><caption style=“display：none”>GregorianCalendar default field values/caption<>thead<>tr<>th scope=“col”> Field </th><scope=“col”> Default Value <</th/tr<>/thead><tbody<>tr><th scope=“row”ERA<>/th><<> td><AD/tr<>tr<>th scope=“row”<>YEAR/th<>td><>1970</td></tr><tr><th scope=“row”>MONTH</th><td/td>><<JANUARY/tr><tr><th scope=“row”><DAY_OF_MONTH/th><td/td>1><</tr><tr><th scope=“row”><DAY_OF_WEEK/th><td/td></tr tr><th scope=“row”><WEEK_OF_MONTH/th><td>the first day of week0<></<>td></tr><tr><th scope=“row”>DAY_OF_WEEK_IN_MONTH</th><td/td><><1/tr><tr><th scope=“row”>AM_PM</th><td/td><<AM>/tr><tr><th scope=“row”><HOUR, HOUR_OF_DAY, MINUTE, SECOND, MILLISECOND/th><td/td><0<>/tr></tbody></table br>><默认值不适用于上面未列出的字段。

<strong Example：>/strong<><blockquote>

// 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)
                System.exit(0);

             // begin output
            System.out.println("Current Time");

            // create a Pacific Standard Time time zone
            SimpleTimeZone pdt = new SimpleTimeZone(-8 * 60 * 60 * 1000, ids[0]);

            // set up rules for Daylight Saving Time
            pdt.setStartRule(Calendar.APRIL, 1, Calendar.SUNDAY, 2 * 60 * 60 * 1000);
            pdt.setEndRule(Calendar.OCTOBER, -1, Calendar.SUNDAY, 2 * 60 * 60 * 1000);

            // create a GregorianCalendar with the Pacific Daylight time zone
            // and the current date and time
            Calendar calendar = new GregorianCalendar(pdt);
            Date trialTime = new Date();
            calendar.setTime(trialTime);

            // print out a bunch of interesting things
            System.out.println("ERA: " + calendar.get(Calendar.ERA));
            System.out.println("YEAR: " + calendar.get(Calendar.YEAR));
            System.out.println("MONTH: " + calendar.get(Calendar.MONTH));
            System.out.println("WEEK_OF_YEAR: " + calendar.get(Calendar.WEEK_OF_YEAR));
            System.out.println("WEEK_OF_MONTH: " + calendar.get(Calendar.WEEK_OF_MONTH));
            System.out.println("DATE: " + calendar.get(Calendar.DATE));
            System.out.println("DAY_OF_MONTH: " + calendar.get(Calendar.DAY_OF_MONTH));
            System.out.println("DAY_OF_YEAR: " + calendar.get(Calendar.DAY_OF_YEAR));
            System.out.println("DAY_OF_WEEK: " + calendar.get(Calendar.DAY_OF_WEEK));
            System.out.println("DAY_OF_WEEK_IN_MONTH: "
                               + calendar.get(Calendar.DAY_OF_WEEK_IN_MONTH));
            System.out.println("AM_PM: " + calendar.get(Calendar.AM_PM));
            System.out.println("HOUR: " + calendar.get(Calendar.HOUR));
            System.out.println("HOUR_OF_DAY: " + calendar.get(Calendar.HOUR_OF_DAY));
            System.out.println("MINUTE: " + calendar.get(Calendar.MINUTE));
            System.out.println("SECOND: " + calendar.get(Calendar.SECOND));
            System.out.println("MILLISECOND: " + calendar.get(Calendar.MILLISECOND));
            System.out.println("ZONE_OFFSET: "
                               + (calendar.get(Calendar.ZONE_OFFSET)/(60*60*1000)));
            System.out.println("DST_OFFSET: "
                               + (calendar.get(Calendar.DST_OFFSET)/(60*60*1000)));
            System.out.println("Current Time, with hour reset to 3");
            calendar.clear(Calendar.HOUR_OF_DAY); // so doesn't override
            calendar.set(Calendar.HOUR, 3);
            System.out.println("ERA: " + calendar.get(Calendar.ERA));
            System.out.println("YEAR: " + calendar.get(Calendar.YEAR));
            System.out.println("MONTH: " + calendar.get(Calendar.MONTH));
            System.out.println("WEEK_OF_YEAR: " + calendar.get(Calendar.WEEK_OF_YEAR));
            System.out.println("WEEK_OF_MONTH: " + calendar.get(Calendar.WEEK_OF_MONTH));
            System.out.println("DATE: " + calendar.get(Calendar.DATE));
            System.out.println("DAY_OF_MONTH: " + calendar.get(Calendar.DAY_OF_MONTH));
            System.out.println("DAY_OF_YEAR: " + calendar.get(Calendar.DAY_OF_YEAR));
            System.out.println("DAY_OF_WEEK: " + calendar.get(Calendar.DAY_OF_WEEK));
            System.out.println("DAY_OF_WEEK_IN_MONTH: "
                               + calendar.get(Calendar.DAY_OF_WEEK_IN_MONTH));
            System.out.println("AM_PM: " + calendar.get(Calendar.AM_PM));
            System.out.println("HOUR: " + calendar.get(Calendar.HOUR));
            System.out.println("HOUR_OF_DAY: " + calendar.get(Calendar.HOUR_OF_DAY));
            System.out.println("MINUTE: " + calendar.get(Calendar.MINUTE));
            System.out.println("SECOND: " + calendar.get(Calendar.SECOND));
            System.out.println("MILLISECOND: " + calendar.get(Calendar.MILLISECOND));
            System.out.println("ZONE_OFFSET: "
                   + (calendar.get(Calendar.ZONE_OFFSET)/(60*60*1000))); // in hours
            System.out.println("DST_OFFSET: "
                   + (calendar.get(Calendar.DST_OFFSET)/(60*60*1000))); // in hours

</blockquote>

在 1.1 中添加。

Java文档java.util.GregorianCalendar。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。