|
|
@@ -1,37 +1,45 @@
|
|
|
package cn.hutool.core.date;
|
|
|
|
|
|
-import java.io.Serializable;
|
|
|
-
|
|
|
import cn.hutool.core.util.StrUtil;
|
|
|
|
|
|
+import java.io.Serializable;
|
|
|
+
|
|
|
/**
|
|
|
* 时长格式化器
|
|
|
- * @author Looly
|
|
|
*
|
|
|
+ * @author Looly
|
|
|
*/
|
|
|
-public class BetweenFormater implements Serializable{
|
|
|
+public class BetweenFormater implements Serializable {
|
|
|
private static final long serialVersionUID = 1L;
|
|
|
-
|
|
|
- /** 时长毫秒数 */
|
|
|
+
|
|
|
+ /**
|
|
|
+ * 时长毫秒数
|
|
|
+ */
|
|
|
private long betweenMs;
|
|
|
- /** 格式化级别 */
|
|
|
+ /**
|
|
|
+ * 格式化级别
|
|
|
+ */
|
|
|
private Level level;
|
|
|
- /** 格式化级别的最大个数 */
|
|
|
+ /**
|
|
|
+ * 格式化级别的最大个数
|
|
|
+ */
|
|
|
private final int levelMaxCount;
|
|
|
-
|
|
|
+
|
|
|
/**
|
|
|
* 构造
|
|
|
+ *
|
|
|
* @param betweenMs 日期间隔
|
|
|
- * @param level 级别,按照天、小时、分、秒、毫秒分为5个等级,根据传入等级,格式化到相应级别
|
|
|
+ * @param level 级别,按照天、小时、分、秒、毫秒分为5个等级,根据传入等级,格式化到相应级别
|
|
|
*/
|
|
|
public BetweenFormater(long betweenMs, Level level) {
|
|
|
this(betweenMs, level, 0);
|
|
|
}
|
|
|
-
|
|
|
+
|
|
|
/**
|
|
|
* 构造
|
|
|
- * @param betweenMs 日期间隔
|
|
|
- * @param level 级别,按照天、小时、分、秒、毫秒分为5个等级,根据传入等级,格式化到相应级别
|
|
|
+ *
|
|
|
+ * @param betweenMs 日期间隔
|
|
|
+ * @param level 级别,按照天、小时、分、秒、毫秒分为5个等级,根据传入等级,格式化到相应级别
|
|
|
* @param levelMaxCount 格式化级别的最大个数,假如级别个数为1,但是级别到秒,那只显示一个级别
|
|
|
*/
|
|
|
public BetweenFormater(long betweenMs, Level level, int levelMaxCount) {
|
|
|
@@ -39,15 +47,15 @@ public class BetweenFormater implements Serializable{
|
|
|
this.level = level;
|
|
|
this.levelMaxCount = levelMaxCount;
|
|
|
}
|
|
|
-
|
|
|
+
|
|
|
/**
|
|
|
* 格式化日期间隔输出<br>
|
|
|
- *
|
|
|
+ *
|
|
|
* @return 格式化后的字符串
|
|
|
*/
|
|
|
- public String format(){
|
|
|
+ public String format() {
|
|
|
final StringBuilder sb = new StringBuilder();
|
|
|
- if(betweenMs > 0){
|
|
|
+ if (betweenMs > 0) {
|
|
|
long day = betweenMs / DateUnit.DAY.getMillis();
|
|
|
long hour = betweenMs / DateUnit.HOUR.getMillis() - day * 24;
|
|
|
long minute = betweenMs / DateUnit.MINUTE.getMillis() - day * 24 * 60 - hour * 60;
|
|
|
@@ -55,41 +63,42 @@ public class BetweenFormater implements Serializable{
|
|
|
final long BetweenOfSecond = ((day * 24 + hour) * 60 + minute) * 60;
|
|
|
long second = betweenMs / DateUnit.SECOND.getMillis() - BetweenOfSecond;
|
|
|
long millisecond = betweenMs - (BetweenOfSecond + second) * 1000;
|
|
|
-
|
|
|
+
|
|
|
final int level = this.level.ordinal();
|
|
|
int levelCount = 0;
|
|
|
-
|
|
|
- if(isLevelCountValid(levelCount) && 0 != day && level >= Level.DAY.ordinal()){
|
|
|
+
|
|
|
+ if (isLevelCountValid(levelCount) && 0 != day && level >= Level.DAY.ordinal()) {
|
|
|
sb.append(day).append(Level.DAY.name);
|
|
|
levelCount++;
|
|
|
}
|
|
|
- if(isLevelCountValid(levelCount) && 0 != hour && level >= Level.HOUR.ordinal()){
|
|
|
+ if (isLevelCountValid(levelCount) && 0 != hour && level >= Level.HOUR.ordinal()) {
|
|
|
sb.append(hour).append(Level.HOUR.name);
|
|
|
levelCount++;
|
|
|
}
|
|
|
- if(isLevelCountValid(levelCount) && 0 != minute && level >= Level.MINUTE.ordinal()){
|
|
|
+ if (isLevelCountValid(levelCount) && 0 != minute && level >= Level.MINUTE.ordinal()) {
|
|
|
sb.append(minute).append(Level.MINUTE.name);
|
|
|
levelCount++;
|
|
|
}
|
|
|
- if(isLevelCountValid(levelCount) && 0 != second && level >= Level.SECOND.ordinal()){
|
|
|
+ if (isLevelCountValid(levelCount) && 0 != second && level >= Level.SECOND.ordinal()) {
|
|
|
sb.append(second).append(Level.SECOND.name);
|
|
|
levelCount++;
|
|
|
}
|
|
|
- if(isLevelCountValid(levelCount) && 0 != millisecond && level >= Level.MILLSECOND.ordinal()){
|
|
|
- sb.append(millisecond).append(Level.MILLSECOND.name);
|
|
|
+ if (isLevelCountValid(levelCount) && 0 != millisecond && level >= Level.MILLISECOND.ordinal()) {
|
|
|
+ sb.append(millisecond).append(Level.MILLISECOND.name);
|
|
|
// levelCount++;
|
|
|
}
|
|
|
}
|
|
|
-
|
|
|
- if(StrUtil.isEmpty(sb)) {
|
|
|
+
|
|
|
+ if (StrUtil.isEmpty(sb)) {
|
|
|
sb.append(0).append(this.level.name);
|
|
|
}
|
|
|
-
|
|
|
+
|
|
|
return sb.toString();
|
|
|
}
|
|
|
-
|
|
|
+
|
|
|
/**
|
|
|
* 获得 时长毫秒数
|
|
|
+ *
|
|
|
* @return 时长毫秒数
|
|
|
*/
|
|
|
public long getBetweenMs() {
|
|
|
@@ -98,6 +107,7 @@ public class BetweenFormater implements Serializable{
|
|
|
|
|
|
/**
|
|
|
* 设置 时长毫秒数
|
|
|
+ *
|
|
|
* @param betweenMs 时长毫秒数
|
|
|
*/
|
|
|
public void setBetweenMs(long betweenMs) {
|
|
|
@@ -106,6 +116,7 @@ public class BetweenFormater implements Serializable{
|
|
|
|
|
|
/**
|
|
|
* 获得 格式化级别
|
|
|
+ *
|
|
|
* @return 格式化级别
|
|
|
*/
|
|
|
public Level getLevel() {
|
|
|
@@ -114,35 +125,55 @@ public class BetweenFormater implements Serializable{
|
|
|
|
|
|
/**
|
|
|
* 设置格式化级别
|
|
|
+ *
|
|
|
* @param level 格式化级别
|
|
|
*/
|
|
|
public void setLevel(Level level) {
|
|
|
this.level = level;
|
|
|
}
|
|
|
-
|
|
|
+
|
|
|
/**
|
|
|
* 格式化等级枚举
|
|
|
- *
|
|
|
+ *
|
|
|
* @author Looly
|
|
|
*/
|
|
|
public enum Level {
|
|
|
|
|
|
- /** 天 */
|
|
|
+ /**
|
|
|
+ * 天
|
|
|
+ */
|
|
|
DAY("天"),
|
|
|
- /** 小时 */
|
|
|
+ /**
|
|
|
+ * 小时
|
|
|
+ */
|
|
|
HOUR("小时"),
|
|
|
- /** 分钟 */
|
|
|
+ /**
|
|
|
+ * 分钟
|
|
|
+ */
|
|
|
MINUTE("分"),
|
|
|
- /** 秒 */
|
|
|
+ /**
|
|
|
+ * 秒
|
|
|
+ */
|
|
|
SECOND("秒"),
|
|
|
- /** 毫秒 */
|
|
|
- MILLSECOND("毫秒");
|
|
|
+ /**
|
|
|
+ * 毫秒
|
|
|
+ * @deprecated 拼写错误,请使用{@link #MILLISECOND}
|
|
|
+ */
|
|
|
+ @Deprecated
|
|
|
+ MILLSECOND("毫秒"),
|
|
|
+ /**
|
|
|
+ * 毫秒
|
|
|
+ */
|
|
|
+ MILLISECOND("毫秒");
|
|
|
|
|
|
- /** 级别名称 */
|
|
|
+ /**
|
|
|
+ * 级别名称
|
|
|
+ */
|
|
|
private final String name;
|
|
|
|
|
|
/**
|
|
|
* 构造
|
|
|
+ *
|
|
|
* @param name 级别名称
|
|
|
*/
|
|
|
Level(String name) {
|
|
|
@@ -151,26 +182,27 @@ public class BetweenFormater implements Serializable{
|
|
|
|
|
|
/**
|
|
|
* 获取级别名称
|
|
|
+ *
|
|
|
* @return 级别名称
|
|
|
*/
|
|
|
public String getName() {
|
|
|
return this.name;
|
|
|
}
|
|
|
}
|
|
|
-
|
|
|
+
|
|
|
@Override
|
|
|
public String toString() {
|
|
|
return format();
|
|
|
}
|
|
|
-
|
|
|
+
|
|
|
/**
|
|
|
* 等级数量是否有效<br>
|
|
|
* 有效的定义是:levelMaxCount大于0(被设置),当前等级数量没有超过这个最大值
|
|
|
- *
|
|
|
+ *
|
|
|
* @param levelCount 登记数量
|
|
|
* @return 是否有效
|
|
|
*/
|
|
|
- private boolean isLevelCountValid(int levelCount){
|
|
|
+ private boolean isLevelCountValid(int levelCount) {
|
|
|
return this.levelMaxCount <= 0 || levelCount < this.levelMaxCount;
|
|
|
}
|
|
|
}
|