Java LocalDate 类

2024年10月24日 | 阅读时长：5 分钟

Java LocalDate 类属于 java.time 包，并且是 Java 8 中添加的 Date and Time API（例如，JSR-310）的一部分。它以 ISO-8601 时间格式表示不带时间成分（年、月和日）的日期。 Java LocalDate 类是一个不可变类，它使用 yyyy-mm-dd 的默认格式表示日期。它继承了 Object 类并实现了 ChronoLocalDate 接口。

Java LocalDate 类声明

让我们看看 java.time.LocalDate 类的声明。

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

Java LocalDate 的方法

方法	描述
LocalDateTime atTime(int hour, int minute)	它用于将此日期与时间组合以创建一个 LocalDateTime。
int compareTo(ChronoLocalDate other)	它用于将此日期与另一个日期进行比较。
boolean equals(Object obj)	它用于检查此日期是否等于另一个日期。
String format(DateTimeFormatter formatter)	它用于使用指定的格式化程序格式化此日期。
int get(TemporalField field)	它用于从此日期获取指定字段的值作为 int。
boolean isLeapYear()	它用于检查该年份是否为闰年，根据 ISO 前格里高利历系统规则。
LocalDate minusDays(long daysToSubtract)	它用于返回此 LocalDate 的副本，并减去指定的天数。
LocalDate minusMonths(long monthsToSubtract)	它用于返回此 LocalDate 的副本，并减去指定的月数。
static LocalDate now()	它用于从默认时区的系统时钟获取当前日期。
LocalDate plusDays(long daysToAdd)	它用于返回此 LocalDate 的副本，并加上指定的天数。
LocalDate plusMonths(long monthsToAdd)	它用于返回此 LocalDate 的副本，并加上指定的月数。
LocalDate plusMonths(long monthsToAdd)	它用于返回此 LocalDate 的副本，并加上指定的月数。
int getDayOfMonth()	它获取月份中的日期字段。
DayOfWeek getDayOfWeek()	它获取星期几字段，这是一个枚举 DayOfWeek。
int getDayOfYear()	它获取一年中的日期字段。
Month getMonth()	它使用 Month 枚举获取年字段。
int getMonthValue()	它获取从 1 到 12 的年字段。
int getYear()	它获取年份字段。
int lengthOfMonth()	它返回此日期表示的月份的长度。
int lengthOfYear()	它返回此日期表示的年份的长度。
static LocalDate ofYearDay(int year, int dayOfYear)	它从年份和一年中的日期获取 LocalDate 的实例。
static LocalDate parse(CharSequence text)	它从文本字符串（例如 2007-12-03）获取 LocalDate 的实例
static LocalDate parse(CharSequence text, DateTimeFormatter formatter)	它使用特定的格式化程序从文本字符串获取 LocalDate 的实例。

创建 LocalDate 对象

使用 now() 方法获取当前日期： LocalDate 类的 now() 方法检索相对于默认时区中系统时钟的当前日期。它提供了一种快速简便的方法来检索当前日期，而无需指定任何参数或时区详细信息。

LocalDateExample.java

import java.time.LocalDate;
public class LocalDateExample{
    public static void main(String[] args) {
        // Using now() to get the current date
        LocalDate currentDate = LocalDate.now();      
        // Printing the current date
        System.out.println("Current Date: " + currentDate);
    }
}

输出

Current Date: 2024-03-22

从字符串解析： 要从 Java 中的字符串提取 LocalDate，您可以使用 parse() 方法。这是通过一种接受表示日期的字符串并将其转换为 LocalDate 对象的方法来完成的。该字符串应采用 ISO-8601 格式 (yyyy-MM-dd) 或可以使用默认 DateTimeFormatter 解析的格式。

GetLocalDate.java

import java.time.LocalDate;
public class GetLocalDate{
    public static void main(String[] args) {
        // String representing a date
        String dateString = "2024-03-22";
        // Parsing the date from the string
        LocalDate parsedDate = LocalDate.parse(dateString);
        // Printing the parsed date
        System.out.println("Parsed Date: " + parsedDate);
    }
}

输出

Parsed Date: 2024-03-22

直接提供年份、月份和日期： 您可以使用 LocalDate 类的 of() 方法，通过直接提供年份、月份和日期值来创建 LocalDate 对象。这种方法提取年份、月份和月份中的日期作为其参数，并返回一个 LocalDate 对象，表示指示的日期。

LocalDateExample.java

import java.time.LocalDate;
public class LocalDateExample {
    public static void main(String[] args) {
        // Providing year, month, and day directly
        int year = 2024;
        int month = 3;
        int dayOfMonth = 22;
        // Creating a LocalDate object
        LocalDate customDate = LocalDate.of(year, month, dayOfMonth);
        // Printing the custom date
        System.out.println("Custom Date: " + customDate);
    }
}

输出

Custom Date: 2024-03-22

Java LocalDate 示例

程序演示 LocalDate 类的方法，例如 now()、minusDays()、plusDays()。

LocalDateExample1.java

import java.time.LocalDate;  
public class LocalDateExample1 {  
  public static void main(String[] args) {  
    LocalDate date = LocalDate.now();  
    LocalDate yesterday = date.minusDays(1);  
    LocalDate tomorrow = yesterday.plusDays(2);  
    System.out.println("Today date: "+date);  
    System.out.println("Yesterday date: "+yesterday);  
    System.out.println("Tomorrow date: "+tomorrow);  
  }  
}  

输出

Today date: 2017-01-13
Yesterday date: 2017-01-12
Tomorrow date: 2017-01-14

程序演示 LocalDate 类的 isLeapYear() 方法。

LocalDateExample2.java

import java.time.LocalDate;  
public class LocalDateExample2 {  
  public static void main(String[] args) {  
    LocalDate date1 = LocalDate.of(2017, 1, 13);  
    System.out.println(date1.isLeapYear());  
    LocalDate date2 = LocalDate.of(2016, 9, 23);  
    System.out.println(date2.isLeapYear());  
  }  
}  

输出

false
true

程序演示 LocalDate 类的 atTime() 方法。

LocalDateExample3.java

import java.time.*;
public class LocalDateExample3 {
  public static void main(String[] args) {
    LocalDate date = LocalDate.of(2017, 1, 13);
    LocalDateTime datetime = date.atTime(1,50,9);    
    System.out.println(datetime); 
  }
}

输出

2017-01-13T01:50:09

程序演示 LocalDate 类的 format() 方法

LocalDateExample4.java

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
public class LocalDateExample4
{
	public static void main(String ar[])
	{
		// Converting LocalDate to String
		// Example 1
		LocalDate d1 = LocalDate.now();
		String d1Str = d1.format(DateTimeFormatter.ISO_DATE);
		System.out.println("Date1 in string :  " + d1Str);
		// Example 2
		LocalDate d2 = LocalDate.of(2002, 05, 01);
		String d2Str = d2.format(DateTimeFormatter.ISO_DATE);
		System.out.println("Date2 in string :  " + d2Str);
		// Example 3
		LocalDate d3 = LocalDate.of(2016, 11, 01);
		String d3Str = d3.format(DateTimeFormatter.ISO_DATE);
		System.out.println("Date3 in string :  " + d3Str);
	}
}

输出

Date1 in string :  2021-09-13
Date2 in string :  2002-05-01
Date3 in string :  2016-11-01

程序演示 LocalDate 类的 parse() 方法

LocalDateExample5.java

import java.time.LocalDate;
// String to LocalDate in java 8
public class LocalDateExample5 
{
	public static void main(String ar[]) 
	{
		// Example 1
		String dInStr = "2011-09-01";
		LocalDate d1 = LocalDate.parse(dInStr);
		System.out.println("String to LocalDate : " + d1);
		// Example 2
		String dInStr2 = "2015-11-20";
		LocalDate d2 = LocalDate.parse(dInStr2);
		System.out.println("String to LocalDate : " + d2);
	}
}

输出

String to LocalDate : 2011-09-01
String to LocalDate : 2015-11-20

下一个主题Java LocalTime

Java LocalDate 类