java日期时间api小计

JDK8 之前：日期时间 API

java.lang.System

System 类提供的 public static long currentTimeMillis()：用来返回当前时间与 1970 年 1 月 1 日 0 时 0 分 0 秒之间以毫秒为单位的时间差

java.util.Date

构造器：

• Date()：无参构造获取本地时间
• Date(long 毫秒数)：通过毫秒数转换成时间对象

常用方法：

• getTime()： 返回自 1970 年 1 月 1 日 00:00:00 GMT 以来此 Date 对象 表示的毫秒数

举例

public void DateTest(){
  Date d1 = new Date();
  Date d2 = new Date(1559807047979L);
  long time = d1.getTime();
}

java.text.SimpleDateFormat

SimpleDateFormat 是一个以语言环境敏感的方式来格式化和分析日期的类

SimpleDateFormat 允许你选择任何用户自定义日期时间格式来运行

格式化：日期 --> 文本

解析：文本 --> 日期

构造器：

• SimpleDateFormat ()：默认格式创建对象
• SimpleDateFormat (String parten)：指定的格式创建一个对象

格式化：

• public String format(Date date)：方法格式化日期对象，通过构造器指定格式

解析：

• public Date parse(String source)：从给定字符串的开始解析文本，以生成 一个日期

例如：

public void DateTest(){
  Date date = new Date();
  // 指定格式
  SimpleDateFormat sf = new SimpleDateFormat("yyyy 年 MM 月 dd 日 HH 时 mm 分 ss 秒 SSS 毫秒 ");
  // 日期格式化
  String dateStr = sf.format(date);
  
  String dateStr2 = "2022 年 06 月 06 日 16 时 03 分 14 秒 545 毫秒";
  // 解析，指定格式的字符串解析成日期对象
  Date date2 = sf.parse(dateStr2);
}

注意： yyyy 是完整的公元年，MM 是月份，dd 是日期，HH:mm:ss 是时、分、秒。有的格式大写，有的格式小写，例如 MM 是月份，mm 是分；HH 是 24 小时制，而 hh 是 12 小时制

时间和日期格式化的编码

java.util.Calendar

Calendar 类是一个抽象类，主用用于完成日期字段之间相互操作的功能

Calendar.getInstance() 方法获取实例：

• getInstance()：默认日历
• getInstance(Locale alocale)：使用默认时区和指定语言环境
• getInstance(TimeZone zone)：使用指定时区和默认语言环境
• getInstance(TimeZone zone, Locale alocale)：指定时区，指定语言环境

一个 Calendar 的实例是系统时间的抽象表示，可以修改或获取 YEAR、MONTH、 DAYOFWEEK、HOUROFDAY 、MINUTE、SECOND 等 日历字段对应的时间值

• public int get(int field)：返回给定日历字段的值
• public void set(int field,int value) ：将给定的日历字段设置为指定的值
• public void add(int field,int amount)：根据日历的规则，为给定的日历字段 添加或者减去指定的时间量
• public final Date getTime()：将 Calendar 转成 Date 对象
• public final void setTime(Date date)：使用指定的 Date 对象重置 Calendar 的时间

常用字段：

例如：

Calendar c1 = Calendar.getInstance();
// 获得年份
int year = c1.get(Calendar.YEAR);
// 获得月份
int month = c1.get(Calendar.MONTH) + 1;
// 获得日期
int date = c1.get(Calendar.DATE);
// 获得小时
int hour = c1.get(Calendar.HOUR_OF_DAY);
// 获得分钟
int minute = c1.get(Calendar.MINUTE);
// 获得秒
int second = c1.get(Calendar.SECOND);
// 获得星期几（注意（这个与Date类是不同的）：1代表星期日、2代表星期1、3代表星期二，以此类推）
int day = c1.get(Calendar.DAY_OF_WEEK);

.JDK8：新的日期时间 API

新的 java.time 中包含了所有关于时钟（Clock），本地日期 （LocalDate）、本地时间（LocalTime）、本地日期时间（LocalDateTime）、 时区（ZonedDateTime）和持续时间（Duration）的类

LocalDate、LocalTime、LocalDateTime

例如：

public void testTime(){
  LocalDate nowDate = LocalDate.now(); // 2023-06-20
  LocalTime nowTime = LocalTime.now(); // 09:36:29.488299
  LocalDateTime nowDateTime = LocalDateTime.now(); // 2023-06-20T09:36:29.488362
	LocalDate lai = LocalDate.of(2019, 5, 13);  // 2019-05-13
  LocalDate go = lai.plusDays(160); // 2019-10-20

}

DateTimeFormatter

该类提供了三种格式化方法：

1. (了解)预定义的标准格式。如：ISOLOCALDATETIME、ISOLOCALDATE、 ISOLOCAL_TIME
2. (了解)本地化相关的格式。如：ofLocalizedDate(FormatStyle.LONG)
3. 自定义的格式。如：ofPattern(“yyyy-MM-dd hh:mm:ss”)

方法：

• ofPattern(String pattern) ：静态方法，返回一个指定字符串格式的 DateTimeFormatter
• format(TemporalAccessort)：格式化一个日期、时间，返回字符串
• parse(CharSequence text) ：将指定格式的字符序列解析为一个日期、时间

例如：

// 自定义格式方法
DateTimeFormatter df = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");
// 格式化
String strDateTime = df.format(LocalDateTime.now());
//解析
TemporalAccessor accessor = dateTimeFormatter.parse("2022/12/04 21:05:42");
LocalDateTime localDateTime = LocalDateTime.from(accessor);

参考资料

尚硅谷Java基础

菜鸟教程