Add TimeKit

src/main/java/com/jfinal/kit/TimeKit.java

@@ -0,0 +1,208 @@
+package com.jfinal.kit;
+
+import java.text.ParseException;
+import java.time.Instant;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.time.ZoneId;
+import java.time.chrono.ChronoLocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.Date;
+import java.util.Map;
+import com.jfinal.kit.SyncWriteMap;
+
+/**
+ * TimeKit 用于简化 JDK 8 新增的时间 API
+ * 
+ * 
+ * 经测试，SimpleDateFormat 比 DateTimeFormatter 对 pattern 的支持更好
+ * 对于同样的 pattern 值 "yyyy-MM-dd HH:mm:ss"，前者可以转换 "2020-06-9 12:13:19"
+ * 后者却不支持，原因是 pattern 的 dd 位置只有数字 9，必须要是两位数字才能支持
+ * 
+ * 
+ * 所以：建议优先使用转换结果为 Date 的 parse 方法，使用 SimpleDateFormat 来转换
+ */
+public class TimeKit {
+	
+	private static final Map<String, DateTimeFormatter> formaters = new SyncWriteMap<>();
+	
+	/**
+	 * 缓存共享线程安全的 DateTimeFormatter
+	 * 不能缓存 "非线程安全" 的 SimpleDateFormat，除非配合 ThreadLocal 来缓存
+	 */
+	public static DateTimeFormatter getFormatter(String pattern) {
+		DateTimeFormatter ret = formaters.get(pattern);
+		if (ret == null) {
+			ret = DateTimeFormatter.ofPattern(pattern);
+			formaters.put(pattern, ret);
+		}
+		return ret;
+	}
+	
+	/**
+	 * 按指定 pattern 将当前时间转换成 String
+	 * 例如：now("yyyy-MM-dd HH:mm:ss")
+	 */
+	public static String now(String pattern) {
+		return LocalDateTime.now().format(getFormatter(pattern));
+	}
+	
+	/**
+	 * LocalDateTime 按指定 pattern 转换成 String
+	 * 例如：format(LocalDateTime.now(), "yyyy-MM-dd HH:mm:ss")
+	 */
+	public static String format(LocalDateTime localDateTime, String pattern) {
+		return localDateTime.format(getFormatter(pattern));
+	}
+	
+	/**
+	 * LocalDate 按指定 pattern 转换成 String
+	 */
+	public static String format(LocalDate localDate, String pattern) {
+		return localDate.format(getFormatter(pattern));
+	}
+	
+	/**
+	 * LocalTime 按指定 pattern 转换成 String
+	 */
+	public static String format(LocalTime localTime, String pattern) {
+		return localTime.format(getFormatter(pattern));
+	}
+	
+	/**
+	 * Date 按指定 pattern 转换成 String
+	 * 例如：format(new Date(), "yyyy-MM-dd HH:mm:ss")
+	 */
+	public static String format(Date date, String pattern) {
+		java.text.SimpleDateFormat df = new java.text.SimpleDateFormat(pattern);
+		return df.format(date);
+	}
+	
+	/**
+	 * 按指定 pattern 将 String 转换成 Date
+	 */
+	public static Date parse(String dateString, String pattern) {
+		try {
+			java.text.SimpleDateFormat df = new java.text.SimpleDateFormat(pattern);
+			return df.parse(dateString);
+		} catch (ParseException e) {
+			throw new RuntimeException(e);
+		}
+	}
+	
+	/**
+	 * 按指定 pattern 将 String 转换成 LocalDateTime
+	 */
+	public static LocalDateTime parseLocalDateTime(String localDateTimeString, String pattern) {
+		return LocalDateTime.parse(localDateTimeString, getFormatter(pattern));
+	}
+	
+	/**
+	 * 按指定 pattern 将 String 转换成 LocalDate
+	 */
+	public static LocalDate parseLocalDate(String localDateString, String pattern) {
+		return LocalDate.parse(localDateString, getFormatter(pattern));
+	}
+	
+	/**
+	 * 按指定 pattern 将 String 转换成 LocalTime
+	 */
+	public static LocalTime parseLocalTime(String localTimeString, String pattern) {
+		return LocalTime.parse(localTimeString, getFormatter(pattern));
+	}
+	
+	/**
+	 * 判断 A 的时间是否在 B 的时间 "之后"
+	 */
+	public static boolean isAfter(ChronoLocalDateTime<?> self, ChronoLocalDateTime<?> other) {
+		return self.isAfter(other);
+	}
+	
+	/**
+	 * 判断 A 的时间是否在 B 的时间 "之前"
+	 */
+	public static boolean isBefore(ChronoLocalDateTime<?> self, ChronoLocalDateTime<?> other) {
+		return self.isBefore(other);
+	}
+	
+	/**
+	 * 判断 A 的时间是否与 B 的时间 "相同"
+	 */
+	public static boolean isEqual(ChronoLocalDateTime<?> self, ChronoLocalDateTime<?> other) {
+		return self.isEqual(other);
+	}
+	
+	/**
+	 * java.util.Date --> java.time.LocalDateTime
+	 */
+	public static LocalDateTime toLocalDateTime(Date date) {
+		Instant instant = date.toInstant();
+		ZoneId zone = ZoneId.systemDefault();
+		return LocalDateTime.ofInstant(instant, zone);
+	}
+	
+	/**
+	 * java.util.Date --> java.time.LocalDate
+	 */
+	public static LocalDate toLocalDate(Date date) {
+		Instant instant = date.toInstant();
+		ZoneId zone = ZoneId.systemDefault();
+		LocalDateTime localDateTime = LocalDateTime.ofInstant(instant, zone);
+		return localDateTime.toLocalDate();
+	}
+	
+	/**
+	 * java.util.Date --> java.time.LocalTime
+	 */
+	public static LocalTime toLocalTime(Date date) {
+		Instant instant = date.toInstant();
+		ZoneId zone = ZoneId.systemDefault();
+		LocalDateTime localDateTime = LocalDateTime.ofInstant(instant, zone);
+		return localDateTime.toLocalTime();
+	}
+	
+	/**
+	 * java.time.LocalDateTime --> java.util.Date
+	 */
+	public static Date toDate(LocalDateTime localDateTime) {
+		ZoneId zone = ZoneId.systemDefault();
+		Instant instant = localDateTime.atZone(zone).toInstant();
+		return Date.from(instant);
+	}
+	
+	/**
+	 * java.time.LocalDate --> java.util.Date
+	 */
+	public static Date toDate(LocalDate localDate) {
+		ZoneId zone = ZoneId.systemDefault();
+		Instant instant = localDate.atStartOfDay().atZone(zone).toInstant();
+		return Date.from(instant);
+	}
+	
+	/**
+	 * java.time.LocalTime --> java.util.Date
+	 */
+	public static Date toDate(LocalTime localTime) {
+		LocalDate localDate = LocalDate.now();
+		LocalDateTime localDateTime = LocalDateTime.of(localDate, localTime);
+		ZoneId zone = ZoneId.systemDefault();
+		Instant instant = localDateTime.atZone(zone).toInstant();
+		return Date.from(instant);
+	}
+	
+	/**
+	 * java.time.LocalTime --> java.util.Date
+	 */
+	public static Date toDate(LocalDate localDate, LocalTime localTime) {
+		LocalDateTime localDateTime = LocalDateTime.of(localDate, localTime);
+		ZoneId zone = ZoneId.systemDefault();
+		Instant instant = localDateTime.atZone(zone).toInstant();
+		return Date.from(instant);
+	}
+}
+
+
+
+
+