OffsetDateTime 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 2007-12-03T10:15:30+01:00。
[Android.Runtime.Register("java/time/OffsetDateTime", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class OffsetDateTime : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable, Java.Time.Temporal.ITemporal, Java.Time.Temporal.ITemporalAdjuster[<Android.Runtime.Register("java/time/OffsetDateTime", ApiSince=26, DoNotGenerateAcw=true)>]
type OffsetDateTime = class
inherit Object
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IComparable
interface ITemporal
interface ITemporalAccessor
interface ITemporalAdjuster- 继承
- 属性
- 实现
注解
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 2007-12-03T10:15:30+01:00。
OffsetDateTime 是具有偏移量的日期时间的不可变表示形式。 此类将所有日期和时间字段存储为纳秒精度以及 UTC/格林威治的偏移量。 例如，值“2007 年 10 月 2 日 13：45：30.123456789 +02：00”可以存储在一个中 OffsetDateTime。
OffsetDateTime， java.time.ZonedDateTime 并且 java.time.Instant 所有存储时间线到纳米秒精度的即时。
Instant 是最简单的，只是表示即时。
OffsetDateTime 将偏移量添加到 UTC/格林威治的即时，以便获取本地日期时间。
ZonedDateTime 添加完整的时区规则。
它旨在ZonedDateTimeInstant或用于在更简单的应用程序中为数据建模。 在更详细地对日期时间概念进行建模或与数据库或网络协议通信时，可以使用此类。
已在 1.8 中添加。
适用于 . 的 java.time.OffsetDateTimeJava 文档
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
属性
| 名称 | 说明 |
|---|---|
| Class |
返回此 |
| DayOfMonth |
获取月份日期字段。 |
| DayOfWeek |
获取星期几字段，该字段是枚举 DayOfWeek。 |
| DayOfYear |
获取年份日期字段。 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| Hour |
获取“天小时”字段。 |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| JniPeerMembers |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| Max |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| Min |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| Minute |
获取小时分钟字段。 |
| Month |
使用 Month 枚举获取年月字段。 |
| MonthValue |
获取从 1 到 12 的年月字段。 |
| Nano |
获取 nano-of-second 字段。 |
| Offset |
获取区域偏移量，例如“+01：00”。 |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| Second |
获取分钟秒字段。 |
| ThresholdClass |
此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 (继承自 Object) |
| ThresholdType |
此 API 支持 Mono for Android 基础结构，不打算直接从代码使用。 (继承自 Object) |
| Year |
获取年份字段。 |
方法
| 名称 | 说明 |
|---|---|
| AdjustInto(ITemporal) |
调整指定的时态对象，以具有与此对象相同的偏移量、日期和时间。 |
| AtZoneSameInstant(ZoneId) |
将此日期时间与时区组合在一起，以创建 ZonedDateTime，确保结果的即时性相同。 |
| AtZoneSimilarLocal(ZoneId) |
将此日期时间与时区组合在一起，以创建一个 ZonedDateTime，试图保留相同的本地日期和时间。 |
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| CompareTo(OffsetDateTime) |
将此日期时间与其他日期时间进行比较。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| Equals(Object) |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| Format(DateTimeFormatter) |
使用指定的格式化程序设置此日期时间的格式。 |
| From(ITemporalAccessor) |
从临时对象获取 OffsetDateTime 的实例。 |
| Get(ITemporalField) |
从此日期时间获取作为 int 的指定字段的值。 |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| GetLong(ITemporalField) |
从此日期时间获取指定字段的值（长）。 |
| IsAfter(OffsetDateTime) |
检查此日期时间的即时是否在指定日期时间之后。 |
| IsBefore(OffsetDateTime) |
检查此日期时间的即时是否在指定的日期时间之前。 |
| IsEqual(OffsetDateTime) |
检查此日期时间的即时是否等于指定日期时间的实例。 |
| IsSupported(ITemporalField) |
检查指定的字段是否受支持。 |
| IsSupported(ITemporalUnit) |
检查指定的单位是否受支持。 |
| JavaFinalize() |
当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。 (继承自 Object) |
| Minus(Int64, ITemporalUnit) |
返回此日期时间的副本，并减去指定的金额。 |
| Minus(ITemporalAmount) |
返回此日期时间的副本，并减去指定的金额。 |
| MinusDays(Int64) |
返回此 OffsetDateTime 的副本，其中包含指定的天数减去。 |
| MinusHours(Int64) |
返回此 OffsetDateTime 的副本，并减去指定的小时数。 |
| MinusMinutes(Int64) |
返回此 OffsetDateTime 的副本，其中包含指定的分钟数减去。 |
| MinusMonths(Int64) |
返回此 OffsetDateTime 的副本，其中包含指定的月数减去。 |
| MinusNanos(Int64) |
返回此 OffsetDateTime 的副本，其指定的纳秒数减去。 |
| MinusSeconds(Int64) |
返回此 OffsetDateTime 的副本，其中包含指定的秒数减去。 |
| MinusWeeks(Int64) |
返回此 OffsetDateTime 的副本，该副本的指定周数减去。 |
| MinusYears(Int64) |
返回此 OffsetDateTime 的副本，其中包含指定的年数减去。 |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| Now() |
从默认时区中的系统时钟获取当前日期时间。 |
| Now(Clock) |
从指定的时钟获取当前日期时间。 |
| Now(ZoneId) |
从指定时区中的系统时钟获取当前日期时间。 |
| Of(Int32, Int32, Int32, Int32, Int32, Int32, Int32, ZoneOffset) |
从一年、月、日、小时、分钟、秒、nanosecond 和 offset 获取 OffsetDateTime 的实例。 |
| Of(LocalDate, LocalTime, ZoneOffset) |
从日期、时间和偏移量获取 OffsetDateTime 的实例。 |
| Of(LocalDateTime, ZoneOffset) |
从日期时间和偏移量获取 OffsetDateTime 的实例。 |
| OfInstant(Instant, ZoneId) |
从即时 ID 和区域 ID 获取 OffsetDateTime 的实例。 |
| Parse(ICharSequence, DateTimeFormatter) |
使用特定格式化程序从文本字符串中获取 OffsetDateTime 的实例。 |
| Parse(ICharSequence) |
从文本字符串（如 2007-12-03T10：15：30+01：00）获取 OffsetDateTime 的实例。 |
| Parse(String, DateTimeFormatter) |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| Parse(String) |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| Plus(Int64, ITemporalUnit) |
返回此日期时间的副本，其中包含添加的指定数量。 |
| Plus(ITemporalAmount) |
返回此日期时间的副本，其中包含添加的指定数量。 |
| PlusDays(Int64) |
返回此 OffsetDateTime 的副本，其中添加了指定的天数。 |
| PlusHours(Int64) |
返回此 OffsetDateTime 的副本，并添加指定的小时数。 |
| PlusMinutes(Int64) |
返回此 OffsetDateTime 的副本，其中添加了指定的分钟数。 |
| PlusMonths(Int64) |
返回此 OffsetDateTime 的副本，其中添加了指定的月份数。 |
| PlusNanos(Int64) |
返回此 OffsetDateTime 的副本，其中添加了指定的纳秒数。 |
| PlusSeconds(Int64) |
返回此 OffsetDateTime 的副本，其中添加了指定的秒数。 |
| PlusWeeks(Int64) |
返回此 OffsetDateTime 的副本，其中添加了指定的周数。 |
| PlusYears(Int64) |
返回此 OffsetDateTime 的副本，其中添加了指定的年数。 |
| Query(ITemporalQuery) |
使用指定的查询查询此日期时间。 |
| Range(ITemporalField) |
获取指定字段的有效值范围。 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| TimeLineOrder() |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToEpochSecond() |
将此日期时间转换为 1970-01-01T00：00：00Z 的纪元秒数。 |
| ToInstant() |
将此日期时间转换为即时。 |
| ToLocalDate() |
获取此日期时间的 LocalDate 部分。 |
| ToLocalDateTime() |
获取此日期时间的 LocalDateTime 部分。 |
| ToLocalTime() |
获取此日期时间的 LocalTime 部分。 |
| ToOffsetTime() |
将此日期时间转换为 OffsetTime。 |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| ToZonedDateTime() |
将此日期时间转换为 ZonedDateTime，并使用偏移量作为区域 ID。 |
| TruncatedTo(ITemporalUnit) |
返回此 OffsetDateTime 的副本，并截断时间。 |
| UnregisterFromRuntime() |
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| Until(ITemporal, ITemporalUnit) |
根据指定的单位计算另一个日期时间之前的时间量。 |
| Wait() |
使当前线程等待，直到唤醒它，通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object) |
| With(ITemporalAdjuster) |
返回此日期时间的调整副本。 |
| With(ITemporalField, Int64) |
返回此日期时间的副本，并将指定的字段设置为新值。 |
| WithDayOfMonth(Int32) |
返回此 OffsetDateTime 的副本，其中更改了一个月的日期。 |
| WithDayOfYear(Int32) |
返回此 OffsetDateTime 的副本，其中更改了一年中的日期。 |
| WithHour(Int32) |
返回此 OffsetDateTime 的副本，并更改了一小时。 |
| WithMinute(Int32) |
返回此 OffsetDateTime 的副本，更改分钟数。 |
| WithMonth(Int32) |
返回此 OffsetDateTime 的副本，其中更改了年月。 |
| WithNano(Int32) |
返回此 OffsetDateTime 的副本，其中更改了 nano-of-second。 |
| WithOffsetSameInstant(ZoneOffset) |
返回此 OffsetDateTime 的副本，该副本具有指定的偏移量，确保结果在同一时刻。 |
| WithOffsetSameLocal(ZoneOffset) |
返回此 OffsetDateTime 的副本，该副本具有指定的偏移量，确保结果具有相同的本地日期时间。 |
| WithSecond(Int32) |
返回此 OffsetDateTime 的副本，其中更改了第二分钟。 |
| WithYear(Int32) |
返回此 OffsetDateTime 的副本，更改年份。 |
显式接口实现
| 名称 | 说明 |
|---|---|
| IComparable.CompareTo(Object) |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| IJavaPeerable.Disposed() |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| IJavaPeerable.Finalized() |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| IJavaPeerable.JniObjectReferenceControlBlock |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| IJavaPeerable.UnregisterFromRuntime() |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
ISO-8601 日历系统中与 UTC/格林威治相差的日期时间，例如 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |