JAVA中关于时间类的API【蓝桥所需篇】

绿蚁新亭

已于 2024-03-03 12:30:39 修改

阅读量767

点赞数 11

文章标签： java 开发语言

于 2024-03-03 11:05:33 首次发布

本文链接：https://blog.csdn.net/lvyixinniang_/article/details/136427844

版权

最近，在打蓝桥杯，在练习时发现自己对日期API掌握力很低，所以特来总结一下

Java中日期和时间API的发展经历了从早期的java.util.Date类到Java 8引入的全新java.time包下的API。

下面分别介绍这两部分的主要类及其特性：

Java 8之前的日期API

java.util.Date
- Date类在Java早期版本中用于表示特定的时间点，精确到毫秒。
- 构造方法包括无参构造器（获取当前系统时间），以及通过毫秒数构造日期对象的方法。
- 提供了getTime()和setTime(long)方法来获取和设置从1970年1月1日0时0分0秒（UTC）以来的毫秒数。
- 这个类的设计存在一些问题，如不区分日期和时间、时区处理不便、线程安全性较差等，因此在Java 8后被标记为过时。

构造方法：
- Date(): 创建一个表示当前时间的Date对象。
- Date(long date): 根据从1970年1月1日0点0分0秒（UTC）到指定日期所经过的毫秒数创建一个Date对象。
主要方法：
- getTime(): 返回自 1970 年 1 月 1 日 00:00:00 GMT 以来此对象表示的毫秒值。
- setTime(long time): 将此 Date 对象设置为表示自从 1970 年 1 月 1 日 00:00:00 GMT 以来指定的以毫秒为单位的时间量。
- before(Date when) 和 after(Date when): 比较两个日期的先后关系。

java.sql.Date
- 专为数据库交互设计，继承自java.util.Date，但去除了时间部分，只保留日期信息。
- 用于存储SQL DATE类型的数据，在JDBC编程中使用较多。
java.util.Calendar
- 更高级别的日期和时间处理类，提供了对日期字段进行操作的方法（例如增加一天或一个月）。
- 可以与TimeZone结合使用处理时区相关的问题，但其API较为复杂且易用性不佳。

静态工厂方法：
- Calendar.getInstance(): 获取当前系统的默认日历实例，通常与当前时区相关联。
基本设置和获取方法：
- set(int field, int value): 设置指定的日历字段值。
```
calendar.set(year, 11, 31);  // 注意0是代表1月份，所以12月份应该是11
```
- get(int field): 获取指定的日历字段值，如YEAR、MONTH、DAY_OF_MONTH等。
时间操作方法：
- add(int field, int amount): 向指定的日历字段添加或减去指定的时间量。
- roll(int field, boolean up): 将指定的日历字段向前或向后滚动，但不会改变更大的字段值。
- getTime(): 获得此日历对象表示的时间点对应的Date对象。
计算日期边界方法：
- getActualMinimum(int field): 获取给定日历字段可能具有的最小值。
- getActualMaximum(int field): 获取给定日历字段可能具有的最大值。
转换方法：
- getTimeInMillis(): 获取此Calendar表示的时间点距离标准基准时间（即1970年1月1日0点0分0秒GMT）的毫秒数。
- setTime(Date date): 设置Calendar对象的时间点，使之与指定的Date对象相同。

获取星期几

int dayOfWeek = calendar.get(Calendar.DAY_OF_WEEK);// 这里星期日为1，星期一为2..

// 使用Date
Date currentDate = new Date();
long currentTimeMillis = currentDate.getTime();

// 使用Calendar
Calendar calendar = Calendar.getInstance();
calendar.set(2023, Calendar.JANUARY, 1, 0, 0, 0); // 设置日期
int year = calendar.get(Calendar.YEAR); // 获取年份

// Date转Calendar
calendar.setTime(currentDate);
// Calendar转Date
Date dateFromCalendar = calendar.getTime();

Java 8 引入的新日期/时间API

在Java 8中，为了弥补旧版日期API的不足，新增了一个全新的日期时间处理包java.time，它包含了以下主要类：

1.LocalDate

表示不含时区的日期，只包含年、月、日信息，不可变类。
提供了一系列简单直观的操作日期的方法，如创建、比较、解析和格式化。

常见方法：

now()：获取当前系统的本地日期。
of(int year, int month, int dayOfMonth)：根据年、月、日创建一个LocalDate对象。
isBefore/After(LocalDate other)：比较两个日期先后。
plusDays/minusDays(long days)：增加或减少指定天数。
getYear/Month/DayOfMonth()：获取年、月、日信息。

2.LocalTime

表示不含时区的时间，只包含小时、分钟、秒和纳秒信息，同样也是不可变的。

常见方法：

now()：获取当前系统本地时间。
of(int hour, int minute, int second, int nanoOfSecond)：根据小时、分钟、秒和纳秒创建一个LocalTime对象。
isBefore/After(LocalTime other)：比较两个时间早晚。
plusHours/minusHours(long hours)等：增加或减少小时、分钟、秒等时间单位。
getHour/MINUTE/SECOND/NANO_OF_SECOND()：获取时、分、秒、纳秒信息。

3.LocalDateTime

结合了LocalDate和LocalTime，表示本地日期和时间，不带时区信息，可用来表示完整的日期和时间。

常见方法：

now()：获取当前系统本地日期和时间。
of(LocalDate date, LocalTime time)：根据日期和时间创建一个LocalDateTime对象。
atZone(ZoneId zone)：将LocalDateTime转换为带有时区的ZonedDateTime。
plusDays/minusDays(long days)等：对日期和时间进行加减操作。
isEqual/compareTo(LocalDateTime other)：判断是否相等或比较顺序。

4.ZonedDateTime

包含了时区信息的完整日期和时间，适合于全球化应用中的日期和时间管理。

常见方法：

now(ZoneId zone)：获取指定时区的当前日期和时间。
ofInstant(Instant instant, ZoneId zone)：根据瞬时时间和时区创建ZonedDateTime。
withZoneSameInstant(ZoneId zone)：改变其时区，保持瞬时时刻不变。
toLocalDate/toLocalTime()：提取日期或时间部分。
plusYears/minusYears()等：增加或减少年、月、日、小时等时间单位。

5.Instant

表示的是时间戳，即格林尼治标准时间（UTC）的某个瞬间，它是Date类的一个更精确和清晰的替代品。

常用方法：

now()：获取当前UTC标准下的即时时间（时间戳）。
ofEpochSecond(long epochSecond, long nanoAdjustment)：根据自1970-01-01T00:00:00Z以来的秒数和纳秒偏移量创建Instant对象。
atOffset(ZoneOffset offset)：结合偏移量创建OffsetDateTime。
toEpochMilli()：转换为自1970年以来的毫秒数。
plusSeconds/minusSeconds(long seconds)等：添加或减少秒数、纳秒数。

Duration
- 表示两个时间点之间的时间间隔，精确到纳秒级别。
Period
- 表示日期间的周期，比如“两年三个月”，主要用于计算日期之间的差异。
Clock
- 提供了获取当前即时（或固定不变）时间的功能，支持不同类型的时钟源。
DateTimeFormatter
- 虽然不是日期时间实例，但用于日期时间格式化与解析非常常见：
  - ofPattern(String pattern)：根据模式字符串创建日期时间格式器。
  - format(LocalDateTime/ZonedDateTime/Instant etc.)：将日期时间对象格式化为字符串。
  - parse(CharSequence text)：从字符串解析出日期时间对象。