Java 中的日期與時間

基礎知識

• 日期: 相似於 2018-12-12
• 時間: 相似於 2018-12-12 12:12:12
• 時刻: 相似於 2018-12-12 12:12:12
• 地區: 計算機中的 Locale, 如 zh_CN, en_US 等, 影響着對於日期, 時間, 貨幣等格式的顯示
• EpochTime: 從 1970 年 1 月 1 日 UTC+00:00 到如今的秒數(不是毫秒數), 大體可認爲與 TimeStamp 等價
• 時區: 全球共 24 個, 倫敦 (GMT+00:00) 的是標準時區
• GMT 與 UTC 大體能夠認爲是等價的, GMT 與 UTC 表示的時間不受夏令時影響, 而以地區(如 America/New_York)表示的時間受夏令時影響
• 日期在計算機中都存儲爲 EpochTime(即 TimeStamp), 因此全球的計算機都是相同的, 可是由於計算機地區等設置的不一樣, 因此顯示爲不一樣的時間

Date 與 Calendar

Date 的用法

// 獲取一個 Date 對象, 即表示如今的時刻
Date date = new Date();
// 獲取 TimeStamp
long timestamp = date.getTime();
// timestamp 生成 Date
date = new Date(timestamp);
// 轉換爲默認格式的字符串
String dateString = date.toString();
// 按照指定格式轉換
SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
dateString = simpleDateFormat.format(date);
// 按照指定格式字符串解析爲 Date
date = simpleDateFormat.parse(dateString);

Calendar 的用法

// 獲取一個 Calendar
Calendar calendar = Calendar.getInstance();
// 獲取今天是本月的第幾天
int day = calendar.get(Calendar.DAY_OF_MONTH);
// 設置爲指定時間
calendar.set(Calendar.DAY_OF_MONTH, 1);
// 轉換爲 Date
Date date = calendar.getTime();
// 轉換爲 timestamp
long timestamp = calendar.getTimeInMillis();

LocalDateTime, ZonedDateTime 與 Instant

LocalDateTime 的用法

// 獲取一個 LocalDateTime
LocalDateTime localDateTime = LocalDateTime.now();
// 獲取一個指定的 LocalDateTime, 須要注意月份從 1 開始而非 0, 因此 12 月用 12
localDateTime = LocalDateTime.of(2018, 12, 12, 21, 36, 36);
// LocalDateTime 格式化爲指定格式
DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
String localDateTimeString = dateTimeFormatter.format(localDateTime);
// 按照指定格式解析 LocalDateTime, 須要注意這裏 DateTimeFormatter 是做爲參數參入
localDateTime = LocalDateTime.parse(localDateTimeString, dateTimeFormatter);
// 減去一天, 須要注意該對象是不可變的
localDateTime = localDateTime.minusDays(1);
// 小時設置爲 12 點
localDateTime = localDateTime.withHour(12);
// 設置爲本月的第一天
localDateTime = localDateTime.withDayOfMonth(1);
// 設置爲本月的最後一天, 注意這裏是 TemporalAdjusters 而不是 TemporalAdjuster
localDateTime = localDateTime.with(TemporalAdjusters.lastDayOfMonth());
// 判斷兩個 LocalDateTime 的前後
boolean before = localDateTime.isBefore(LocalDateTime.now());
// 計算兩個 LocalDate 相差的天數
Period period = LocalDate.now().until(LocalDate.of(2019, 1, 1));
long days = period.getDays();
// 計算兩個 LocalDateTime 相差的天數, 可能爲負數
days  = localDateTime.until(LocalDateTime.now(), ChronoUnit.DAYS);
// 距離 EpochTime 的天數
days = LocalDate.now().toEpochDay();
// LocalDateTime 沒法與 timestamp 進行轉換, 由於它沒有時區的概念

ZonedDateTime 至關於 LocalDateTime 加上了一個 ZoneId
Instant 能夠理解爲 TimeStamp, 也就是說至關於一個 Long 的封裝類

// 從 LocalDateTime 獲取 ZonedDateTime
ZonedDateTime zonedDateTime = LocalDateTime.now().atZone(ZoneId.of("Asia/Shanghai"));
// 從 Instant 獲取 ZonedDateTime
zonedDateTime = Instant.now().atZone(ZoneId.systemDefault());
// 獲取指定的 Instant, 須要注意 System.currentTimeMillis() 返回的是毫秒, 而 TimeStamp 是秒
Instant instant = Instant.ofEpochSecond(System.currentTimeMillis() / 1000);
// TimeStamp 獲取 LocalDateTime
LocalDateTime localDateTime = LocalDateTime.ofEpochSecond(
        // 獲取當前的時間戳(timestamp)
        instant.getEpochSecond(),
        // 毫秒
        0,
        // 獲取系統的 ZoneOffset, 即時區偏移
        OffsetDateTime.now().getOffset());