语言

Calendar.Builder 类

定义

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.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。

Calendar.Builder(IntPtr, JniHandleOwnership)

创建表示现有Java对象的托管实例。

属性

名称 说明
Class

返回此 Object的运行时类。

(继承自 Object)
Handle

基础 Android 实例的句柄。

(继承自 Object)
JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

获取用于访问此Java绑定成员的 JNI 元数据。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
ThresholdClass

获取用于虚拟方法调度的 Java 类。

ThresholdType

获取声明此Java绑定的托管类型。

方法

名称 说明
Build()

返回 Calendar 由 setter 方法设置的参数生成的值。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
Set(CalendarField, Int32)

将字段参数设置为给定值。

SetCalendarType(String)

将日历类型参数设置为给定类型。

SetDate(Int32, Int32, Int32)

将日期字段参数设置为按年、月和 dayOfMonth 给出的值。

SetFields(Int32[])

将字段参数设置为字段值(由字段值对的 fieldValuePairs 给出的值)。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetInstant(Date)

将即时参数设置为 Date 给定的即时值。

SetInstant(Int64)

将即时参数设置为给定的即时值,该值与 Epoch 偏移量一毫秒。

SetLenient(Boolean)

将宽模式参数设置为 lenient 给出的值。

SetLocale(Locale)

将区域设置参数设置为给定的区域设置。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
SetTimeOfDay(Int32, Int32, Int32, Int32)

将天字段参数的时间设置为 hourOfDay、minute、second 和 millis 给出的值。

SetTimeOfDay(Int32, Int32, Int32)

将日期字段参数的时间设置为 hourOfDay、minute 和 second 给出的值。

SetTimeZone(TimeZone)

将时区参数设置为给定区域。

SetWeekDate(Int32, Int32, Int32)

将基于周的日期参数设置为具有给定日期说明符的值 - 周年、年和周中的一天。

SetWeekDefinition(Int32, Int32)

将周定义参数设置为 firstDayOfWeek 和 minimalDaysInFirstWeek 给出的值,这些值用于确定一年的第一周。

ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
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()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于