Calendar.Builder 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
Calendar.Builder 用于从各种日期时间参数创建 Calendar 。
[Android.Runtime.Register("java/util/Calendar$Builder", ApiSince=26, DoNotGenerateAcw=true)]
public class Calendar.Builder : Java.Lang.Object[<Android.Runtime.Register("java/util/Calendar$Builder", ApiSince=26, DoNotGenerateAcw=true)>]
type Calendar.Builder = class
inherit Object- 继承
- 属性
注解
Calendar.Builder 用于从各种日期时间参数创建 Calendar 。
有两种方法可以设置为 Calendar 日期时间值。 一个是将即时参数设置为与 Epoch 的毫秒偏移量。 另一种是将单个字段参数（例如 Calendar#YEAR YEAR）设置为所需的值。 这两种方法不能混合。 尝试同时设置即时字段和单个字段将导致 IllegalStateException 引发。 但是，允许重写先前的即时或字段参数值。
如果为确定日期和时间提供了足够的字段参数，则生成 Calendar日期和/或时间时将使用特定于日历的默认值。 例如，如果未 Calendar#YEAR YEAR 为公历指定值，将使用 1970。 如果字段参数之间存在任何冲突，则应用解决方案规则。 因此，字段设置的顺序很重要。
除了日期时间参数，还可以设置 #setLocale（区域设置）区域设置、#setTimeZone（TimeZone）时区、#setWeekDefinition（int、int）周定义和 #setLenient（布尔）宽大模式参数。
<b>示例</b>
下面是示例用法。 示例代码假定 Calendar 常量是静态导入的。
以下代码生成 Calendar 日期为 2012-12-31（公历），因为星期一是一周的第一天，具有 ISO 8601 兼容周参数。
Calendar cal = new Calendar.Builder().setCalendarType("iso8601")
.setWeekDate(2013, 1, MONDAY).build();
以下代码生成日期为 1989-01-08（公历）的日语 Calendar ，假定默认值 Calendar#ERA ERA 为 <当天开始的 em>Heisei</em> 。
Calendar cal = new Calendar.Builder().setCalendarType("japanese")
.setFields(YEAR, 1, DAY_OF_YEAR, 1).build();
已在 1.8 中添加。
Java文档java.util.Calendar.Builder。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
构造函数
| 名称 | 说明 |
|---|---|
| Calendar.Builder() |
构造一个 |
| Calendar.Builder(IntPtr, JniHandleOwnership) |
|
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| JniIdentityHashCode |
|
| JniPeerMembers |
|
| PeerReference |
|
| ThresholdClass |
|
| ThresholdType |
|
方法
| 名称 | 说明 |
|---|---|
| Build() |
返回 |
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| Dispose() |
|
| Dispose(Boolean) |
|
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| JavaFinalize() |
当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。 (继承自 Object) |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| Set(CalendarField, Int32) |
|
| SetCalendarType(String) |
|
| SetDate(Int32, Int32, Int32) |
|
| SetFields(Int32[]) |
|
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetInstant(Date) |
|
| SetInstant(Int64) |
|
| SetLenient(Boolean) |
|
| SetLocale(Locale) |
|
| SetTimeOfDay(Int32, Int32, Int32, Int32) |
|
| SetTimeOfDay(Int32, Int32, Int32) |
|
| SetTimeZone(TimeZone) |
|
| SetWeekDate(Int32, Int32, Int32) |
|
| SetWeekDefinition(Int32, Int32) |
|
| ToArray<T>() |
|
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
|
| Wait() |
使当前线程等待，直到唤醒它，通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
|
| IJavaPeerable.DisposeUnlessReferenced() |
|
| IJavaPeerable.Finalized() |
|
| IJavaPeerable.JniManagedPeerState |
|
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
| IJavaPeerable.SetPeerReference(JniObjectReference) |
|
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
|
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |