LocalDate 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
ISO-8601 日历系统中没有时区的日期,例如 2007-12-03。
[Android.Runtime.Register("java/time/LocalDate", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class LocalDate : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Time.Chrono.IChronoLocalDate
[<Android.Runtime.Register("java/time/LocalDate", ApiSince=26, DoNotGenerateAcw=true)>]
type LocalDate = class
inherit Object
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IChronoLocalDate
interface IComparable
interface ITemporal
interface ITemporalAccessor
interface ITemporalAdjuster
- 继承
- 特性
- 实现
注解
ISO-8601 日历系统中没有时区的日期,例如 2007-12-03。
LocalDate 是一个不可变的日期时间对象,该对象表示一个日期,通常被视为一年一天。 还可以访问其他日期字段,例如一年、一周和一周。 例如,值“2007 年 10 月 2 日”可以存储在一个 LocalDate中。
此类不存储或表示时间或时区。 相反,它是日期的说明,用于生日。 如果没有其他信息(例如偏移量或时区),它不能表示时间线上的即时。
ISO-8601 日历系统是当今世界上大多数地区使用的现代民用日历系统。 它相当于公历系统,在该系统中,今天的跨年规则一直适用。 对于今天编写的大多数应用程序,ISO-8601 规则是完全合适的。 但是,任何使用历史日期的应用程序,并要求它们准确将找到不适合的 ISO-8601 方法。
已在 1.8 中添加。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
属性
| 名称 | 说明 |
|---|---|
| Chronology |
获取此日期的计时表,即 ISO 日历系统。 |
| Class |
返回此 |
| DayOfMonth |
获取月份日期字段。 |
| DayOfWeek |
获取星期几字段,该字段是枚举 DayOfWeek。 |
| DayOfYear |
获取年份日期字段。 |
| Epoch |
纪元年 LocalDate,“1970-01-01”。 |
| Era |
获取此日期适用的纪元。 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| IsLeapYear |
根据 ISO proleptic 日历系统规则,检查年份是否为跃年。 |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
获取运行时上次分配的状态标志。 (继承自 JavaObject) |
| JniPeerMembers |
获取用于访问此Java绑定成员的 JNI 元数据。 |
| Max |
支持的最大 LocalDate,“+9999999999-12-31”。 |
| Min |
支持的最低 LocalDate,“-9999999999-01-01”。 |
| Month |
使用 Month 枚举获取年月字段。 |
| MonthValue |
获取从 1 到 12 的年月字段。 |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 (继承自 Object) |
| ThresholdType |
此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。 (继承自 Object) |
| Year |
获取年份字段。 |
方法
| 名称 | 说明 |
|---|---|
| AdjustInto(ITemporal) |
调整指定的临时对象,以具有与此对象相同的日期。 |
| AtStartOfDay() |
将此日期与午夜时间组合在一起,以在此日期开始时创建 LocalDateTime。 |
| AtStartOfDay(ZoneId) |
根据时区中的规则,从此日期最早的有效时间返回一个分区日期时间。 |
| AtTime(Int32, Int32, Int32, Int32) |
将此日期与创建 LocalDateTime 的时间组合在一起。 |
| AtTime(Int32, Int32, Int32) |
将此日期与创建 LocalDateTime 的时间组合在一起。 |
| AtTime(Int32, Int32) |
将此日期与创建 LocalDateTime 的时间组合在一起。 |
| AtTime(LocalTime) |
将此日期与创建 LocalDateTime 的时间组合在一起。 |
| AtTime(OffsetTime) |
将此日期与偏移时间组合在一起,以创建 OffsetDateTime。 |
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| CompareTo(IChronoLocalDate) |
将此日期与另一个日期进行比较。 |
| CompareTo(Object) |
将此对象与指定的顺序对象进行比较。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
将此对等方的构造委托给运行时的值管理器。 (继承自 JavaObject) |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
要求值管理器释放此对等方,除非其映射保留此相同的托管实例。 (继承自 JavaObject) |
| Equals(Object) |
测试另一个托管对等方是否引用同一Java对象。 (继承自 JavaObject) |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| Format(DateTimeFormatter) |
使用指定的格式化程序设置此日期的格式。 |
| From(ITemporalAccessor) |
从临时对象获取 LocalDate 的实例。 |
| Get(ITemporalField) |
获取此日期中指定字段的值作为 int。 |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| GetLong(ITemporalField) |
获取此日期中指定字段的值(长)。 |
| IsAfter(IChronoLocalDate) |
检查此日期是否在指定日期之后。 |
| IsBefore(IChronoLocalDate) |
检查此日期是否在指定日期之前。 |
| IsEqual(IChronoLocalDate) |
检查此日期是否等于指定的日期。 |
| IsSupported(ITemporalField) |
检查指定的字段是否受支持。 |
| IsSupported(ITemporalUnit) |
检查指定的单位是否受支持。 |
| JavaFinalize() |
已过时.
当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。 (继承自 Object) |
| LengthOfMonth() |
返回此日期表示的月份的长度。 |
| LengthOfYear() |
返回此日期所表示的年份的长度。 |
| Minus(Int64, ITemporalUnit) |
返回此日期的副本,并减去指定的金额。 |
| Minus(ITemporalAmount) |
返回此日期的副本,并减去指定的金额。 |
| MinusDays(Int64) |
返回此 LocalDate 的副本,其中包含指定的天数减去。 |
| MinusMonths(Int64) |
返回此 LocalDate 的副本,其中包含指定的月数减去。 |
| MinusWeeks(Int64) |
返回此 LocalDate 的副本,该副本的指定周数减去。 |
| MinusYears(Int64) |
返回此 LocalDate 的副本,该副本的指定年数减去。 |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| Now() |
从默认时区中的系统时钟获取当前日期。 |
| Now(Clock) |
从指定的时钟获取当前日期。 |
| Now(ZoneId) |
从指定时区中的系统时钟获取当前日期。 |
| Of(Int32, Int32, Int32) |
从一年、月和一天获取 LocalDate 实例。 |
| Of(Int32, Month, Int32) |
从一年、月和一天获取 LocalDate 实例。 |
| OfEpochDay(Int64) |
从纪元日计数中获取 LocalDate 实例。 |
| OfInstant(Instant, ZoneId) |
从即时 ID 和区域 ID 获取 LocalDate 实例。 |
| OfYearDay(Int32, Int32) |
从一年和一天获取 LocalDate 的实例。 |
| Parse(ICharSequence, DateTimeFormatter) |
使用特定格式化程序从文本字符串中获取 LocalDate 的实例。 |
| Parse(ICharSequence) |
从文本字符串(如 2007-12-03)获取 LocalDate 的实例。 |
| Parse(String, DateTimeFormatter) |
使用指定的格式化程序分析本地日期字符串。 |
| Parse(String) |
分析字符串中的 ISO 本地日期。 |
| Plus(Int64, ITemporalUnit) |
返回此日期的副本,其中包含添加的指定金额。 |
| Plus(ITemporalAmount) |
返回此日期的副本,其中包含添加的指定金额。 |
| PlusDays(Int64) |
返回此 LocalDate 的副本,其中添加了指定的天数。 |
| PlusMonths(Int64) |
返回此 LocalDate 的副本,其中添加了指定的月数。 |
| PlusWeeks(Int64) |
返回此 LocalDate 的副本,并添加指定的周数。 |
| PlusYears(Int64) |
返回此 LocalDate 的副本,其中添加了指定的年数。 |
| Query(ITemporalQuery) |
使用指定的查询查询此日期。 |
| Range(ITemporalField) |
获取指定字段的有效值范围。 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。 (继承自 JavaObject) |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToEpochDay() |
获取此日期作为相对于 |
| ToEpochSecond(LocalTime, ZoneOffset) |
将此 LocalDate 转换为自 1970-01-01T00:00:00Z 以来的秒数。 |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterFromRuntime() |
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| Until(IChronoLocalDate) |
计算此日期与另一个日期之间的周期作为句点。 |
| Until(ITemporal, ITemporalUnit) |
计算指定单位中另一个日期之前的时间量。 |
| Wait() |
导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。 (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。 (继承自 Object) |
| With(ITemporalAdjuster) |
返回此日期的调整副本。 |
| With(ITemporalField, Int64) |
返回此日期的副本,并将指定的字段设置为新值。 |
| WithDayOfMonth(Int32) |
返回此 LocalDate 的副本,其中更改了月份日期。 |
| WithDayOfYear(Int32) |
返回此 LocalDate 的副本,并更改了一年中的日期。 |
| WithMonth(Int32) |
返回此 LocalDate 的副本,其中更改了年月。 |
| WithYear(Int32) |
返回此 LocalDate 的副本,更改年份。 |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
从运行时的Java对象查找中删除此实例。 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |