Java 8 的日期与时间

拼搏现实的明天。 2023-06-04 04:56 38阅读 0赞

日期与时间的类型简述

日期与时间的类型主要包括：java.time.Instant、java.time.LocalDate/ java.time.LocalTime / java.time.LocalDateTime、java.time.ZonedDateTime。

Instant

java.time.Instant 承载纳秒级精度的 Unix 时间，其 String toString() 方法基于 ISO-8601 进行格式化。Instant 不承载时区信息。

LocalDate / LocalTime / LocalDateTime

  1. java.time.LocalDate 用于表示 “本地日期”，无 “时间”。LocalDate 不承载时区信息。
  2. java.time.LocalTime 用于表示 “本地时间”，无 “日期”。LocalTime 不承载时区信息。
  3. java.time.LocalDateTime 用于表示 “本地日期与时间”。LocalDateTime 不承载时区信息。
  4. LocalDate 实例与 LocalTime 实例能够共同构建 LocalDateTime 实例，由
    LocalDateTime 实例能够获取 LocalDate 实例与 LocalTime 实例。

日期工具类Code

  1. package cn.fxbin.bubble.core.util;
  3. import lombok.experimental.UtilityClass;
  4. import lombok.extern.slf4j.Slf4j;
  6. import java.time.*;
  7. import java.time.format.DateTimeFormatter;
  8. import java.time.temporal.ChronoUnit;
  9. import java.time.temporal.TemporalAdjusters;
  10. import java.util.Date;
  12. /** * DateUtils 日期操作工具类 * * @author fxbin * @version v1.0 * @since 2019/9/29 17:53 */
  13. @Slf4j
  14. @UtilityClass
  15. public class DateUtils { 
  17.     /** 标准日期格式：yyyy-MM-dd */
  18.     public final String NORM_DATE_PATTERN = "yyyy-MM-dd";
  20.     /** 国际标准日期格式：dd-MM-yyyy */
  21.     public final String NORM_I18N_DATE_PATTERN = "dd-MM-yyyy";
  23.     /** 标准时间格式：HH:mm:ss */
  24.     public final String NORM_TIME_PATTERN = "HH:mm:ss";
  26.     /** 标准日期时间格式，精确到分：yyyy-MM-dd HH:mm */
  27.     public final String NORM_DATETIME_MINUTE_PATTERN = "yyyy-MM-dd HH:mm";
  29.     /** 标准日期时间格式，精确到秒：yyyy-MM-dd HH:mm:ss */
  30.     public final String NORM_DATETIME_PATTERN = "yyyy-MM-dd HH:mm:ss";
  32.     /** 国际标准时间格式， 精确到秒 dd/MM/yyy HH:mm:ss */
  33.     public static final String NORM_I18N_DATETIME_FORMAT = "dd/MM/yyy HH:mm:ss";
  35.     /** 标准日期时间格式，精确到毫秒：yyyy-MM-dd HH:mm:ss.SSS */
  36.     public final String NORM_DATETIME_MS_PATTERN = "yyyy-MM-dd HH:mm:ss.SSS";
  38.     /** 标准日期格式：yyyy年MM月dd日 */
  39.     public final String CHINESE_DATE_PATTERN = "yyyy年MM月dd日";
  41.     //-------------------------------------------------------------------------------------------------------------------------------- Pure
  42.     /** 标准日期格式：yyyyMMdd */
  43.     public final String PURE_DATE_PATTERN = "yyyyMMdd";
  45.     /** 标准日期格式：HHmmss */
  46.     public final String PURE_TIME_PATTERN = "HHmmss";
  48.     /** 标准日期格式：yyyyMMddHHmmss */
  49.     public final String PURE_DATETIME_PATTERN = "yyyyMMddHHmmss";
  51.     /** 标准日期格式：yyyyMMddHHmmssSSS */
  52.     public final String PURE_DATETIME_MS_PATTERN = "yyyyMMddHHmmssSSS";
  54.     //-------------------------------------------------------------------------------------------------------------------------------- Others
  55.     /** HTTP头中日期时间格式：EEE, dd MMM yyyy HH:mm:ss z */
  56.     public final String HTTP_DATETIME_PATTERN = "EEE, dd MMM yyyy HH:mm:ss z";
  58.     /** JDK中日期时间格式：EEE MMM dd HH:mm:ss zzz yyyy */
  59.     public final String JDK_DATETIME_PATTERN = "EEE MMM dd HH:mm:ss zzz yyyy";
  61.     /** UTC时间：yyyy-MM-dd'T'HH:mm:ss'Z' */
  62.     public final String UTC_PATTERN = "yyyy-MM-dd'T'HH:mm:ss'Z'";
  65.     /** * now * * @author fxbin * @return 当前时间 */
  66.     public Date now() { 
  67.         return parseLocalDateTime2Date(LocalDateTime.now());
  68.     }
  71.     /** * 获取两个日期之间相差天数 * * @author fxbin * @param start 开始日期 * @param end 结束日期 * @return 天数 */
  72.     public long getDaysOfBetweenDate(String start, String end) { 
  73.         LocalDate startDate = LocalDate.parse(start);
  74.         LocalDate endDate = LocalDate.parse(end);
  75.         return ChronoUnit.DAYS.between(startDate, endDate);
  76.     }
  79.     /** * 获取两个日期之间相差天数 * * @author fxbin * @param start 开始日期 * @param end 结束日期 * @return 天数 */
  80.     public long getDaysOfBetweenDate(Date start, Date end) { 
  81.         LocalDate startDate = parseDate2LocalDate(start);
  82.         LocalDate endDate = parseDate2LocalDate(end);
  83.         return ChronoUnit.DAYS.between(startDate, endDate);
  84.     }
  87.     /** * 是否为当天 * * @author fxbin * @author fxbin * @param date 日期 * @return true|false */
  88.     public Boolean isToday(String date) { 
  89.         LocalDate localDate = LocalDate.parse(date);
  90.         if(LocalDate.now().getYear() == localDate.getYear()) { 
  91.             MonthDay monthDay = MonthDay.from(localDate);
  92.             MonthDay today = MonthDay.from(LocalDate.now());
  93.             return monthDay.equals(today);
  94.         }
  95.         return false;
  96.     }
  99.     /** * 获取当前年月日 * * @author fxbin * @author fxbin * @return 格式化之后的日期 yyyy-MM-dd */
  100.     public String getCurDateOfNormDatePattern () { 
  101.         return getCurDateTime(NORM_DATE_PATTERN);
  102.     }
  105.     /** * 获取当前年月日时分秒 * * @author fxbin * @return 格式化之后的日期 yyyy-MM-dd HH:mm:ss */
  106.     public String getCurDateOfNormDateTimePattern () { 
  107.         return getCurDateTime(NORM_DATETIME_PATTERN);
  108.     }
  111.     /** * 获取当前日期，自定义格式 * * @author fxbin * @param format 日期格式 * @return 格式化之后的日期 */
  112.     public String getCurDateTime(String format){ 
  113.         return parse(LocalDateTime.now(), format);
  114.     }
  117.     /** * 日期类型转换 默认 yyyy-MM-dd HH:mm:ss * * @author fxbin * @param date {@code Date} * @return 格式化之后的日期字符 */
  118.     public String parse(Date date) { 
  119.         return parse(parseDate2LocalDateTime(date), NORM_DATETIME_PATTERN);
  120.     }
  123.     /** * 日期类型转换 * * @author fxbin * @param date {@code Date} * @param format 日期格式 * @return 格式化之后的日期字符 */
  124.     public String parse(Date date, String format) { 
  125.         return parse(parseDate2LocalDateTime(date), format);
  126.     }
  129.     /** * 日期类型转换 * * @author fxbin * @param localDateTime {@code LocalDateTime} * @param format 日期格式 * @return 格式化之后的日期字符 */
  130.     public String parse(LocalDateTime localDateTime, String format) { 
  131.         DateTimeFormatter formatter = DateTimeFormatter.ofPattern(format);
  132.         return localDateTime.format(formatter);
  133.     }
  136.     /** * 日期类型转换 * * @author fxbin * @param localDate {@code LocalDate} * @param format 日期格式 * @return 格式化之后的日期字符 */
  137.     public String parse(LocalDate localDate, String format) { 
  138.         DateTimeFormatter formatter = DateTimeFormatter.ofPattern(format);
  139.         return localDate.format(formatter);
  140.     }
  143.     // ---------------------------------------------- 获取固定时间段内日期 LocalDateTime ----------------------------------------------------------------------------------
  146.     /** * nanoseconds add * * @author fxbin * @param nanos nanoseconds * @return N nanoseconds {@code LocalDateTime#plusNanos(long)} */
  147.     public LocalDateTime plusNanos (long nanos) { 
  148.         return LocalDateTime.now().plusNanos(nanos);
  149.     }
  152.     /** * N 秒之后 * * @author fxbin * @param seconds 添加的秒数，可能为负 * @return N 秒之后 {@code LocalDateTime} */
  153.     public LocalDateTime plusSeconds(long seconds) { 
  154.         return LocalDateTime.now().plusSeconds(seconds);
  155.     }
  158.     /** * N 分钟之后 * * @author fxbin * @param minutes 添加的分钟数, 可能为负 * @return N 分钟之后 {@code LocalDateTime} */
  159.     public LocalDateTime plusMinutes(long minutes) { 
  160.         return LocalDateTime.now().plusMinutes(minutes);
  161.     }
  164.     /** * N 小时之后 * * @author fxbin * @param hours 添加的小时数, 可能为负 * @return N 小时之后 {@code LocalDateTime} */
  165.     public LocalDateTime plusHours(long hours) { 
  166.         return LocalDateTime.now().plusHours(hours);
  167.     }
  170.     /** * 获取当天起始时间 2019-09-23 00:00:00 * * @author fxbin * @return {@code LocalDateTime} */
  171.     public LocalDateTime getTodayStart () { 
  172.         return LocalDateTime.now().withHour(0).withMinute(0).withSecond(0);
  173.     }
  175.     // ---------------------------------------------- 获取固定时间段内日期 LocalDate ------------------------------------------------------------------------
  177.     /** * 增加|减少天数 * * @author fxbin * @param days 天数 * @return {@link LocalDate} */
  178.     public LocalDate plusDays(Integer days) { 
  179.         return LocalDate.now().plusDays(days);
  180.     }
  183.     /** * 昨天 * * @author fxbin * @return 昨天 */
  184.     public LocalDate yesterday() { 
  185.         return LocalDate.now().plusDays(-1);
  186.     }
  189.     /** * 明天 * * @author fxbin * @return 明天 */
  190.     public LocalDate tomorrow() { 
  191.         return LocalDate.now().plusDays(1);
  192.     }
  195.     /** * 上周 * * @author fxbin * @return 上周 */
  196.     public LocalDate lastWeek() { 
  197.         return LocalDate.now().plusWeeks(-1);
  198.     }
  201.     /** * 下周 * * @author fxbin * @return 下周 */
  202.     public LocalDate nextWeek() { 
  203.         return LocalDate.now().plusWeeks(1);
  204.     }
  207.     /** * 上个月 * * @author fxbin * @return 上个月 */
  208.     public LocalDate lastMonth() { 
  209.         return LocalDate.now().plusMonths(-1);
  210.     }
  213.     /** * 下个月 * * @author fxbin * @return 下个月 */
  214.     public LocalDate nextMonth() { 
  215.         return LocalDate.now().plusMonths(1);
  216.     }
  219.     /** * 获取上月最后一天 * * @author fxbin * @return 上月最后一天日期{@code LocalDate} */
  220.     public LocalDate lastDayOfLastMonth() { 
  221.         return lastDayOfMonth(-1);
  222.     }
  225.     /** * 获取当前月最后一天 * * @author fxbin * @return 当前月最后一天日期{@code LocalDate} */
  226.     public LocalDate lastDayOfThisMonth() { 
  227.         return lastDayOfMonth(0);
  228.     }
  231.     /** * 获取下月最后一天 * * @author fxbin * @return 下月最后一天日期{@code LocalDate} */
  232.     public LocalDate lastDayOfNextMonth() { 
  233.         return lastDayOfMonth(1);
  234.     }
  237.     /** * 获取上月第一天 * * @author fxbin * @return 上月第一天日期{@code LocalDate} */
  238.     public LocalDate firstDayOfLastMonth() { 
  239.         return firstDayOfMonth(-1);
  240.     }
  243.     /** * 获取传入日期 月份的第一天 * * @author fxbin * @param date 日期 * @return {@code LocalDate} */
  244.     public LocalDate firstDayOfDateMonth(Date date) { 
  245.         LocalDate reqDate = parseDate2LocalDate(date);
  246.         int year = reqDate.getYear();
  247.         int month = reqDate.getMonthValue();
  248.         return LocalDate.of(year, month, 1);
  249.     }
  252.     /** * 获取当前月第cc一天 * * @author fxbin * @return 当前月第一天日期{@code LocalDate} */
  253.     public LocalDate firstDayOfThisMonth() { 
  254.         return firstDayOfMonth(0);
  255.     }
  258.     /** * 获取下月第一天 * * @author fxbin * @return 下月第一天日期{@code LocalDate} */
  259.     public LocalDate firstDayOfNextMonth() { 
  260.         return LocalDate.now().with(TemporalAdjusters.firstDayOfNextMonth());
  261.     }
  264.     /** * 本年度第一天 * * @author fxbin * @return 本年度第一天 */
  265.     public LocalDate firstDayOfYear() { 
  266.         return firstDayOfYear(0);
  267.     }
  270.     /** * 获取某月月份第一天日期 * * @author fxbin * @param monthsToAdd 添加的月份数, 可能为负 * @return 基于{@code LocalDate} 添加得到的月份，不为null(a {@code LocalDate} based on this date with the months added, not null) */
  271.     public LocalDate firstDayOfMonth(long monthsToAdd) { 
  272.         return LocalDate.now().plusMonths(monthsToAdd).with(TemporalAdjusters.firstDayOfMonth());
  273.     }
  276.     /** * 获取某月月份最后一天日期 * * @author fxbin * @param monthsToAdd 添加的月份数, 可能为负 * @return 基于{@code LocalDate} 添加得到的月份，不为null(a {@code LocalDate} based on this date with the months added, not null) */
  277.     public LocalDate lastDayOfMonth(long monthsToAdd) { 
  278.         return LocalDate.now().plusMonths(monthsToAdd).with(TemporalAdjusters.lastDayOfMonth());
  279.     }
  282.     /** * 某年第一天 * * @author fxbin * @param yearsToAdd 添加的年，可能为负 * @return 某年第一天 */
  283.     public LocalDate firstDayOfYear(long yearsToAdd) { 
  284.         return LocalDate.now().plusYears(yearsToAdd).with(TemporalAdjusters.firstDayOfYear());
  285.     }
  288.     /** * 某年最后一天 * * @author fxbin * @param yearsToAdd 添加的年，可能为负 * @return 某年最后一天 */
  289.     public LocalDate lastDayOfYear(long yearsToAdd) { 
  290.         return LocalDate.now().plusYears(yearsToAdd).with(TemporalAdjusters.lastDayOfYear());
  291.     }
  294.     /** * 当前时间是否为闰年 * * @author fxbin * @return 是否闰年 */
  295.     public boolean isLeapYear() { 
  296.         YearMonth yearMonth = YearMonth.from(LocalDate.now());
  297.         return yearMonth.isLeapYear();
  298.     }
  301.     /** * Date -> LocalDate * * @author fxbin * @param date {@code Date} * @return {@code LocalDate} */
  302.     public LocalDate parseDate2LocalDate(Date date) { 
  303.         LocalDate localDate = date.toInstant().atZone(ZoneId.systemDefault()).toLocalDate();
  304.         log.info("localDate by Instant: {}", localDate);
  305.         return localDate;
  306.     }
  309.     /** * Date -> LocalDateTime * * @author fxbin * @param date {@code Date} * @return {@code LocalDateTime} */
  310.     public LocalDateTime parseDate2LocalDateTime(Date date) { 
  311.         LocalDateTime localDateTime = date.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
  312.         log.info("localDateTime by Instant: {}", localDateTime);
  313.         return localDateTime;
  314.     }
  317.     /** * Date -> LocalTime * * @author fxbin * @param date {@code Date} * @return {@code LocalTime} */
  318.     public LocalTime parseDate2LocalTime(Date date) { 
  319.         LocalTime localTime = date.toInstant().atZone(ZoneId.systemDefault()).toLocalTime();
  320.         log.info("localTime by Instant: {}", localTime);
  321.         return localTime;
  322.     }
  325.     /** * LocalDate -> Date * * @author fxbin * @param localDate {@code LocalDate} * @return {@code Date} */
  326.     public Date parseLocalDate2Date(LocalDate localDate) { 
  327.         Date date = Date.from(localDate.atStartOfDay(ZoneId.systemDefault()).toInstant());
  328.         log.info("LocalDate -> Date: {}", date);
  329.         return date;
  330.     }
  333.     /** * LocalDateTime -> Date * * @author fxbin * @param localDateTime {@code LocalDateTime} * @return {@code Date} */
  334.     public Date parseLocalDateTime2Date(LocalDateTime localDateTime) { 
  335.         Date date = Date.from(localDateTime.atZone(ZoneId.systemDefault()).toInstant());
  336.         log.info("LocalDateTime -> Date: {}", date);
  337.         return date;
  338.     }
  340. }

如有问题，请与作者沟通，感谢阅读
– end –

发表评论

表情：
评论列表 （有 0 条评论，38人围观）

还没有评论，来说两句吧...

相关阅读

    相关 Java8的时间日期API

    [Java8的时间日期API][Java8_API] 原先的时间 api  大部分已经过时了 Date构造器 需要传入年月日  但是对时间的加减操作比较麻烦 Cale

    末蓝、末蓝、/ 0 赞/ 470 阅读