Java LocalDate的详细方法总结

1、LocalDate now()

从默认时区的系统时钟获取当前日期。

LocalDate a = LocalDate.now();System.out.println(a); // 2023-06-06

2、LocalDate now(ZoneId zone)

从默认时区的系统时钟获取当前日期

LocalDate a = LocalDate.now(ZoneId.systemDefault());//系统默认System.out.println(a); // 2023-06-06

3、LocalDate now(Clock clock)

从指定的时钟获取当前日期

LocalDate a = LocalDate.now(Clock.systemDefaultZone());//系统默认System.out.println(a); // 2023-06-06

4、LocalDate of(int year, int month, int dayOfMonth)

从年、月和日获取实例 LocalDate

year – 代表年份，从MIN_YEAR年到MAX_YEAR年

month – 代表的月份，从1月1日（1月）到12日（12月）

dayOfMonth – 表示从 1 到 31 的月份中的某天

 LocalDate localDate = LocalDate.of(2023,6,5); System.out.println(localDate);//2023-06-05

5、LocalDate ofYearDay(int year, int dayOfYear)

从一年和一年中的某天获取实例 LocalDate
year – 代表年份，从MIN_YEAR年到MAX_YEAR年

dayOfYear – 代表一年中的一天，从 1 到 366

注意：如果任何字段的值超出范围，或者如果一年中的某一天对年份无效

LocalDate localDate = LocalDate.ofYearDay(2023 ,32);System.out.println(localDate);//2023-02-01

6、LocalDate parse(CharSequence text)

从文本字符串（如 2007-12-03）中获取 的LocalDate实例

LocalDate a = LocalDate.parse("2023-06-06");System.out.println(a); // 2023-06-06

7、boolean isSupported(TemporalUnit unit)

检查是否支持指定的单位。
这将检查是否可以在此日期中添加或减去指定的单位

LocalDate a = LocalDate.of(2023,6,6);boolean supported = a.isSupported(ChronoUnit.DAYS);System.out.println(supported); // true

8、int getYear()

获取年份字段

LocalDate a = LocalDate.of(2023,6,6);int year = a.getYear();System.out.println(year); // 2023

9、int getMonthValue()

获取从 1 到 12 的月份字段

LocalDate a = LocalDate.of(2023,6,6);int month = a.getMonthValue();System.out.println(month); // 6

10、int getDayOfMonth()

获取月份中的某天字段

LocalDate a = LocalDate.of(2023,6,6);int day = a.getDayOfMonth();System.out.println(day); // 6

11、int getDayOfYear()

获取一年中的某天字段，

返回：一年中的某一天，从 1 到 365，或闰年为 366，也就是当年当月当日的天数

LocalDate now = LocalDate.of(2023,6,5);int localDate = now.getDayOfYear();System.out.println(localDate); // 156

12、DayOfWeek getDayOfWeek()

获取星期字段，这是一个枚举 DayOfWeek

LocalDate a = LocalDate.of(2023,6,6);DayOfWeek week = a.getDayOfWeek();System.out.println(week); // TUESDAY

13、boolean isLeapYear()

检查年份是否为闰年

LocalDate now = LocalDate.of(1904,6,5);Boolean localDate = now.isLeapYear();System.out.println(localDate); // true 

14、int lengthOfMonth()

返回月份有多少天

LocalDate now = LocalDate.of(2023,6,5);int localDate = now.lengthOfMonth();System.out.println(localDate); // 30 

15、int lengthOfYear()

返回年份有多少天

LocalDate now = LocalDate.of(2023,6,5);int localDate = now.lengthOfYear();System.out.println(localDate); // 365

16、LocalDate with(TemporalAdjuster adjuster)

返回此日期的调整副本

例如，此代码返回 7 月最后一天的日期

LocalDate now = LocalDate.of(2023,7,5);LocalDate localDate = now.with(lastDayOfMonth());System.out.println(localDate); // 2023-07-31

17、LocalDate withYear(int year)

返回更改 LocalDate 年份的副本。
如果月份中的某天对年份无效，它将更改为该月的最后一个有效日期。

LocalDate now = LocalDate.of(2023,2,28);LocalDate localDate = now.withYear(2024);System.out.println(localDate); // 2024-02-28

18、LocalDate withMonth(int month)

返回更改 LocalDate 月份的副本。

如果月份中的某天对年份无效，它将更改为该月的最后一个有效日期。

参数：
month – 结果中设置的月份，从 1 日（1 月）到 12 日（12 月）

LocalDate now = LocalDate.of(2023,2,28);LocalDate localDate = now.withMonth(5);System.out.println(localDate); // 2023-05-28

19、LocalDate withDayOfMonth(int dayOfMonth)

返回更改 LocalDate 月份中的某天的副本。
如果生成的日期无效，则会引发异常

参数：
dayOfMonth – 结果中设置的月份日期，从 1 到 28-31

LocalDate now = LocalDate.of(2023,2,28);LocalDate localDate = now.withDayOfMonth(5);System.out.println(localDate); // 2023-02-05

20、LocalDate withDayOfYear(int dayOfYear)

返回更改 LocalDate 了一年中的某一天的副本。
如果生成的日期无效，则会引发异常

参数：
dayOfYear – 结果中设置的日期，从 1 到 365-366

LocalDate now = LocalDate.of(2023,2,28);LocalDate localDate = now.withDayOfYear(20);System.out.println(localDate); // 2023-01-20

21、LocalDate plusYears(long yearsToAdd)

返回添加 LocalDate 指定年数

参数：
yearsToAdd – 要添加的年份，可能是负数（如果是正数则增加年份，是负数则减年份）

LocalDate now = LocalDate.of(2023,2,28);LocalDate localDate = now.plusYears(2);System.out.println(localDate); // 2025-02-28

22、LocalDate plusMonths(long monthsToAdd)

返回添加 LocalDate 指定月数

参数：
monthsToAdd – 要添加的月份，可能是负数（如果是正数则增加月数，是负数则减月数）

LocalDate now = LocalDate.of(2023,2,28);LocalDate localDate = now.plusMonths(-2);System.out.println(localDate); // 2022-12-28

23、LocalDate plusWeeks(long weeksToAdd)

返回添加了 LocalDate 指定周数，可能是负数（如果是正数则增加周数，是负数则减周数）

LocalDate now = LocalDate.of(2023,2,28);LocalDate localDate = now.plusWeeks(1);System.out.println(localDate); // 2023-03-07

24、LocalDate plusDays(long daysToAdd)

返回添加 LocalDate 指定天数

参数：
daysToAdd – 添加的天数，可能是负数（如果是正数则增加天数，是负数则减天数）

LocalDate now = LocalDate.of(2023,2,28);LocalDate localDate = now.plusDays(10);System.out.println(localDate); // 2023-03-10

25、LocalDate minusYears(long yearsToSubtract)

返回此 LocalDate 副本，并减去指定的年数

参数：
yearsToSubtract –减去的年份，可能是负数（如果是正数则减去年份，负数则增加年份）

LocalDate now = LocalDate.of(2023,2,28);LocalDate localDate = now.minusYears(2);System.out.println(localDate); // 2021-02-28

26、LocalDate minusMonths(long monthsToSubtract)

返回此 LocalDate 副本，并减去指定的月数

参数：
monthsToSubtract–减去的月份，可能是负数（如果是正数则减去月份，负数则增加月份）

LocalDate now = LocalDate.of(2023,2,28);LocalDate localDate = now.minusMonths(2);System.out.println(localDate); // 2022-12-28

27、LocalDate minusWeeks(long weeksToSubtract)

返回此 LocalDate 副本，并减去指定的周数

参数：
weeksToSubtract–减去的周数，可能是负数（如果是正数则减去周数，负数则增加周数）

LocalDate now = LocalDate.of(2023,2,28);LocalDate localDate = now.minusWeeks(1);System.out.println(localDate); // 2023-02-21

28、LocalDate minusDays(long daysToSubtract)

返回此 LocalDate 副本，并减去指定的天数

参数：
daysToSubtract–减去的天数，可能是负数（如果是正数则减去天数，负数则增加天数）

LocalDate now = LocalDate.of(2023,2,28);LocalDate localDate = now.minusDays(-2);System.out.println(localDate); // 2023-03-02

29、long until(Temporal endExclusive, TemporalUnit unit)

根据指定单位计算到另一个日期的时间量

例如，2023-2-28和 2024-2-28之间的月份

除了月份：支持YEARS、DAYS、WEEKS、DECADES、CENTURIES、MILLENNIA、ERAS

import java.time.LocalDate;import java.time.temporal.ChronoUnit;public class lll {public static void main(String[] args) {//开始日期到结束日期相差的月份LocalDate star = LocalDate.of(2023,2,28);LocalDate end = LocalDate.of(2024,2,28);// 方式一Long localDate = star.until(end, ChronoUnit.MONTHS);// 方式二long between = ChronoUnit.MONTHS.between(star, end);System.out.println(localDate); // 12System.out.println(between); // 12}}

30、String format(DateTimeFormatter formatter)

使用指定的格式化程序设置此日期的格式。
此日期将传递给格式化程序以生成字符串

LocalDate now = LocalDate.of(2023,2,28);String localDate = now.format(DateTimeFormatter.ofPattern("yyyy-MM-dd"));System.out.println(localDate); // 2023-02-28

31、LocalDateTime atTime(LocalTime time)

将此日期与时间组合以创建 LocalDateTime.
这将返回 LocalDateTime 从此日期在指定时间形成的。日期和时间的所有可能组合均有效

LocalDate now = LocalDate.of(2023,2,28);LocalDateTime localDate = now.atTime(LocalTime.of(12,5,6));System.out.println(localDate); // 2023-02-28T12:05:06

32、LocalDateTime atTime(int hour, int minute, int second)

将此日期与时间组合以创建 LocalDateTime.
这将返回 LocalDateTime 从此日期开始在指定的小时、分钟和秒处形成的。纳秒字段将设置为零。各个时间字段必须在其有效范围内。日期和时间的所有可能组合均有效。

参数：
hour – 要使用的小时，从 0 到 23 minute – 使用的小时分钟数，从 0 到 59 second – 表示的分钟秒，从 0 到 59

LocalDate now = LocalDate.of(2023,2,28);LocalDateTime localDate = now.atTime(12,5,6);System.out.println(localDate); // 2023-02-28T12:05:06

33、int compareTo(ChronoLocalDate other)

将此日期与另一个日期进行比较。

返回：
比较器值，如果较小则为负值，如果较大则为正值

LocalDate now = LocalDate.of(2023,1,28);LocalDate now1 = LocalDate.of(2023,2,28);int localDate = now.compareTo(now1);System.out.println(localDate); // -1

34、boolean isAfter(ChronoLocalDate other)

检查此日期是否晚于指定日期

返回：
如果此日期晚于指定日期，则为 true

LocalDate a = LocalDate.of(2023, 6, 30);LocalDate b = LocalDate.of(2023, 7, 1);boolean after = a.isAfter(b); boolean after1 = a.isAfter(a);boolean after2 = b.isAfter(a);System.out.println(after); // falseSystem.out.println(after1); // falseSystem.out.println(after2); // true

35、boolean isBefore(ChronoLocalDate other)

检查此日期是否早于指定日期

返回：
如果此日期早于指定日期，则为 true

LocalDate a = LocalDate.of(2023, 6, 30);LocalDate b = LocalDate.of(2023, 7, 1);boolean before = a.isBefore(b);boolean before1 = a.isBefore(a);boolean before2 = b.isBefore(a);System.out.println(before); // trueSystem.out.println(before1); // falseSystem.out.println(before2); // false

36、boolean isEqual(ChronoLocalDate other)

检查此日期是否等于指定日期

返回：
如果此日期等于指定日期，则为 true

LocalDate a = LocalDate.of(2023, 6, 30);LocalDate b = LocalDate.of(2023, 7, 1);boolean equal = a.isEqual(b);boolean equal1 = a.isEqual(a);boolean equal12 = b.isEqual(a);System.out.println(equal); // falseSystem.out.println(equal1); // trueSystem.out.println(equal12); // false

37、boolean equals(Object obj)

检查此日期是否等于另一个日期。
将此与 LocalDate 另一个进行比较，确保日期相同

返回：
如果此日期等于其他日期，则为 true，仅比较类型的 LocalDate 对象，其他类型返回 false

LocalDate a = LocalDate.of(2023, 6, 30);LocalDate b = LocalDate.of(2023, 7, 1);boolean equal = a.equals(b);boolean equal1 = a.equals(a);boolean equal12 = b.equals(a);System.out.println(equal); // falseSystem.out.println(equal1); // trueSystem.out.println(equal12); // false

38、String toString()

将此日期输出为 String，例如 2007-12-03。
输出将采用 ISO-8601 格式 uuuu-MM-dd

LocalDate a = LocalDate.of(2023, 6, 30);String equal = a.toString();System.out.println(equal); // 2023-06-30

39、int hashCode()

此日期的哈希代码。
返回：
合适的哈希码

LocalDate a = LocalDate.of(2023, 6, 30);int equal = a.hashCode();System.out.println(equal); // 4143518