java.time.LocalDate 类

简介

java.time.LocalDate 类表示 ISO-8601 日历系统中不包含时区的日期，例如 2007-12-03。

类声明

以下是 java.time.LocalDate 类的声明：

public final class LocalDate
   extends Object
      implements Temporal, TemporalAdjuster, ChronoLocalDate, Serializable

字段

以下是 java.time.LocalDate 类的字段：

static LocalDate MAX − 支持的最大 LocalDate，'+999999999-12-31'。
static LocalDate MIN − 支持的最小 LocalDate，'-999999999-01-01'。

类方法

序号	方法和描述
1	Temporal adjustInto(Temporal temporal) 调整指定的 temporal 对象，使其与该对象的日期相同。
2	LocalDateTime atStartOfDay() 将此日期与午夜时间组合，以创建此日期开始时的 LocalDateTime。
3	ZonedDateTime atStartOfDay(ZoneId zone) 根据时区规则，从此日期的有效最早时间返回一个带时区的日期时间。
4	LocalDateTime atTime(int hour, int minute) 将此日期与时间组合以创建 LocalDateTime。
5	LocalDateTime atTime(int hour, int minute, int second) 将此日期与时间组合以创建 LocalDateTime。
6	LocalDateTime atTime(int hour, int minute, int second, int nanoOfSecond) 将此日期与时间组合以创建 LocalDateTime。
7	LocalDateTime atTime(LocalTime time) 将此日期与时间组合以创建 LocalDateTime。
8	OffsetDateTime atTime(OffsetTime time) 将此日期与偏移时间组合以创建 OffsetDateTime。
9	int compareTo(ChronoLocalDate other) 将此日期与另一个日期进行比较。
10	boolean equals(Object obj) 检查此日期是否等于另一个日期。
11	String format(DateTimeFormatter formatter) 使用指定的格式化程序格式化此日期。
12	static LocalDate from(TemporalAccessor temporal) 从 temporal 对象获取 LocalDate 实例。
13	int get(TemporalField field) 将此日期中指定字段的值作为 int 获取。
14	IsoChronology getChronology() 获取此日期的纪元，即 ISO 日历系统。
15	int getDayOfMonth() 获取月份中的日期字段。
16	DayOfWeek getDayOfWeek() 获取星期几字段，这是一个 DayOfWeek 枚举。
17	int getDayOfYear() 获取一年中的日期字段。
18	Era getEra() 获取此日期适用的纪元。
19	long getLong(TemporalField field) 将此日期中指定字段的值作为 long 获取。
20	Month getMonth() 使用 Month 枚举获取月份字段。
21	int getMonthValue() 获取 1 到 12 的月份字段。
22	int getYear() 获取年份字段。
23	int hashCode() 此日期的哈希码。
24	boolean isAfter(ChronoLocalDate other) 检查此日期是否在指定日期之后。
25	boolean isBefore(ChronoLocalDate other) 检查此日期是否在指定日期之前。
26	boolean isEqual(ChronoLocalDate other) 检查此日期是否等于指定日期。
27	boolean isLeapYear() 根据 ISO 历法规则检查年份是否是闰年。
28	boolean isSupported(TemporalField field) 检查是否支持指定的字段。
29	boolean isSupported(TemporalUnit unit) 检查是否支持指定的单位。
30	int lengthOfMonth() 返回此日期表示的月份的长度。
31	int lengthOfYear() 返回此日期表示的年份的长度。
32	LocalDate minus(long amountToSubtract, TemporalUnit unit) 返回此日期的副本，其中减去了指定数量。
33	LocalDate minus(TemporalAmount amountToSubtract) 返回此日期的副本，其中减去了指定数量。
34	LocalDate minusDays(long daysToSubtract) 返回此 LocalDate 的副本，其中减去了指定的天数。
35	LocalDate minusMonths(long monthsToSubtract) 返回此 LocalDate 的副本，其中减去了指定的月份数。
36	LocalDate minusWeeks(long weeksToSubtract) 返回此 LocalDate 的副本，其中减去了指定的周数。
37	LocalDate minusYears(long yearsToSubtract) 返回此 LocalDate 的副本，其中减去了指定的年数。
38	static LocalDate now() 从系统时钟的默认时区获取当前日期。
39	static LocalDate now(Clock clock) 从指定的时钟获取当前日期。
40	static LocalDate now(ZoneId zone) 从指定时区的系统时钟获取当前日期。
41	static LocalDate of(int year, int month, int dayOfMonth) 从年、月和日获取 LocalDate 实例。
42	static LocalDate of(int year, Month month, int dayOfMonth) 从年、月和日获取 LocalDate 实例。
43	static LocalDate ofEpochDay(long epochDay) 从纪元日数获取 LocalDate 实例。
44	static LocalDate ofYearDay(int year, int dayOfYear) 从年份和一年中的日期获取 LocalDate 实例。
45	static LocalDate parse(CharSequence text) 从文本字符串（例如 2007-12-03）获取 LocalDate 实例。
46	static LocalDate parse(CharSequence text, DateTimeFormatter formatter) 使用特定格式化程序从文本字符串获取 LocalDate 实例。
47	LocalDate plus(long amountToAdd, TemporalUnit unit) 返回此日期的副本，其中添加了指定数量。
48	LocalDate plus(TemporalAmount amountToAdd) 返回此日期的副本，其中添加了指定数量。
49	LocalDate plusDays(long daysToAdd) 返回此 LocalDate 的副本，其中添加了指定的天数。
50	LocalDate plusMonths(long monthsToAdd) 返回此 LocalDate 的副本，其中添加了指定的月份数。
51	LocalDate plusWeeks(long weeksToAdd) 返回此 LocalDate 的副本，其中添加了指定的周数。
52	LocalDate plusYears(long yearsToAdd) 返回此 LocalDate 的副本，其中添加了指定的年数。
53	<R> R query(TemporalQuery<R> query) 使用指定的查询查询此日期。
54	ValueRange range(TemporalField field) 获取指定字段的有效值范围。
55	long toEpochDay() 将此日期转换为纪元日。
56	String toString() 将此日期输出为字符串，例如 2007-12-03。
57	Period until(ChronoLocalDate endDateExclusive) 计算此日期与另一个日期之间的期间作为 Period。
58	long until(Temporal endExclusive, TemporalUnit unit) 计算以指定单位表示的到另一个日期的时间量。
59	LocalDate with(TemporalAdjuster adjuster) 返回此日期的调整后的副本。
60	LocalDate with(TemporalField field, long newValue) 返回此日期的副本，其中指定字段设置为新值。
61	LocalDate withDayOfMonth(int dayOfMonth) 返回此 LocalDate 的副本，其中更改了月份中的日期。
62	LocalDate withDayOfYear(int dayOfYear) 返回此 LocalDate 的副本，其中更改了一年中的日期。
63	LocalDate withMonth(int month) 返回此 LocalDate 的副本，其中更改了一年中的月份。
64	LocalDate withYear(int year) 返回此 LocalDate 的副本，其中更改了年份。

继承的方法

此类继承自以下类的方法：

java.lang.Object

打印页面