java.time:包含值对象的基础包
java.time.chrono:提供对不同的日历系统的访问
java.time.format:格式化和解析时间和日期
java.time.temporal:包括底层框架和扩展特性
java.time.zone:包含时区支持的类
说明:大多数开发者智慧用到基础包和format包,也可能会用到temporal包。因此,尽管有68个新的公开类型,大多数开发者,大概智慧用到其中的三分之一。
LocalDate、LocalTime、LocalDateTime
LocalDate、LocalTime、LocalDateTime类是其中比较重要的几个类,它们的实例是不可变的对象,分别表示使用ISO-8601日历系统的日期、时间、日期和时间。它2们提供了简单的本地日期或时间,并不包含当前的时间信息,也不包含与时区相关的信息。
LocalDate:代表IOS格式(yyyy-MM-dd)的日期,可以存储生日、纪念日等日期。
LocalTime:表示一个时间,而不是日期。
LocalDateTime:是用来表示日期和时间的,这是一个最常用的类之一。
注:ISO-8601日历系统是国际标准化组织制定的现代公民的日期和时间的表示法,也就是公历
方法 | 描述 |
now()/* now(Zoneld zone) | 静态方法,根据当前时间创建对象/指定时区的对象 |
of() | 静态方法,根据指定日期/时间创建对象 |
getDayOfMonth() / getDayOfYear() | 获得月份天数(1-31)/获得年份天数(1-366) |
getDayOfWeek() | 获得星期几(返回一个DayOfWeek枚举值) |
getMonth() | 获得月份,返回一个Month枚举值 |
getMonthValue() / getYear() | 获得月份(1-12)/获得年份 |
getHour() / getMinute / getSecond() | 获得当前对象对应的小时、分钟、秒 |
withDayOfMonth() / withDayOfYear() / withMonth() / witjYear() | 将月份天数、年份天数、月份、年份修改为指定的值并返回新的对象 |
plusDays(), plusWeeks(), plusMonths(), plusYears(), plusHours() | 向当前对象添加几天、几周、几个月、几年、几小时 |
minusMonths(), minusWeeks(), minusDays(), minusYear(),minusHours | 从当前对象减去几月、几周、几天、几年、几小时 |
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.util.Date;
import static java.time.LocalDateTime.*;
/*
jdk 8中日期时间API的测试
*/
public class JDK8DateTimeTest {
public void testDate(){
//偏移量
Date date1=new Date(2020-1900,9-1,8);
System.out.println(date1);//Tue Sep 08 00:00:00 GMT+08:00 2020
}
/*
LocalDate、LocalTime、LocalDateTime的使用
说明:
1.LocalDateTime相较于LocalDate、LocalTime
2.类似于Calendar
*/
public void test1(){
//now():获取当前的日期、时间、日期+时间
LocalDate localDate=LocalDate.now();
LocalTime localTime=LocalTime.now();
LocalDateTime localDateTime= LocalDateTime.now();
System.out.println(localDate);
System.out.println(localTime);
System.out.println(localDateTime);
//of():设置指定的年、月、日、时、分、秒。没有偏移量
localDateTime localDateTime1=localDateTime.of(2021,9,8,10,33,22);
System.out.println(localDateTime1);
//getXxx():获取相关属性
System.out.println(localDateTime.getDayOfMonth());
System.out.println(localDateTime.getDayOfWeek());
System.out.println(localDateTime.getMonth());
System.out.println(localDateTime.getMonthValue());
System.out.println(localDateTime.getMinute());
//体现不可变性
localDate localDate1=localDate.withDayOfMonth(22);
System.out.println(localDate);
System.out.println(localDate1);
LocalDateTime localDateTime2=localDateTime.withHour(4);
System.out.println(localDateTime);
System.out.println(localDateTime2);
//不可变性 加月
localDateTime localDateTime3=localDateTime.plusMonths(3);
System.out.println(localDateTime);
System.out.println(localDateTime3);
//减天
localDateTime localDateTime4=localDateTime.minusDays(6);
System.out.println(localDateTime);
System.out.println(localDateTime4);
}
}
瞬时:Instant
instant:时间线上的一个瞬时点。这可能被用来记录应用程序中的事件时间戳。
在处理时间和日期的时候,我们通常会想到年,月,日,时,分,秒。然而,这只是时间的一个模型,是面向人类的。第二种通用模型是面向机器的,或者说是连续的。在此模型中,时间线中的一个点表示为一个很大的数,这有利于计算机处理。在UNIX中,这个数从1970年开始,以秒为单位;同样的,在Java中,也是从1970年开始,但以毫秒为单位。
java.time包通过值类型Instant提供机器试图,不提供处理人类意义上的时间单位。Instant表示时间线上的一点,而不需要任何上下文信息,例如,时区。概念上讲,它只是简单的表示自1970年1月1日0时0分0秒(UTC)开始的秒数。因为java.time包时基于纳秒计算的,所以Instant的精度可以达到纳秒级。
(1ns=10^(-9)s) 1秒=1000毫秒=10^6微秒=10^9纳秒
方法 | 描述 |
now() | 静态方法,返回默认UTC时区的Instant类的对象 |
ofEpochMilli(long epochMilli) | 静态方法,返回在1970-01-01 00:00:00基础上加上指定毫秒数之后的Instant类的对象 |
atOffset(ZoneOffset offset) | 结合即时的偏移来床建一个OffsetDateTime |
toEpochMilli() | 返回1970-01-01 00:00:00到当前时间的毫秒数,即为时间戳 |
时间戳是指格林威治时间1970年01月01日00时00分00秒(北京时间1970年01月01日08时00分00秒)起至现在的总秒数。
/*
Instant的使用
类似于java.util.Date类
*/
public void test2(){
//now():获取本初子午线对应的标准时间
Instant instant=Instant.now();
System.out.println(instant);
//添加时间的偏移量
OffsetDateTime offsetDateTime=instant.atOffset(ZoneOffset.ofHours(8));
System.out.println(offsetDateTime);
//toEpochMilli():获取自1970年1月1日0时0分0秒(UTC)开始的毫秒数——>Date类的getTime()方法
long milli=instant.toEpochMilli();
System.out.println(milli);
//ofEpochMilli():通过给定的毫秒数,获取Instant实例——>Date(long millis);
Instant instant1=Instant.ofEpochMilli(1550475314878L);
System.out.println(instant1);
}
java.time.format.DateTimeFormatter类:
该类提供了三种格式化方法:
1)预定义的标准格式,如:ISO_LOCAK_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIMR
2)本地化相关的格式。如:ofLocalized(FormatStyle.LONG)
3)自定义的格式。如:ofPattern("yyyy-MM-dd hh:mm:ss E")
方法 | 描述 |
ofPattern(String pattern) | 静态方法,返回一个指定字符串格式的DateTimeFormatter |
format(TemporalAccessoor t) | 格式化一个日期、时间,返回字符串 |
parse(CharSequence text) | 将指定格式的字符序列解析为一个日期、时间 |
/*
DateTimeFormatter:格式化或解析日期、时间
类似于SimpleDateFormat
*/
public void test3(){
//方式一:预定义的标准格式,如:ISO_LOCAK_DATE_TIME;ISO_LOCAL_DATE;ISO_LOCAL_TIMR
DateTimeFormatter formatter=DateTimeFormatter.ISO_LOCAL_DATE_TIME;
//格式化:日期——>字符串
LocalDateTime localDateTime=LocalDateTime.now();
String str1=formatter.format(localDateTime);
System.out.println(localDateTime);
System.out.println(str1);
//解析:字符串——>日期
TemporalAccessor parse=formatter.parse("2021-09-08T16:05:18.787");
System.out.println(parse);
//方式二:本地化相关的格式。如:ofLocalized(FormatStyle.LONG)
DateTimeFormatter formatter1=DateTimeFormatter.ofLocalizedDateTime(FormatStyle.SHORT);
//格式化
String str2=formatter1.format(localDateTime);
System.out.println(str2);
DateTimeFormatter formatter2=DateTimeFormatter.ofLocalizedDate(FormatStyle.FULL);
//格式化
String str3=formatter2.format(LocalDate.now());
System.out.println(str3);//2021-9-8
//重点:方式三:自定义的格式。如:ofPattern("yyyy-MM-dd hh:mm:ss E")
DateTimeFormatter formatter3=DateTimeFormatter.ofPattern("yyyy-MM-dd hh:mm:ss");
//格式化
String str4=formatter1.format(localDateTime.now());
System.out.println(str4);//2021-09-08 04:34:16
//解析
TemporalAccessor accessor=formatter3.parse("2021-09-08 04:34:16");
System.out.println(accessor);
}
其他API:
Zoneld:该类中包含了所有的时区信息,一个时区的ID,如Europe/Paris
ZonedDateTime:一个在ISO-8601日历系统时区的日期时间,如2021-09-03T10:15:30+01:00 Europe/Paris。(每个时区都对应着ID,地区ID都为“{区域}/{城市}”的格式,例如:Asia/Shanghai等)
Clock:使用时区提供对当前即时、日期和时间的访问的时钟。
持续时间Duration:用于计算两个“时间”间隔
日期间隔Perido:用于计算两个“日期”间隔
TemporalAdjuster:时间校正器。有时我们可能要获取例如:将日期调整到“下一个工作日”等操作。
TemporalAdjusters:该通过静态方法(firstDayOfXxx()/lastDayOfXxx()/nextXxx())提供了大量的常用TemporalAdjuster的实现。
参考:与传统日期处理的转换
类 | To遗留类 | From遗留类 |
java.time.Instant与java.util.Data | Date.from(instant) | date.toInstant() |
java.time.Instant与java.sql.Timestamp | Timestamp.from(instant) | timestamp.toInstant() |
java.time.ZonedDateTime与java.util.GregorianCalendar | GregorianCalendar.from(zonedDate Time) | cal.toZonedDateTime() |
java.time.LocalDate与java.sql.Time | Date.valueOf(localDate) | date.toLocalDate() |
java.time.LocalTime与java.sql.Time | Date.valueOf(localDate) | date.toLocalDate() |
java.time.LocalDateTime与java.sql.Timestamp | Timestamp.valueOf(localDateTime) | timestamp.toLocalDateTime() |
java.time.Zoneld与java.util.TimeZone | Timezone.getTimeZone(id) | timeZone.toZoneld() |
java.time.format.DateTimeFormatter与java.text.DateFormat | formatter.toFormat() | 无 |