Javatime 简明教程

java.time.LocalDate Class

Introduction

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

Class declaration

以下是对 java.time.LocalDate 类的声明 −

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

Field

以下是对 java.time.LocalDate 类的字段 −
static LocalDate MAX - 支持的最大 java.time.LocalDate ，'+999999999-12-31'。
static LocalDate MIN - 支持的 java.time.LocalDate 的最小值“'-999999999-01-01'。

Class methods

Sr.No.	Method & Description
1	Temporal adjustInto(Temporal temporal) 调整指定的时间对象，使该对象具有与该对象相同的日期。
2	LocalDateTime atStartOfDay() 将该日期与午夜的时间组合，在该日期的开始处创建一个 ZonedDateTime atStartOfDay(ZoneId zone) 类。
3	ZonedDateTime atStartOfDay(ZoneId zone) 按照时区的规则，根据该日期在最早的有效时间返回带时区的时间日期。
4	LocalDateTime atTime(int hour, int minute) 将该日期与时间组合创建一个 ZonedDateTime atStartOfDay(ZoneId zone) 类。
5	LocalDateTime atTime(int hour, int minute, int second) 将该日期与时间组合创建一个 ZonedDateTime atStartOfDay(ZoneId zone) 类。
6	LocalDateTime atTime(int hour, int minute, int second, int nanoOfSecond) 将该日期与时间组合创建一个 ZonedDateTime atStartOfDay(ZoneId zone) 类。
7	LocalDateTime atTime(LocalTime time) 将该日期与时间组合创建一个 ZonedDateTime atStartOfDay(ZoneId zone) 类。
8	OffsetDateTime atTime(OffsetTime time) 将该日期与偏移时间组合创建一个 OffsetDateTime atTime(OffsetTime time) 类。
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 的副本。

Methods inherited

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

Java.lang.Object