轉載自:https://blog.csdn.net/h_xiao_x/article/details/79729507
新時間日期API常用、重要對象介紹
- ZoneId: 時區ID,用來確定Instant和LocalDateTime互相轉換的規則
- Instant: 用來表示時間線上的一個點(瞬時)
- LocalDate: 表示沒有時區的日期, LocalDate是不可變並且線程安全的
- LocalTime: 表示沒有時區的時間, LocalTime是不可變並且線程安全的
- LocalDateTime: 表示沒有時區的日期時間, LocalDateTime是不可變並且線程安全的
- Clock: 用於訪問當前時刻、日期、時間,用到時區
- Duration: 用秒和納秒錶示時間的數量(長短),用於計算兩個日期的“時間”間隔
- Period: 用於計算兩個“日期”間隔
其中,LocalDate
、LocalTime
、LocalDateTime
是新API裏的基礎對象,絕大多數操作都是圍繞這幾個對象來進行的,有必要搞清楚:
LocalDate : 只含年月日的日期對象
LocalTime :只含時分秒的時間對象
LocalDateTime : 同時含有年月日時分秒的日期對象
本文將以實例講解日常開發中常用到的時間日期操作,如:
獲取當前日期、時間
指定時間日期創建對應的對象
計算兩個時間點的間隔
判斷兩個時間的前後
時間日期的格式化
獲取時間戳
時間、日期相加減
獲取給定時間點的年份、月份、周、星期等
……
新時間日期API詳解與示例
獲取當前時間
LocalDate localDate = LocalDate.now();
LocalTime localTime = LocalTime.now();
LocalDateTime localDateTime = LocalDateTime.now();
System.out.println(localDate);
System.out.println(localTime);
System.out.println(localDateTime);
運行結果:
根據指定日期/時間創建對象
LocalDate localDate = LocalDate.of(2018, 1, 13);
LocalTime localTime = LocalTime.of(9, 43, 20);
LocalDateTime localDateTime = LocalDateTime.of(2018, 1, 13, 9, 43, 20);
System.out.println(localDate);
System.out.println(localTime);
System.out.println(localDateTime);
運行結果:
日期時間的加減
- 對於
LocalDate
,只有精度大於或等於日的加減,如年、月、日; - 對於
LocalTime
,只有精度小於或等於時的加減,如時、分、秒、納秒; - 對於
LocalDateTime
,則可以進行任意精度的時間相加減;
LocalDateTime localDateTime = LocalDateTime.now();
//以下方法的參數都是long型,返回值都是LocalDateTime
LocalDateTime plusYearsResult = localDateTime.plusYears(2L);
LocalDateTime plusMonthsResult = localDateTime.plusMonths(3L);
LocalDateTime plusDaysResult = localDateTime.plusDays(7L);
LocalDateTime plusHoursResult = localDateTime.plusHours(2L);
LocalDateTime plusMinutesResult = localDateTime.plusMinutes(10L);
LocalDateTime plusSecondsResult = localDateTime.plusSeconds(10L);
System.out.println("當前時間是 : " + localDateTime + "\n"
+ "當前時間加2年後爲 : " + plusYearsResult + "\n"
+ "當前時間加3個月後爲 : " + plusMonthsResult + "\n"
+ "當前時間加7日後爲 : " + plusDaysResult + "\n"
+ "當前時間加2小時後爲 : " + plusHoursResult + "\n"
+ "當前時間加10分鐘後爲 : " + plusMinutesResult + "\n"
+ "當前時間加10秒後爲 : " + plusSecondsResult + "\n"
);
//也可以以另一種方式來相加減日期,即plus(long amountToAdd, TemporalUnit unit)
// 參數1 : 相加的數量, 參數2 : 相加的單位
LocalDateTime nextMonth = localDateTime.plus(1, ChronoUnit.MONTHS);
LocalDateTime nextYear = localDateTime.plus(1, ChronoUnit.YEARS);
LocalDateTime nextWeek = localDateTime.plus(1, ChronoUnit.WEEKS);
System.out.println("now : " + localDateTime + "\n"
+ "nextYear : " + nextYear + "\n"
+ "nextMonth : " + nextMonth + "\n"
+ "nextWeek :" + nextWeek + "\n"
);
//日期的減法用法一樣,在此不再舉例
運行結果:
將年、月、日等修改爲指定的值,並返回新的日期(時間)對象
其效果與時間日期相加減差不多,如今天是2018-01-13,要想變爲2018-01-20有兩種方式
- a. localDate.plusDays(20L) -> 相加指定的天數
- b. localDate.withDayOfYear(20) -> 直接指定到哪一天
LocalDate localDate = LocalDate.now();
//當前時間基礎上,指定本年當中的第幾天,取值範圍爲1-365,366
LocalDate withDayOfYearResult = localDate.withDayOfYear(200);
//當前時間基礎上,指定本月當中的第幾天,取值範圍爲1-29,30,31
LocalDate withDayOfMonthResult = localDate.withDayOfMonth(5);
//當前時間基礎上,直接指定年份
LocalDate withYearResult = localDate.withYear(2017);
//當前時間基礎上,直接指定月份
LocalDate withMonthResult = localDate.withMonth(5);
System.out.println("當前時間是 : " + localDate + "\n"
+ "指定本年當中的第200天 : " + withDayOfYearResult + "\n"
+ "指定本月當中的第5天 : " + withDayOfMonthResult + "\n"
+ "直接指定年份爲2017 : " + withYearResult + "\n"
+ "直接指定月份爲5月 : " + withMonthResult + "\n"
);
運行結果:
獲取日期的年月日周時分秒
LocalDateTime localDateTime = LocalDateTime.now();
int dayOfYear = localDateTime.getDayOfYear();
int dayOfMonth = localDateTime.getDayOfMonth();
DayOfWeek dayOfWeek = localDateTime.getDayOfWeek();
System.out.println("今天是" + localDateTime + "\n"
+ "本年當中第" + dayOfYear + "天" + "\n"
+ "本月當中第" + dayOfMonth + "天" + "\n"
+ "本週中星期" + dayOfWeek.getValue() + "-即" + dayOfWeek + "\n");
//獲取當天時間的年月日時分秒
int year = localDateTime.getYear();
Month month = localDateTime.getMonth();
int day = localDateTime.getDayOfMonth();
int hour = localDateTime.getHour();
int minute = localDateTime.getMinute();
int second = localDateTime.getSecond();
System.out.println("今天是" + localDateTime + "\n"
+ "年 : " + year + "\n"
+ "月 : " + month.getValue() + "-即 "+ month + "\n"
+ "日 : " + day + "\n"
+ "時 : " + hour + "\n"
+ "分 : " + minute + "\n"
+ "秒 : " + second + "\n"
);
運行結果:
時間日期前後的比較與判斷
//判斷兩個時間點的前後
LocalDate localDate1 = LocalDate.of(2017, 8, 8);
LocalDate localDate2 = LocalDate.of(2018, 8, 8);
boolean date1IsBeforeDate2 = localDate1.isBefore(localDate2);
System.out.println("date1IsBeforeDate2 : " + date1IsBeforeDate2);
// date1IsBeforeDate2 == true
判斷是否爲閏年
LocalDate now = LocalDate.now();
System.out.println("now : " + now + ", is leap year ? " + );
java8時鐘 : clock()
//返回當前時間,根據系統時間和UTC
Clock clock = Clock.systemUTC();
// 運行結果: SystemClock[Z]
System.out.println(clock);
時間戳
事實上Instant
就是java8以前的Date,
可以使用以下兩個類中的方法在這兩個類型之間進行轉換,
比如Date.from(Instant)
就是用來把Instant
轉換成java.util.date
的,
而new Date().toInstant()
就是將Date
轉換成Instant
的。
Instant instant = Instant.now();
//2019-06-08T16:50:19.174Z
System.out.println(instant);
Date date = Date.from(instant);
Instant instant2 = date.toInstant();
//Sun Jun 09 00:50:19 CST 2019
System.out.println(date);
//2019-06-08T16:50:19.174Z
System.out.println(instant2);
計算時間、日期間隔
Duration
: 用於計算兩個“時間”間隔
Period
: 用於計算兩個“日期”間隔
//計算兩個日期的日期間隔-年月日
LocalDate date1 = LocalDate.of(2018, 2, 13);
LocalDate date2 = LocalDate.of(2017, 3, 12);
//內部是用date2-date1,所以得到的結果是負數
Period period = Period.between(date1, date2);
System.out.println("相差年數 : " + period.getYears());
System.out.println("相差月數 : " + period.getMonths());
System.out.println("相差日數 : " + period.getDays());
//還可以這樣獲取相差的年月日
System.out.println("-------------------------------");
long years = period.get(ChronoUnit.YEARS);
long months = period.get(ChronoUnit.MONTHS);
long days = period.get(ChronoUnit.DAYS);
System.out.println("相差的年月日分別爲 : " + years + "," + months + "," + days);
//注意,當獲取兩個日期的間隔時,並不是單純的年月日對應的數字相加減,而是會先算出具體差多少天,在折算成相差幾年幾月幾日的
//計算兩個時間的間隔
System.out.println("-------------------------------");
LocalDateTime date3 = LocalDateTime.now();
LocalDateTime date4 = LocalDateTime.of(2018, 1, 13, 22, 30, 10);
Duration duration = Duration.between(date3, date4);
System.out.println(date3 + " 與 " + date4 + " 間隔 " + "\n"
+ " 天 :" + duration.toDays() + "\n"
+ " 時 :" + duration.toHours() + "\n"
+ " 分 :" + duration.toMinutes() + "\n"
+ " 毫秒 :" + duration.toMillis() + "\n"
+ " 納秒 :" + duration.toNanos() + "\n"
);
//注意,並沒有獲得秒差的,但既然可以獲得毫秒,秒就可以自行獲取了
運行結果:
當計算程序的運行時間時,應當使用時間戳Instant
Instant ins1 = Instant.now();
for (int i = 0; i < 10000000; i++) {
//循環一百萬次
}
Instant ins2 = Instant.now();
Duration duration = Duration.between(ins1, ins2);
System.out.println("程序運行耗時爲 : " + duration.toMillis() + "毫秒");
時間日期的格式化(格式化後返回的類型是String)
1、 使用jdk自身配置好的日期格式
//使用jdk自身配置好的日期格式
DateTimeFormatter formatter1 = DateTimeFormatter.ISO_DATE_TIME;
LocalDateTime date1 = LocalDateTime.now();
//反過來調用也可以 : date1.format(formatter1);
String date1Str = formatter1.format(date1);
System.out.println(date1Str);
運行結果:
注:自定義轉化的格式一定要與日期類型對應
- LocalDate只能設置僅含年月日的格式
- LocalTime只能設置僅含時分秒的格式
- LocalDateTime可以設置含年月日時分秒的格式
代碼如下:
DateTimeFormatter formatter3 = DateTimeFormatter.ofPattern("yyyy-MM-dd");
System.out.println(formatter3.format(LocalDate.now()));
System.out.println("-------------------------------");
DateTimeFormatter formatter4 = DateTimeFormatter.ofPattern("HH:mm:ss");
System.out.println(formatter4.format(LocalTime.now()));
運行結果:
將時間字符串形式轉化爲日期對象
String datetime = "2018-01-13 21:27:30";
DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
LocalDateTime ldt = LocalDateTime.parse(datetime, dtf);
System.out.println(ldt);
運行結果:
注:格式的寫法必須與字符串的形式一樣
2018-01-13 21:27:30
對應 yyyy-MM-dd HH:mm:ss
20180113213328
對應 yyyyMMddHHmmss
否則會報運行時異常!
但要記住:得到的最終結果都是類似2018-01-13T21:27:30的格式
因爲在輸出LocalDateTime
對象時,會調用其重寫的toString
方法。
@Override
public String toString() {
return date.toString() + 'T' + time.toString();
}
將時間日期對象轉爲格式化後的時間日期對象
//新的格式化API中,格式化後的結果都默認是String,有時我們也需要返回經過格式化的同類型對象
LocalDateTime ldt1 = LocalDateTime.now();
DateTimeFormatter dtf1 = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
String temp = dtf1.format(ldt1);
LocalDateTime formatedDateTime = LocalDateTime.parse(temp, dtf1);
System.out.println(formatedDateTime);
運行結果:
long毫秒值轉換爲日期
System.out.println("---------long毫秒值轉換爲日期---------");
DateTimeFormatter df= DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
String longToDateTime = df.format(LocalDateTime.ofInstant(
Instant.ofEpochMilli(System.currentTimeMillis()),ZoneId.of("Asia/Shanghai")));
System.out.println(longToDateTime);
運行結果: