如何在 Java 中使用 LocalDate.atStartOfDay() 将纯日期对象转化为当天的凌晨零点时刻对象

在Java 8引入的java.time包中，LocalDate是用来表示纯日期（年月日）的类，不包含时分秒信息，而LocalDateTime则同时包含日期和时间信息。当我们需要将一个LocalDate对象转换为当天的凌晨零点时刻时，就可以使用LocalDate提供的atStartOfDay()方法。

atStartOfDay()方法的基本用法

atStartOfDay()是LocalDate类的实例方法，调用后会返回一个LocalDateTime对象，该对象的时间部分被设置为当天的00:00:00，也就是凌晨零点时刻。方法不需要传入任何参数，使用方式非常简单。

下面是一个基础的使用示例：

import java.time.LocalDate;
import java.time.LocalDateTime;

public class LocalDateDemo {
    public static void main(String[] args) {
        // 获取当前日期的LocalDate对象
        LocalDate today = LocalDate.now();
        System.out.println("当前纯日期对象：" + today);
        
        // 调用atStartOfDay方法转换为凌晨零点时刻
        LocalDateTime startOfDay = today.atStartOfDay();
        System.out.println("转换后的凌晨零点对象：" + startOfDay);
    }
}

运行上述代码，输出结果类似如下：

当前纯日期对象：2024-05-20
转换后的凌晨零点对象：2024-05-20T00:00

指定日期的转换示例

除了转换当前日期，我们也可以对指定的LocalDate对象进行转换，比如处理用户传入的特定日期字符串：

import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;

public class SpecifyDateDemo {
    public static void main(String[] args) {
        // 定义日期格式
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
        // 解析指定日期字符串为LocalDate对象
        LocalDate targetDate = LocalDate.parse("2024-10-01", formatter);
        
        // 转换为当天凌晨零点
        LocalDateTime targetStart = targetDate.atStartOfDay();
        System.out.println("指定日期的凌晨零点：" + targetStart);
    }
}

运行后输出结果为：

指定日期的凌晨零点：2024-10-01T00:00

常见使用场景

atStartOfDay()方法在很多业务场景中都非常实用，常见的使用场景包括：

• 日期范围查询：比如查询某一天的所有数据，需要将查询开始时间设置为当天凌晨零点，结束时间设置为当天结束时间
• 定时任务触发：设置任务在每天凌晨零点执行时，需要先获取当天的起始时间作为触发时间
• 数据统计：按天统计数据时，需要将统计周期的起始点设置为对应日期的凌晨零点

注意事项

使用atStartOfDay()方法时需要注意以下几点：

1. 该方法返回的是LocalDateTime对象，而不是LocalDate对象，转换后包含了时间信息，不要混淆两者的类型
2. 如果需要在转换时指定时区，可以使用atStartOfDay(ZoneId zone)重载方法，该方法会返回ZonedDateTime对象，适配不同时区的凌晨零点计算
3. 转换后的时间精度到秒，不会包含纳秒部分，默认纳秒值为0

如果需要处理带时区的日期转换，可以参考以下示例：

import java.time.LocalDate;
import java.time.ZoneId;
import java.time.ZonedDateTime;

public class ZoneDemo {
    public static void main(String[] args) {
        LocalDate date = LocalDate.now();
        // 指定上海时区的凌晨零点
        ZonedDateTime zonedStart = date.atStartOfDay(ZoneId.of("Asia/Shanghai"));
        System.out.println("上海时区的凌晨零点：" + zonedStart);
    }
}

LocalDateatStartOfDayJavaLocalDateTime修改时间：2026-07-22 23:48:30