diff --git a/src/main/java/com/xkzhangsan/time/calculator/DateTimeCalculatorUtil.java b/src/main/java/com/xkzhangsan/time/calculator/DateTimeCalculatorUtil.java
index 9255afe..db6511e 100644
--- a/src/main/java/com/xkzhangsan/time/calculator/DateTimeCalculatorUtil.java
+++ b/src/main/java/com/xkzhangsan/time/calculator/DateTimeCalculatorUtil.java
@@ -75,7 +75,7 @@
* 25.中国工作日计算（将放假信息包含在内），包括判断当前日期是否为工作日和下一个工作日等方法， isChineseWorkDay*，nextChineseWorkDay*，比如isChineseWorkDay(Date, String holidayData)，nextChineseWorkDay(Date date, String holidayData)
* 节假日数据holidayData，如果节假日数据不支持年份，将使用周一到周五为工作日来判断
* 26.判断2个或多个时间段是否有重叠（交集）方法， isOverlap*，比如isOverlap(Date startDate1, Date endDate1, Date startDate2, Date endDate2)，重叠返回true。
- * 27.计算平均时间方法，averageTime*，比如averageTime(List dateList)，返回平均时间，比如"15:03:03"。
+ * 27.计算平均时间方法，averageTime*，比如{@code averageTime(List dateList)}，返回平均时间，比如"15:03:03"。
* 28.根据毫秒值计算倒计时方法，countdown*，比如countdown(long millis),返回倒计时，比如"27小时10分钟30秒"。
*
* @author xkzhangsan
@@ -4082,7 +4082,7 @@ public static LocalTime averageTime(List dateList) {
/**
* 根据毫秒值计算倒计时
* @param millis 相差毫秒值
- * @return 返回倒计时，millis <= 0 返回：0小时0分钟0秒
+ * @return 返回倒计时，millis 小于等于0 返回：0小时0分钟0秒
*/
public static String countdown(long millis){
if (millis <= 0) {
@@ -4102,7 +4102,7 @@ public static String countdown(long millis){
/**
* 根据毫秒值计算倒计时，包含天数
* @param millis 相差毫秒值
- * @return 返回倒计时，millis <= 0 返回：0天0小时0分钟0秒
+ * @return 返回倒计时，millis 小于等于0 返回：0天0小时0分钟0秒
*/
public static String countdownWithDay(long millis){
if (millis <= 0) {
diff --git a/src/main/java/com/xkzhangsan/time/converter/DateTimeConverterUtil.java b/src/main/java/com/xkzhangsan/time/converter/DateTimeConverterUtil.java
index 271ef58..27fec36 100644
--- a/src/main/java/com/xkzhangsan/time/converter/DateTimeConverterUtil.java
+++ b/src/main/java/com/xkzhangsan/time/converter/DateTimeConverterUtil.java
@@ -742,7 +742,7 @@ public static BigDecimal unitConversionPrecise(long sourceDuration, TimeUnit sou
/**
* 单位转换，天转小时
- * @param num
+ * @param num 待转换值
* @return 小时数
*/
public static long dayToHour(long num){
@@ -751,7 +751,7 @@ public static long dayToHour(long num){
/**
* 单位转换，天转分钟
- * @param num
+ * @param num 待转换值
* @return 分钟数
*/
public static long dayToMinute(long num){
@@ -760,7 +760,7 @@ public static long dayToMinute(long num){
/**
* 单位转换，天转秒
- * @param num
+ * @param num 待转换值
* @return 秒数
*/
public static long dayToSecond(long num){
@@ -769,7 +769,7 @@ public static long dayToSecond(long num){
/**
* 单位转换，天转毫秒
- * @param num
+ * @param num 待转换值
* @return 毫秒数
*/
public static long dayToMillisecond(long num){
@@ -778,7 +778,7 @@ public static long dayToMillisecond(long num){
/**
* 单位转换，小时转分钟
- * @param num
+ * @param num 待转换值
* @return 分钟数
*/
public static long hourToMinute(long num){
@@ -787,7 +787,7 @@ public static long hourToMinute(long num){
/**
* 单位转换，小时转秒
- * @param num
+ * @param num 待转换值
* @return 秒数
*/
public static long hourToSecond(long num){
@@ -796,7 +796,7 @@ public static long hourToSecond(long num){
/**
* 单位转换，小时转毫秒
- * @param num
+ * @param num 待转换值
* @return 毫秒数
*/
public static long hourToMillisecond(long num){
@@ -805,7 +805,7 @@ public static long hourToMillisecond(long num){
/**
* 单位转换，小时转天
- * @param num
+ * @param num 待转换值
* @return 天数
*/
public static long hourToDay(long num){
@@ -814,7 +814,7 @@ public static long hourToDay(long num){
/**
* 小时转天，精确计算，保留1位小数，ROUND_DOWN 舍去多余小数
- * @param num
+ * @param num 待转换值
* @return 天数，保留1位小数，ROUND_DOWN 舍去多余小数
*/
public static BigDecimal hourToDayPrecise(long num){
@@ -823,7 +823,7 @@ public static BigDecimal hourToDayPrecise(long num){
/**
* 单位转换，分钟转秒
- * @param num
+ * @param num 待转换值
* @return 秒数
*/
public static long minuteToSecond(long num){
@@ -832,7 +832,7 @@ public static long minuteToSecond(long num){
/**
* 单位转换，分钟转毫秒
- * @param num
+ * @param num 待转换值
* @return 毫秒数
*/
public static long minuteToMillisecond(long num){
@@ -841,7 +841,7 @@ public static long minuteToMillisecond(long num){
/**
* 单位转换，分钟转小时
- * @param num
+ * @param num 待转换值
* @return 小时数
*/
public static long minuteToHour(long num){
@@ -850,7 +850,7 @@ public static long minuteToHour(long num){
/**
* 分钟转小时，精确计算，保留1位小数，ROUND_DOWN 舍去多余小数
- * @param num
+ * @param num 待转换值
* @return 小时数，保留1位小数，ROUND_DOWN 舍去多余小数
*/
public static BigDecimal minuteToHourPrecise(long num){
@@ -859,7 +859,7 @@ public static BigDecimal minuteToHourPrecise(long num){
/**
* 单位转换，分钟转天
- * @param num
+ * @param num 待转换值
* @return 天数
*/
public static long minuteToDay(long num){
@@ -868,7 +868,7 @@ public static long minuteToDay(long num){
/**
* 分钟转天，精确计算，保留1位小数，ROUND_DOWN 舍去多余小数
- * @param num
+ * @param num 待转换值
* @return 天数，保留1位小数，ROUND_DOWN 舍去多余小数
*/
public static BigDecimal minuteToDayPrecise(long num){
@@ -877,7 +877,7 @@ public static BigDecimal minuteToDayPrecise(long num){
/**
* 单位转换，秒转毫秒
- * @param num
+ * @param num 待转换值
* @return 毫秒数
*/
public static long secondToMillisecond(long num){
@@ -886,7 +886,7 @@ public static long secondToMillisecond(long num){
/**
* 单位转换，秒转分钟
- * @param num
+ * @param num 待转换值
* @return 分钟数
*/
public static long secondToMinute(long num){
@@ -895,7 +895,7 @@ public static long secondToMinute(long num){
/**
* 秒转分钟，精确计算，保留1位小数，ROUND_DOWN 舍去多余小数
- * @param num
+ * @param num 待转换值
* @return 分钟数，保留1位小数，ROUND_DOWN 舍去多余小数
*/
public static BigDecimal secondToMinutePrecise(long num){
@@ -904,7 +904,7 @@ public static BigDecimal secondToMinutePrecise(long num){
/**
* 单位转换，秒转小时
- * @param num
+ * @param num 待转换值
* @return 小时数
*/
public static long secondToHour(long num){
@@ -913,7 +913,7 @@ public static long secondToHour(long num){
/**
* 秒转小时，精确计算，保留1位小数，ROUND_DOWN 舍去多余小数
- * @param num
+ * @param num 待转换值
* @return 小时数，保留1位小数，ROUND_DOWN 舍去多余小数
*/
public static BigDecimal secondToHourPrecise(long num){
@@ -922,7 +922,7 @@ public static BigDecimal secondToHourPrecise(long num){
/**
* 单位转换，秒转天
- * @param num
+ * @param num 待转换值
* @return 天数
*/
public static long secondToDay(long num){
@@ -931,7 +931,7 @@ public static long secondToDay(long num){
/**
* 秒转天，精确计算，保留1位小数，ROUND_DOWN 舍去多余小数
- * @param num
+ * @param num 待转换值
* @return 天数，保留1位小数，ROUND_DOWN 舍去多余小数
*/
public static BigDecimal secondToDayPrecise(long num){
@@ -940,7 +940,7 @@ public static BigDecimal secondToDayPrecise(long num){
/**
* 单位转换，毫秒转秒
- * @param num
+ * @param num 待转换值
* @return 秒数
*/
public static long millisecondToSecond(long num){
@@ -949,7 +949,7 @@ public static long millisecondToSecond(long num){
/**
* 毫秒转秒，精确计算，保留1位小数，ROUND_DOWN 舍去多余小数
- * @param num
+ * @param num 待转换值
* @return 秒数，保留1位小数，ROUND_DOWN 舍去多余小数
*/
public static BigDecimal millisecondToSecondPrecise(long num){
@@ -958,7 +958,7 @@ public static BigDecimal millisecondToSecondPrecise(long num){
/**
* 毫秒转秒，精确计算，保留3位小数，ROUND_DOWN 舍去多余小数
- * @param num
+ * @param num 待转换值
* @return 秒数，保留3位小数，ROUND_DOWN 舍去多余小数
*/
public static BigDecimal millisecondToSecondPreciseThree(long num){
@@ -967,7 +967,7 @@ public static BigDecimal millisecondToSecondPreciseThree(long num){
/**
* 单位转换，毫秒转分钟
- * @param num
+ * @param num 待转换值
* @return 分钟数
*/
public static long millisecondToMinute(long num){
@@ -976,7 +976,7 @@ public static long millisecondToMinute(long num){
/**
* 毫秒转分钟，精确计算，保留1位小数，ROUND_DOWN 舍去多余小数
- * @param num
+ * @param num 待转换值
* @return 分钟数，保留1位小数，ROUND_DOWN 舍去多余小数
*/
public static BigDecimal millisecondToMinutePrecise(long num){
@@ -985,7 +985,7 @@ public static BigDecimal millisecondToMinutePrecise(long num){
/**
* 单位转换，毫秒转小时
- * @param num
+ * @param num 待转换值
* @return 小时数
*/
public static long millisecondToHour(long num){
@@ -994,7 +994,7 @@ public static long millisecondToHour(long num){
/**
* 毫秒转小时，精确计算，保留1位小数，ROUND_DOWN 舍去多余小数
- * @param num
+ * @param num 待转换值
* @return 小时数，保留1位小数，ROUND_DOWN 舍去多余小数
*/
public static BigDecimal millisecondToHourPrecise(long num){
@@ -1003,7 +1003,7 @@ public static BigDecimal millisecondToHourPrecise(long num){
/**
* 单位转换，毫秒转天
- * @param num
+ * @param num 待转换值
* @return 天数
*/
public static long millisecondToDay(long num){
@@ -1012,7 +1012,7 @@ public static long millisecondToDay(long num){
/**
* 毫秒转天，精确计算，保留1位小数，ROUND_DOWN 舍去多余小数
- * @param num
+ * @param num 待转换值
* @return 天数，保留1位小数，ROUND_DOWN 舍去多余小数
*/
public static BigDecimal millisecondToDayPrecise(long num){
diff --git a/src/main/java/com/xkzhangsan/time/nlp/TimeNLPUtil.java b/src/main/java/com/xkzhangsan/time/nlp/TimeNLPUtil.java
index 7b78ef1..c4f2478 100644
--- a/src/main/java/com/xkzhangsan/time/nlp/TimeNLPUtil.java
+++ b/src/main/java/com/xkzhangsan/time/nlp/TimeNLPUtil.java
@@ -60,9 +60,9 @@ public static List parse(String text){
* @param text
* 待分析文本
* @return 结果列表
- * @throws InterruptedException
- * @throws ExecutionException
- * @throws TimeoutException
+ * @throws InterruptedException 被中止异常
+ * @throws ExecutionException 执行异常
+ * @throws TimeoutException 超时异常
*/
public static List parseConcurrent(String text)
throws InterruptedException, ExecutionException, TimeoutException {
@@ -71,13 +71,13 @@ public static List parseConcurrent(String text)
/**
* 时间自然语言分析，使用线程池并发执行，默认3秒超时
- *
+ *
* @param text
* 待分析文本
* @return 结果列表
- * @throws InterruptedException
- * @throws ExecutionException
- * @throws TimeoutException
+ * @throws InterruptedException 被中止异常
+ * @throws ExecutionException 执行异常
+ * @throws TimeoutException 超时异常
*/
public static List parseConcurrentDefaultTime(String text)
throws InterruptedException, ExecutionException, TimeoutException {
@@ -86,7 +86,7 @@ public static List parseConcurrentDefaultTime(String text)
/**
* 时间自然语言分析，使用线程池并发执行，设置超时时间和单位
- *
+ *
* @param text
* 待分析文本
* @param timeout
@@ -94,9 +94,9 @@ public static List parseConcurrentDefaultTime(String text)
* @param unit
* 超时时间单位
* @return 结果列表
- * @throws InterruptedException
- * @throws ExecutionException
- * @throws TimeoutException
+ * @throws InterruptedException 被中止异常
+ * @throws ExecutionException 执行异常
+ * @throws TimeoutException 超时异常
*/
public static List parseConcurrent(String text, long timeout, TimeUnit unit)
throws InterruptedException, ExecutionException, TimeoutException {
@@ -105,7 +105,7 @@ public static List parseConcurrent(String text, long timeout, TimeUnit
/**
* 时间自然语言分析，使用线程池并发执行，设置超时时间和单位，使用自定义线程池
- *
+ *
* @param text
* 待分析文本
* @param timeout
@@ -115,18 +115,18 @@ public static List parseConcurrent(String text, long timeout, TimeUnit
* @param executorService
* 自定义线程池
* @return 结果列表
- * @throws InterruptedException
- * @throws ExecutionException
- * @throws TimeoutException
+ * @throws InterruptedException 被中止异常
+ * @throws ExecutionException 执行异常
+ * @throws TimeoutException 超时异常
*/
public static List parseConcurrent(String text, long timeout, TimeUnit unit,
ExecutorService executorService) throws InterruptedException, ExecutionException, TimeoutException {
return parse(text, null, timeout, unit, executorService);
}
-
+
/**
* 时间自然语言分析
- * @param text 待分析文本
+ * @param text 待分析文本
* @param timeBase 指定时间
* @return 结果列表
*/
@@ -139,13 +139,13 @@ public static List parse(String text, String timeBase){
if(StringUtil.isEmpty(text)){
return null;
}
-
+
//时间名词匹配分析
List timeStrs = TextAnalysis.getInstance().analysis(text);
if(CollectionUtil.isEmpty(timeStrs)){
return null;
}
-
+
//解析
List timeNLPList = new ArrayList<>(timeStrs.size());
/**时间上下文： 前一个识别出来的时间会是下一个时间的上下文，用于处理：周六3点到5点这样的多个时间的识别，第二个5点应识别到是周六的。*/
@@ -164,15 +164,15 @@ public static List parse(String text, String timeBase){
timeNLPList.add(timeNLP);
timeContext = timeNLP.getTimeContext();
}
-
+
/**过滤无法识别的字段*/
List timeNLPListResult = TimeNLP.filterTimeUnit(timeNLPList);
return timeNLPListResult;
- }
-
+ }
+
/**
* 时间自然语言分析，使用线程池并发执行
- *
+ *
* @param text
* 待分析文本
* @param timeBase
@@ -184,9 +184,9 @@ public static List parse(String text, String timeBase){
* @param executorService
* 自定义线程池
* @return 结果列表
- * @throws InterruptedException
- * @throws ExecutionException
- * @throws TimeoutException
+ * @throws InterruptedException 被中止异常
+ * @throws ExecutionException 执行异常
+ * @throws TimeoutException 超时异常
*/
public static List parse(String text, String timeBase, long timeout, TimeUnit unit,
ExecutorService executorService) throws InterruptedException, ExecutionException, TimeoutException {
diff --git a/src/main/java/com/xkzhangsan/time/utils/CommonCache.java b/src/main/java/com/xkzhangsan/time/utils/CommonCache.java
index ac27e08..e005838 100644
--- a/src/main/java/com/xkzhangsan/time/utils/CommonCache.java
+++ b/src/main/java/com/xkzhangsan/time/utils/CommonCache.java
@@ -39,8 +39,7 @@ public static Object get(String key) {
/**
* 先从缓存中查找，没有编译后放入缓存
*
- * @param rule
- * key 键
+ * @param key 键
* @param supplier
* 提供者
* @return Object
@@ -52,8 +51,7 @@ public static Object get(String key, Supplier