From 7faf0d09d6352d1d17845c1d1760f61150693f85 Mon Sep 17 00:00:00 2001 From: xkzhangsan Date: Sun, 18 Jul 2021 01:30:39 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=B3=A8=E9=87=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../calculator/DateTimeCalculatorUtil.java | 6 +- .../time/converter/DateTimeConverterUtil.java | 62 +++++++++---------- .../com/xkzhangsan/time/nlp/TimeNLPUtil.java | 52 ++++++++-------- .../xkzhangsan/time/utils/CommonCache.java | 6 +- 4 files changed, 62 insertions(+), 64 deletions(-) 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 supplier) { /** * 删除缓存 * - * @param rule - * 键 + * @param key 键 * @return 移除的值 */ public static Object remove(String key) {