java.time API_ 字节宝

简介

Java 8 推出了全新的日期时间API，在教程中我们将通过一些简单的实例来学习如何使用新API。新API基于ISO标准日历系统，java.time包下的所有类都是不可变类型而且线程安全。

类的名称	描述
Instant	时间戳
Duration	计算两个时间差
LocalDate	只包含日期，比如：2018-02-05
LocalTime	只包含时间，比如：23:12:10
LocalDateTime	包含日期和时间，比如：2018-02-05 23:14:21
Period	计算两个日期差
ZoneOffset	时区偏移量，比如： 8:00
ZonedDateTime	时区
Clock	时钟，比如获取目前美国纽约的时间
java.time.format.DateTimeFormatter	时间格式化

Instant

描述：计算时间戳

代码语言：javascript复制

@Test
public void test() {

    Instant instant = Instant.now();
    System.out.println(instant);

    // 从1970年1月1日 00:00:00到现在的纳秒
    System.out.println(instant.getNano());
}

Duration

描述：计算时间差

代码语言：javascript复制

@Test
public void test() {

    LocalTime now = LocalTime.now();
    LocalTime time = LocalTime.of(22, 20, 40);

    // 计算两个时间差
    Duration duration = Duration.between(now, time);
    System.out.println(duration.toDays());
    System.out.println(duration.toHours());
}

LocalDate

LocalTime

LocalDateTime

代码语言：javascript复制

@Test
public void test() {

    LocalDateTime date = LocalDateTime.now();
    System.out.println(date); // 2021-09-07T17:44:53.262
}

/**
 * 计算两个时间差
 */
@Test
public void test2() {

    LocalDateTime startTime = LocalDateTime.of(2021, 9, 7, 17, 32, 14);
    LocalDateTime endTime = LocalDateTime.of(2021, 9, 7, 18, 23, 53);

    Duration duration = Duration.between(startTime, endTime);
    long durationTime = duration.toMillis()/1000;
    System.out.println(durationTime);

    System.out.println(duration.toMinutes());
}

/**
 * 计算三个月前当前时间
 */
@Test
public void test3() {

    LocalDateTime date = LocalDateTime.now();
    System.out.println(date);

    DateTimeFormatter format = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
    String time = date.minusMonths(3).format(format); // 格式换输出

    System.out.println(time);
}

输出：
2021-09-27T11:46:13.669
2021-06-27T11:46:13.669 格式化 2021-06-27 11:49:58

Period

描述：计算日期差

代码语言：javascript复制

@Test
public void test() {

    LocalDate now = LocalDate.now();
    LocalDate date = LocalDate.of(2001, 9, 22);

    // 计算日期差
    Period period = Period.between(date, now);
    System.out.println(period.getYears());
    System.out.println(period.getDays());
}

ZoneOffset

ZonedDateTime

描述：进行时区操作

代码语言：javascript复制

@Test
public void test() {

    // 获取所有时区ID
    ZoneId.getAvailableZoneIds().forEach(System.out::println);

    // 获取当前时间
    LocalDateTime now = LocalDateTime.now();
    System.out.println(now);

    // 获取标准时间
    ZonedDateTime dateTime = ZonedDateTime.now(Clock.systemUTC());
    System.out.println(dateTime);

    // 使用计算机默认的时区，创建时间
    ZonedDateTime dateTime1 = ZonedDateTime.now();
    System.out.println(dateTime1);

    // 使用指定时区创建时间
    ZonedDateTime dateTime2 = ZonedDateTime.now(ZoneId.of("US/Pacific"));
    System.out.println(dateTime2);
}

Clock

DateTimeFormatter

代码语言：javascript复制

@Test
public void test() {

    LocalDateTime date = LocalDateTime.now();
    DateTimeFormatter format = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

    String str = date.format(format);
    System.out.println(str);
}

示例分享

示例1：Java 8中获取今天的日期

Java 8 中的 LocalDate 用于表示当天日期。和java.util.Date不同，它只有日期，不包含时间。当你仅需要表示日期时就用这个类。

代码语言：javascript复制

import java.time.LocalDate;

public class Demo01 {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        System.out.println("今天的日期:" today);
    }
}

示例2：Java 8中获取年、月、日信息

代码语言：javascript复制

import java.time.LocalDate;

public class Demo02 {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        int year = today.getYear();
        int month = today.getMonthValue();
        int day = today.getDayOfMonth();

        System.out.println("year:" year);
        System.out.println("month:" month);
        System.out.println("day:" day);
    }
}

示例3：Java 8中处理特定日期

我们通过静态工厂方法now()非常容易地创建了当天日期，你还可以调用另一个有用的工厂方法LocalDate.of()创建任意日期，该方法需要传入年、月、日做参数，返回对应的LocalDate实例。

这个方法的好处是没再犯老API的设计错误，比如年度起始于1900，月份是从0开始等等。提醒：YYYY-MM-DD 的黑锅，这个可以看下。

代码语言：javascript复制

import java.time.LocalDate;

public class Demo03 {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2018,2,6);
        System.out.println("自定义日期:" date);
    }
}

示例4：Java 8中判断两个日期是否相等

代码语言：javascript复制

import java.time.LocalDate;

public class Demo04 {
    public static void main(String[] args) {
        LocalDate date1 = LocalDate.now();

        LocalDate date2 = LocalDate.of(2018,2,5);

        if(date1.equals(date2)){
            System.out.println("时间相等");
        }else{
            System.out.println("时间不等");
        }
    }
}

示例5：检查像生日这种周期性事件

代码语言：javascript复制

import java.time.LocalDate;
import java.time.MonthDay;

public class Demo05 {
    public static void main(String[] args) {
        LocalDate date1 = LocalDate.now();

        LocalDate date2 = LocalDate.of(2018,2,6);
        MonthDay birthday = MonthDay.of(date2.getMonth(),date2.getDayOfMonth());
        MonthDay currentMonthDay = MonthDay.from(date1);

        if(currentMonthDay.equals(birthday)){
            System.out.println("是你的生日");
        }else{
            System.out.println("你的生日还没有到");
        }
    }
}

只要当天的日期和生日匹配，无论是哪一年都会打印出祝贺信息。你可以把程序整合进系统时钟，看看生日时是否会受到提醒，或者写一个单元测试来检测代码是否运行正确。

示例6：Java 8中获取当前时间

代码语言：javascript复制

import java.time.LocalTime;

public class Demo06 {
    public static void main(String[] args) {
        LocalTime time = LocalTime.now();
        System.out.println("获取当前的时间,不含有日期:" time);
    }
}

可以看到当前时间就只包含时间信息，没有日期

示例7：Java 8中获取当前时间

通过增加小时、分、秒来计算将来的时间很常见。Java 8除了不变类型和线程安全的好处之外，还提供了更好的plusHours()方法替换add()，并且是兼容的。

注意，这些方法返回一个全新的LocalTime实例，由于其不可变性，返回后一定要用变量赋值。

代码语言：javascript复制

import java.time.LocalTime;

public class Demo07 {
    public static void main(String[] args) {
        LocalTime time = LocalTime.now();
        LocalTime newTime = time.plusHours(3);
        System.out.println("三个小时后的时间为:" newTime);
    }
}

示例8：Java 8如何计算一周后的日期

和上个例子计算3小时以后的时间类似，这个例子会计算一周后的日期。LocalDate日期不包含时间信息，它的plus()方法用来增加天、周、月，ChronoUnit类声明了这些时间单位。由于LocalDate也是不变类型，返回后一定要用变量赋值。

代码语言：javascript复制

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class Demo08 {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        System.out.println("今天的日期为:" today);
        LocalDate nextWeek = today.plus(1, ChronoUnit.WEEKS);
        System.out.println("一周后的日期为:" nextWeek);
    }
}

可以看到新日期离当天日期是7天，也就是一周。你可以用同样的方法增加1个月、1年、1小时、1分钟甚至一个世纪，更多选项可以查看Java 8 API中的ChronoUnit类。

示例9：计算一年前或一年后的日期

描述：利用minus()方法计算一年前的日期。

代码语言：javascript复制

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class Demo09 {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();

        LocalDate previousYear = today.minus(1, ChronoUnit.YEARS);
        System.out.println("一年前的日期 : "   previousYear);

        LocalDate nextYear = today.plus(1, ChronoUnit.YEARS);
        System.out.println("一年后的日期:" nextYear);
    }
}

示例10：Java 8的Clock时钟类

Java 8增加了一个Clock时钟类用于获取当时的时间戳，或当前时区下的日期时间信息。以前用到System.currentTimeInMillis()和TimeZone.getDefault()的地方都可用Clock替换。

代码语言：javascript复制

import java.time.Clock;

public class Demo10 {
    public static void main(String[] args) {
        
        Clock clock = Clock.systemUTC();
        System.out.println("Clock : "   clock.millis());

        Clock defaultClock = Clock.systemDefaultZone();
        System.out.println("Clock : "   defaultClock.millis());
    }
}

示例11：判断日期是早于或晚于另一个日期

另一个工作中常见的操作就是如何判断给定的一个日期是大于某天还是小于某天？在Java 8中，LocalDate类有两类方法isBefore()和isAfter()用于比较日期。调用isBefore()方法时，如果给定日期小于当前日期则返回true。

代码语言：javascript复制

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;


public class Demo11 {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();

        LocalDate tomorrow = LocalDate.of(2018,2,6);
        if(tomorrow.isAfter(today)){
            System.out.println("之后的日期:" tomorrow);
        }

        LocalDate yesterday = today.minus(1, ChronoUnit.DAYS);
        if(yesterday.isBefore(today)){
            System.out.println("之前的日期:" yesterday);
        }
    }
}

示例12：Java 8中处理时区

Java 8不仅分离了日期和时间，也把时区分离出来了。现在有一系列单独的类如ZoneId来处理特定时区，ZoneDateTime类来表示某时区下的时间。

这在Java 8以前都是 GregorianCalendar类来做的。下面这个例子展示了如何把本时区的时间转换成另一个时区的时间。

代码语言：javascript复制

import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.ZonedDateTime;

public class Demo12 {
    public static void main(String[] args) {
        
        ZoneId america = ZoneId.of("America/New_York");
        LocalDateTime localtDateAndTime = LocalDateTime.now();
        ZonedDateTime dateAndTimeInNewYork = ZonedDateTime.of(localtDateAndTime, america );
        System.out.println("Current date and time in a particular timezone : "   dateAndTimeInNewYork);
    }
}

示例13：如何表示信用卡到期这类固定日期

与 MonthDay检查重复事件的例子相似，YearMonth是另一个组合类，用于表示信用卡到期日、FD到期日、期货期权到期日等。

还可以用这个类得到当月共有多少天，YearMonth实例的lengthOfMonth()方法可以返回当月的天数，在判断2月有28天还是29天时非常有用。

代码语言：javascript复制

import java.time.*;

public class Demo13 {
    public static void main(String[] args) {
        YearMonth currentYearMonth = YearMonth.now();
        System.out.printf("Days in month year %s: %d%n", currentYearMonth, currentYearMonth.lengthOfMonth());
        YearMonth creditCardExpiry = YearMonth.of(2019, Month.FEBRUARY);
        System.out.printf("Your credit card expires on %s %n", creditCardExpiry);
    }
}

示例14：如何在Java 8中检查闰年

代码语言：javascript复制

import java.time.LocalDate;

public class Demo14 {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        if(today.isLeapYear()){
            System.out.println("This year is Leap year");
        }else {
            System.out.println("2018 is not a Leap year");
        }
    }
}

示例15：计算两个日期之间的天数和月数

有一个常见日期操作是计算两个日期之间的天数、周数或月数。在Java 8中可以用java.time.Period类来做计算。下面这个例子中，我们计算了当天和将来某一天之间的月数。

代码语言：javascript复制

import java.time.LocalDate;
import java.time.Period;

public class Demo15 {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();

        LocalDate java8Release = LocalDate.of(2018, 12, 14);

        Period periodToNextJavaRelease = Period.between(today, java8Release);
        System.out.println("Months left between today and Java 8 release : "
                  periodToNextJavaRelease.getMonths() );


    }
}

示例16：在Java 8中获取当前的时间戳

Instant类有一个静态工厂方法now()会返回当前的时间戳，如下所示：

代码语言：javascript复制

import java.time.Instant;

public class Demo16 {
    public static void main(String[] args) {
        Instant timestamp = Instant.now();
        System.out.println("What is value of this instant "   timestamp.toEpochMilli());
    }
}

时间戳信息里同时包含了日期和时间，这和java.util.Date很像。实际上Instant类确实等同于 Java 8之前的Date类，你可以使用Date类和Instant类各自的转换方法互相转换，例如：Date.from(Instant) 将Instant转换成java.util.Date，Date.toInstant()则是将Date类转换成Instant类。

示例17：预定义格式化工具解析或格式化日期

代码语言：javascript复制

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

public class Demo17 {
    public static void main(String[] args) {
        String dayAfterTommorrow = "20180205";
        LocalDate formatted = LocalDate.parse(dayAfterTommorrow,
                DateTimeFormatter.BASIC_ISO_DATE);
        System.out.println(dayAfterTommorrow " 格式化后的日期为: " formatted);
    }
}

示例18：字符串互转日期类型

代码语言：javascript复制

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

public class Demo18 {
    public static void main(String[] args) {
        LocalDateTime date = LocalDateTime.now();

        DateTimeFormatter format1 = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");
    
        String str = date.format(format1);

        System.out.println("日期转换为字符串:" str);

        DateTimeFormatter format2 = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");
    
        LocalDate date2 = LocalDate.parse(str,format2);
        System.out.println("日期类型:" date2);

    }
}

示例19：时间修改

代码语言：javascript复制

@Test
public void test() {

    LocalDateTime now = LocalDateTime.now();
    System.out.println("now:"   now);

    LocalDateTime after = now.withYear(1990);
    System.out.println("after:"   after);
}

开发者实验室

0 人点赞