在 Java 8 中 推出了LocalDate、LocalTime、LocalDateTime這個三個時間處理類,以此來彌補之前的日期時間類的不足,簡化日期時間的操作。
Java8
日期和時間類包含LocalDate、LocalTime、Instant、Duration以及Period,這些類都包含在java.time包中
在Java8之前,處理日期時間的類是Date、Calendar 。
目前在西瓜視訊上免費刊登 Flutter 系列教學,每日更新,歡迎關注接收提醒
LocalDate、LocalDateTime 的now()方法使用的是系統預設時區.
@SpringBootTest
class DemoDateTests {
//紀錄檔
private static final Logger LOG = LoggerFactory.getLogger(DemoDateTests.class);
@Test
void test() {
//只獲取當前時區的日期
LocalDate localDate = LocalDate.now();
LOG.info("localDate: " + localDate);
//localDate: 2020-09-23
//只獲取當前時間
LocalTime localTime = LocalTime.now();
LOG.info("localTime: " + localTime);
//localTime: 23:41:43.991
//獲取不前的日期與時間
LocalDateTime localDateTime2 = LocalDateTime.now();
LOG.info("localDateTime2: " + localDateTime2);
//localDateTime2: 2020-09-23T23:41:43.991
}
}
在這裡獲取到的時間 2020-09-23T23:41:43.991 中間攜帶一個T指的是UTC時間。
UTC時間,是指零時區的時間,它的全稱是Coordinated Universal Time ,即世界協調時間。
另一個常見的縮寫是GMT,即格林威治標準時間,格林威治位於 零時區,因此,我們平時說的UTC時間和GMT時間在數值上面都是一樣的。
1884 年, 國際經度會議將地球表面按經線等分為24 區,稱為時區。即以本初子午線為基準, 東西經度各7.5 度的範圍作為零時區,
然後每隔15度為一時區,每個時區相差一小時,北京時區為東八區。
比如:北京時間 2020-09-23 12:00:00 那麼 utc 時間就是 2020-09-23 04:00:00;
當然獲取到的時間格式可能不是我們想要的,可以結合 DateTimeFormatter來對其進行格式化操作如下:
@Test
void test1() {
//使用靜態方法生成此物件
LocalDateTime localDateTime = LocalDateTime.now();
LOG.info("localDateTime: " + localDateTime);
///localDateTime: 2020-09-23T23:47:41.752
//格式化時間
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("YYYY-MM-dd HH:mm:ss");
//格式化後的時間
String formatDate = localDateTime.format(formatter);
LOG.info("格式化之後的時間: " + formatDate);
//格式化之後的時間: 2020-09-23 23:47:41
}
LocalDate類表示一個具體的日期,但不包含具體時間,也不包含時區資訊。可以通過LocalDate的靜態方法of()建立一個範例,LocalDate也包含一些方法用來獲取年份,月份,天,星期幾等。
@Test
void test3() {
//當然你也可以使用當前的時間
//LocalDate localDate = LocalDate.now();
// 初始化一個日期:2020-09-24
LocalDate localDate = LocalDate.of(2020, 9, 24);
int year = localDate.getYear(); // 年份:2020
Month month = localDate.getMonth(); // 月份:SEPTEMBER
int dayOfMonth = localDate.getDayOfMonth(); // 月份中的第幾天:24
DayOfWeek dayOfWeek = localDate.getDayOfWeek(); // 一週的第幾天:THURSDAY
int length = localDate.lengthOfMonth(); // 月份的天數:30
boolean leapYear = localDate.isLeapYear(); // 是否為閏年:true
}
斷點單元測試執行如下
LocalTime 與 LocalDate 類似,區別在於 LocalDate 不包含具體時間,而 LocalTime 包含具體時間
@Test
void test4() {
//當前的時間
LocalTime localTime = LocalTime.now();
int hour = localTime.getHour(); // 時:07
int minute = localTime.getMinute(); // 分:22
int second = localTime.getSecond(); // 秒:20
}
斷點單元測試執行如下
LocalDateTime 類是 LocalDate 和 LocalTime 的結合體,可以通過of()方法直接建立,也可以呼叫 LocalDate 的 atTime() 方法或 LocalTime 的 atDate() 方法將 LocalDate 或 LocalTime 合併成一個LocalDateTime.
@Test
void test5() {
///通過 of 方法建立 LocalDateTime
LocalDateTime localDateTime = LocalDateTime.of(
2020,//年
Month.JANUARY,//月
4, //日
//時 分 秒
17, 23, 52);
}
可以這樣理解 LocalDate 與 LocalTime 向 LocalDateTime 轉化,就是將兩者合併的過程,如下所示:
@Test
void test6() {
//通過of方法來建立 LocalDate
//引數為年 月 日
LocalDate localDate = LocalDate.of(2020, Month.JANUARY, 4);
//通過of方法來建立 LocalTime
//引數為 時分秒
LocalTime localTime = LocalTime.of(07, 23, 52);
// LocalDate 轉 LocalDateTime
LocalDateTime localDateTime = localDate.atTime(localTime);
// LocalTime 轉 LocalDateTime
LocalDateTime localDateTime1 = localTime.atDate(localDate);
}
斷點單元測試執行如下
當然也可以反過來 LocalDateTime 轉為 LocalDate 或者 LocalTime,如下所示:
LocalDate date = localDateTime.toLocalDate();
LocalTime time = localDateTime.toLocalTime();
時間戳是指格林威治時間1970年01月01日00時00分00秒(北京時間1970年01月01日08時00分00秒)起至現在的總秒數
ZoneId 指地區
ZoneOffset指偏移資料
@Test
void test2() {
//使用靜態方法生成此物件
LocalDateTime localDateTime = LocalDateTime.now();
LOG.info("localDateTime: " + localDateTime);
///localDateTime: 2020-09-23T23:49:11.832
//轉化為時間戳(秒)
long epochSecond = localDateTime.toEpochSecond(ZoneOffset.of("+8"));
//轉化為毫秒
long epochMilli = localDateTime.atZone(ZoneOffset.systemDefault()).toInstant().toEpochMilli();
LOG.info("時間戳為:(秒) " + epochSecond + "; (毫秒): " + epochMilli);
///時間戳為:(秒) 1600876151; (毫秒): 1600876151832
//時間戳(毫秒)轉化成LocalDateTime
Instant instant = Instant.ofEpochMilli(epochMilli);
LocalDateTime localDateTime3 = LocalDateTime.ofInstant(instant, ZoneOffset.systemDefault());
//時間戳(秒)轉化成LocalDateTime
Instant instant2 = Instant.ofEpochSecond(epochSecond);
LocalDateTime localDateTime4 = LocalDateTime.ofInstant(instant2, ZoneOffset.systemDefault());
}
Instant 類代表的是某個時間,是精確到納秒的,與我們常使用的System.currentTimeMillis()有些類似,不過Instant可以精確到納秒(Nano-Second),System.currentTimeMillis()方法只精確到毫秒(Milli-Second)。
如果使用納秒去表示一個時間則原來使用一位Long型別是不夠的,需要佔用更多一點的儲存空間,實際上其內部是由兩個Long欄位組成。
需要注意的是 但Instant 代表的是一個時間,並不包括時區的概念。
// Date 轉化成 LocalDateTime
public static LocalDateTime dateToLocalDate(Date date) {
//Date轉納秒
Instant instant = date.toInstant();
//獲取系統預設的時區
ZoneId zoneId = ZoneId.systemDefault();
//轉化
return instant.atZone(zoneId).toLocalDateTime();
}
// LocalDateTime 轉化成 Date
public static Date localDateTimeToDate(LocalDateTime localDateTime) {
ZoneId zoneId = ZoneId.systemDefault();
ZonedDateTime zdt = localDateTime.atZone(zoneId);
return Date.from(zdt.toInstant());
}
// Date 毫秒資料 轉化成 LocalDateTime
public static LocalDateTime dateToLocalDateMil(Long datemilli) {
//將毫秒資料轉化為納秒
Instant instant = Instant.ofEpochMilli(datemilli);
ZoneId zoneId = ZoneId.systemDefault();
return instant.atZone(zoneId).toLocalDateTime();
}
當然 Instant 也有很多妙操作
Instant 它的內部使用了兩個常數,seconds表示從 1970-01-01 00:00:00 開始到現在的秒數,nanos 表示納秒部分(nanos的值不會超過999,999,999)
Instant除了使用now()方法建立外,還可以通過ofEpochSecond方法建立:
@Test
void test7() {
//引數一為秒,引數二為納秒,
//這裡的程式碼錶示從1970-01-01 00:00:00開始後三分鐘的10萬納秒的時刻
Instant instant = Instant.ofEpochSecond(180, 100000);
LOG.info("時間為:" + instant );
}
斷點單元測試執行如下
在上述的操作中沒有提到這個類,Duration的內部實現與Instant類似,也是包含兩部分:seconds表示秒,nanos表示納秒。兩者的區別是Instant用於表示一個時間戳(或者說是一個時間點),而Duration表示一個時間段,所以Duration類中不包含now()靜態方法。可以通過Duration.between()方法建立Duration物件。
@Test
void test8() {
///開始時間
LocalDateTime from = LocalDateTime.of(2020, Month.JANUARY, 9, 10, 7, 0); // 2017-01-05 10:07:00
//結束時間
LocalDateTime to = LocalDateTime.of(2020, Month.FEBRUARY, 10, 10, 7, 0);
// 表示從 2020-09-05 10:07:00 到 2020-09-05 10:07:00 這段時間
Duration duration = Duration.between(from, to);
long days = duration.toDays(); // 這段時間的總天數
long hours = duration.toHours(); // 這段時間的小時數
long minutes = duration.toMinutes(); // 這段時間的分鐘數
long seconds = duration.getSeconds(); // 這段時間的秒數
long milliSeconds = duration.toMillis(); // 這段時間的毫秒數
long nanoSeconds = duration.toNanos(); // 這段時間的納秒數
LOG.info("時間為:" + duration );
}
斷點單元測試執行如下
Period在概念上與Duration類似,區別在於Period是以年月日來衡量一個時間段,比如1年3個月6天(程式碼清單 5-1)。
Period物件可以通過構造方法與between()方法建立,值得注意的是,由於Period是以年月日衡量時間段,所以between()方法只能接收LocalDate型別的引數。
//程式碼清單 5-1
@Test
void test9() {
//1年3個月6天
Period period = Period.of(1, 3, 6);
// 2017-01-05 到 2017-02-05 這段時間
Period period2 = Period.between(
LocalDate.of(2020, 1, 5),
LocalDate.of(2020, 2, 5));
LOG.info("時間為:" + period );
}
斷點單元測試執行如下
//程式碼清單 6-1
@Test
void test10() {
//使用當前的時間
LocalDate localDate = LocalDate.now();
LocalDate date4 = localDate.plusYears(1); // 增加一年 2021-09-24
LocalDate date5 = localDate.minusMonths(2); // 減少兩個月 2021-07-24
LocalDate date6 = localDate.plus(5, ChronoUnit.DAYS); // 增加5天 2021-09-29
LOG.info("時間為:" + date6 );
}
斷點單元測試執行如下
新的日期API中提供了一個 DateTimeFormatter 類(在上述也有使用到)用於處理日期格式化操作,它被包含在java.time.format包中,Java 8的日期類有一個format()方法用於將日期格式化為字串,該方法接收處理一個DateTimeFormatter型別引數
//程式碼清單 7-1
@Test
void test11() {
//使用當前的時間
LocalDateTime dateTime = LocalDateTime.now();
String strDate1 = dateTime.format(DateTimeFormatter.BASIC_ISO_DATE); // 20200924
String strDate2 = dateTime.format(DateTimeFormatter.ISO_LOCAL_DATE); // 2020-09-24
String strDate3 = dateTime.format(DateTimeFormatter.ISO_LOCAL_TIME); // 08:23:31.463
String strDate4 = dateTime.format(DateTimeFormatter.ofPattern("yyyy-MM-dd")); // 2020-09-24
LOG.info("時間為:" + dateTime );
}
斷點單元測試執行如下
將現有的日期字串解析為 LocalDateTime 、LocalDate、LocalTime 如下程式碼清單7-2所示。
解析的核心思路為 先定義 格式對映 DateTimeFormatter,然後再呼叫對應的parse方法
//程式碼清單 7-2
@Test
void test12() {
String strDate = "2020-09-24";
String strDate2 = "2020-09-24 08:23:31";
LocalDate date = LocalDate.parse(strDate, DateTimeFormatter.ofPattern("yyyy-MM-dd"));
LocalTime time = LocalTime.parse(strDate, DateTimeFormatter.ofPattern(" HH:mm:ss"));
//定義 formatter
DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
//解析操作
LocalDateTime dateTime = LocalDateTime.parse(strDate2, dateTimeFormatter);
LOG.info("時間為:" + dateTime );
}
斷點單元測試執行如下
當然也有公眾號了,感興的夥伴可以關注關注