Javatime 简明教程

java.time.OffsetDateTime Class

Introduction

java.time.OffsetDateTime 类表示 ISO-8601 日历系统中从 UTC/格林尼治时间偏移的时间，例如 2007-12-03T10:15:30+01:00。

Class declaration

以下是 java.time.OffsetDateTime 类的声明 −

public final class OffsetDateTime
   extends Object
      implements Temporal, TemporalAdjuster, Comparable<OffsetDateTime>, Serializable

Field

以下为 java.time.OffsetDateTime 类的字段 −

static OffsetDateTime MAX − 最大支持的 OffsetDateTime，'+999999999-12-31T23:59:59.999999999+18:00'。
static OffsetDateTime MIN − 最小支持的 OffsetDateTime，'-999999999-01-01T00:00:00-18:00'。

Class methods

Sr.No.	Method & Description
1	Temporal adjustInto(Temporal temporal) 调整指定的时间对象与该对象具有相同的日期和时间。
2	ZonedDateTime atZoneSameInstant(ZoneId zone) 将此日期时间与时区合并，以创建一个ZonedDateTime，确保结果具有相同的时刻。
3	ZonedDateTime atZoneSimilarLocal(ZoneId zone) 将此日期时间与时区合并，以创建一个 ZonedDateTime，尝试保留相同的本地日期和时间。
4	int compareTo(OffsetDateTime other) 将此日期时间与另一个日期时间进行比较。
5	boolean equals(Object obj) 检查此日期时间是否等于另一个日期时间。
6	String format(DateTimeFormatter formatter) 使用指定格式化程序格式化此日期时间。
7	static OffsetDateTime from(TemporalAccessor temporal) 从时间对象获取 OffsetDateTime 的实例。
8	int get(TemporalField field) 以 int 的形式从此日期时间获取指定字段的值。
9	int getDayOfMonth() 获取当月的字段。
10	DayOfWeek getDayOfWeek() 获取 DayOfWeek 枚举类型，即每周中的哪一天。
11	int getDayOfYear() 获取年份中的哪一天字段。
12	int getHour() 获取一天中的哪一个小时字段。
13	long getLong(TemporalField field) 以 long 的形式从此日期时间获取指定字段的值。
14	Month getMinute() 获取一小时的分钟字段。
15	Month getMonth() 使用 Month 枚举获取一年中的哪个月字段。
16	int getMonthValue() 获取 1 到 12 月份中的一年中的哪个月字段。
17	int getNano() 获取纳秒字段。
18	ZoneOffset getOffset() 获取时区偏移，比如 '+01:00'。
19	int getSecond() 获取分字段的秒。
20	int getYear() 获取年份字段。
21	int hashCode() 此日期时间戳的哈希码。
22	boolean isAfter(OffsetDateTime other) 检查此日期时间戳是否晚于指定的日期时间戳。
23	boolean isBefore(OffsetDateTime other) 检查此日期时间戳是否早于指定的日期时间戳。
24	boolean isEqual(OffsetDateTime other) 检查此日期时间戳是否与指定的日期时间戳相等。
25	boolean isSupported(TemporalField field) 检查是否支持指定的字段。
26	boolean isSupported(TemporalUnit unit) 检查是否支持指定的单位。
27	OffsetDateTime minus(long amountToSubtract, TemporalUnit unit) 返回此日期时间戳的副本，其中减去了指定数量。
28	OffsetDateTime minus(TemporalAmount amountToSubtract) 返回此日期时间戳的副本，其中减去了指定数量。
29	OffsetDateTime minusDays(long daysToSubtract) 返回此 OffsetDateTime 的副本，其中减去了指定的天数。
30	OffsetDateTime minusHours(long hoursToSubtract) 返回此 OffsetDateTime 的副本，其中减去了指定的小时数。
31	OffsetDateTime minusMinutes(long minutesToSubtract) 返回此 OffsetDateTime 的副本，其中减去了指定的分钟数。
32	OffsetDateTime minusMonths(long monthsToSubtract) 返回此 OffsetDateTime 的副本，其中减去了指定的月数。
33	OffsetDateTime minusNanos(long nanos) 返回此 OffsetDateTime 的副本，其中减去了指定的纳秒数。
34	OffsetDateTime minusSeconds(long seconds) 返回此 OffsetDateTime 的副本，其中减去了指定的秒数。
35	OffsetDateTime minusWeeks(long weeksToSubtract) 返回此 OffsetDateTime 的副本，其中减去了指定的周数。
36	OffsetDateTime minusYears(long yearsToSubtract) 返回增加指定年数后的此 OffsetDateTime 副本。
37	static OffsetDateTime now() 根据默认时区的系统时钟获取当前日期和时间。
38	static OffsetDateTime now(Clock clock) 根据指定时钟获取当前日期和时间。
39	static OffsetDateTime now(ZoneId zone) 根据指定时区的系统时钟获取当前日期和时间。
40	static OffsetDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond, ZoneOffset offset) 根据年、月、日、小时、分钟、秒、纳秒和偏移量获取 OffsetDateTime 的实例。
41	static OffsetDateTime of(LocalDate date, LocalTime time, ZoneOffset offset) 根据日期、时间和偏移量获取 OffsetDateTime 的实例。
42	static OffsetDateTime of(LocalDateTime dateTime, ZoneOffset offset) 根据日期和时间以及偏移量获取 OffsetDateTime 的实例。
43	static OffsetDateTime ofInstant(Instant instant, ZoneId zone) 根据 Instant 和时区 ID 获取 OffsetDateTime 的实例。
44	static OffsetDateTime parse(CharSequence text) 根据文本字符串（例如 2007-12-03T10:15:30）获取 OffsetDateTime 的实例。
45	static OffsetDateTime parse(CharSequence text, DateTimeFormatter formatter) 使用特定格式化程序根据文本字符串获取 OffsetDateTime 的实例。
46	OffsetDateTime plus(long amountToAdd, TemporalUnit unit) 返回增加指定数量后的此日期和时间副本。
47	OffsetDateTime plus(TemporalAmount amountToAdd) 返回增加指定数量后的此日期和时间副本。
48	OffsetDateTime plusDays(long daysToAdd) 返回增加指定天数后的此 OffsetDateTime 副本。
49	OffsetDateTime plusHours(long hoursToAdd) 返回增加指定小时数后的此 OffsetDateTime 副本。
50	OffsetDateTime plusMinutes(long minutesToAdd) 返回增加指定分钟数后的此 OffsetDateTime 副本。
51	OffsetDateTime plusMonths(long monthsToAdd) 返回增加指定月数后的此 OffsetDateTime 副本。
52	OffsetDateTime plusNanos(long nanos) 返回增加指定纳秒数后的此 OffsetDateTime 副本。
53	OffsetDateTime plusSeconds(long seconds) 返回增加指定秒数后的此 OffsetDateTime 副本。
54	OffsetDateTime plusWeeks(long weeksToAdd) 返回增加指定周数后的此 OffsetDateTime 副本。
55	OffsetDateTime plusYears(long yearsToAdd) 返回添加了指定数量年的本 OffsetDateTime 的副本。
56	<R> R query(TemporalQuery<R> query) 使用指定的查询对日期时间进行查询。
57	ValueRange range(TemporalField field) 获取指定字段的有效值范围。
58	static Comparator<OffsetDateTime> timeLineOrder() 获取一个基于时间对两个 OffsetDateTime 实例进行比较的比较器。
59	long toEpochSecond() 将此日期时间转换为自 1970-01-01T00:00:00Z 起的秒数。
60	Instant toInstant() 将此日期时间转换为一个 Instant。
61	LocalDate toLocalDate() 获取日期时间的 LocalDate 部分。
62	LocalDateTime toLocalDateTime() 获取日期时间的 LocalDateTime 部分。
63	LocalTime toLocalTime() 获取日期时间的 LocalTime 部分。
64	OffsetTime toOffsetTime() 获取日期时间的 OffsetTime 部分。
65	String toString() 将日期输出为字符串，例如 2007-12-03T10:15:30。
66	ZonedDateTime toZonedDateTime() 使用偏移作为时区 ID，将此日期时间转换为一个 ZonedDateTime。
67	OffsetDateTime truncatedTo(TemporalUnit unit) 返回一个时间已截断的 OffsetDateTime 副本。
68	long until(Temporal endExclusive, TemporalUnit unit) 计算以指定单位为单位，直到另一个日期时间为止所需的时间量。
69	OffsetDateTime with(TemporalAdjuster adjuster) 返回一个调整后的本日期时间副本。
70	OffsetDateTime with(TemporalField field, long newValue) 返回一个本日期时间的副本，其中指定的字段已设定为新的值。
71	OffsetDateTime withDayOfMonth(int dayOfMonth) 返回一个已更改月份日期的 OffsetDateTime 副本。
72	OffsetDateTime withDayOfYear(int dayOfYear) 返回一个已更改年份日期的 OffsetDateTime 副本。
73	OffsetDateTime withHour(int hour) 返回一个已更改日小时的 OffsetDateTime 副本。
74	OffsetDateTime withMinute(int minute) 返回更改了小时分钟的该 OffsetDateTime 的副本。
75	OffsetDateTime withMonth(int month) 返回更改了年月该 OffsetDateTime 的副本。
76	OffsetDateTime withNano(int nanoOfSecond) 返回更改了纳秒的该 OffsetDateTime 的副本。
77	OffsetDateTime withOffsetSameInstant(ZoneOffset offset) 返回该 OffsetDateTime 的副本，该副本使用指定偏移量，确保结果处于同一时刻。
78	OffsetDateTime withOffsetSameLocal(ZoneOffset offset) 返回该 OffsetDateTime 的副本，该副本使用指定偏移量，确保结果具有相同的本地日期和时间。
79	OffsetDateTime withSecond(int second) 返回更改了分钟秒的该 OffsetDateTime 的副本。
80	OffsetDateTime withYear(int year) 返回更改了年的该 OffsetDateTime 的副本。

Methods inherited

此类从以下类中继承方法：

Java.lang.Object