使用背景:
- 项目中, 许多地方使用到日期的转换, 这个类可以满足你的需求.
- 项目中,因实现的日期工具不规范,导致使用不规范,不好统一处理,于是自己封装了一个实现.
日期工具类实现:
maven依赖:
<dependency>
<groupId>joda-time</groupId>
<artifactId>joda-time</artifactId>
<version>2.9.9</version>
</dependency>
代码实现:
import org.joda.time.DateTime;
import org.joda.time.format.DateTimeFormat;
import org.joda.time.format.DateTimeFormatter;
/**
* 功能点:
* 基本功能:获取当前时间
* 一.日期的格式转换
* 1.日期对象转字符串
* 2.日期对象转时间戳
* 3.时间戳转日期对象
* 4.时间戳转字符串
* 二.日期的加减
* 1.当前日期加减N天
* 2.当前日期加减N周
* 3.当前日期加减N月
* 4.当前日期加减N年
* 三.日期坐标转换
* 1.指定日期是本周的周几
* 2.指定日期是本年的第几周
* 四.日期单位的特殊点
* 1.根据日期,获取当前的起止时间戳
* 2.根据日期,获取本周的第一天的0点时间戳
* 3.根据日期,获取本周的最后一天的23:59:59的时间戳
* 4.根据日期,获取本月的第一天的0点时间戳
* 5.根据日期,获取本月的最后一天的23:59:59的时间戳
* 6.根据日期,获取本年的第一天的0点时间戳
* 7.根据日期,获取本年的最后一天的23:59:59的时间戳
* 五.日期大小的比较
* 1.两个日期,比较返回大小
* 2.两个日期,比较返回差额,判断是否满足某一个阈值
* 六.日期截断
* 1.获取指定日期的天的毫秒数
* 2.获取指定日期的小时的毫秒数
* 3.获取指定日期的分的毫秒数
* 4.获取指定日期的秒的毫秒数
* 七.获取时间段
* 1.获取起止日期之间的所有日期列表
* 2.获取起止日期之间的所有周列表
* 3.获取起止日期之间的所有月列表
*
* @author : Bruce 下午11:35 2018/03/19
*/
public class DateUtils {
/**
* 日期格式枚举类
*/
public enum Parttern {
/**replace with {@link Parttern#FORMAT_YYMM_MID}*/
@Deprecated
FORMAT_YYMM("yyyy-MM"),
/**replace with {@link Parttern#FORMAT_YYWW_MID}*/
@Deprecated
FORMAT_YYWW("yyyy-ww"),
/**replace with {@link Parttern#FORMAT_YYMMDD_MID}*/
@Deprecated
FORMAT_YYMMDD("yyyy-MM-dd"),
/**replace with {@link Parttern#FORMAT_YYMMDDHM_MID}*/
@Deprecated
FORMAT_YYMMDDHM("yyyy-MM-dd HH:mm"),
/**replace with {@link Parttern#FORMAT_YYMMDDHMS_MID}*/
@Deprecated
FORMAT_YYMMDDHMS("yyyy-MM-dd HH:mm:ss"),
/**replace with {@link Parttern#FORMAT_YYMMDDHMSS_MID}*/
@Deprecated
FORMAT_YYMMDDHMSS("yyyy-MM-dd HH:mm:ss SSS"),
/**replace with {@link Parttern#FORMAT_YYMMDDHM_SLASH}*/
@Deprecated
FORMAT_YYMMDDHM_GAP_SLASH("yyyy/MM/dd HH:mm"),
/**replace with {@link Parttern#FORMAT_YYMMDD_NON}*/
@Deprecated
FORMAT_YYMMDD2("yyyyMMdd"),
/**replace with {@link Parttern#FORMAT_YYMMDDHMS_NON}*/
@Deprecated
FORMAT_YYMMDDHMS_NO_GAP("yyyyMMddHHmmss"),
/**中杠分隔符**/
FORMAT_YYMM_MID("yyyy-MM"),
FORMAT_YYWW_MID("yyyy-ww"),
FORMAT_YYMMDD_MID("yyyy-MM-dd"),
FORMAT_YYMMDDH_MID("yyyy-MM-dd HH"),
FORMAT_YYMMDDHM_MID("yyyy-MM-dd HH:mm"),
FORMAT_YYMMDDHMS_MID("yyyy-MM-dd HH:mm:ss"),
FORMAT_YYMMDDHMSS_MID("yyyy-MM-dd HH:mm:ss SSS"),
/**无隔符**/
FORMAT_YYMM_NON("yyyyMM"),
FORMAT_YYWW_NON("yyyyww"),
FORMAT_YYMMDD_NON("yyyyMMdd"),
FORMAT_YYMMDDH_NON("yyyyMMddHH"),
FORMAT_YYMMDDHM_NON("yyyyMMddHHmm"),
FORMAT_YYMMDDHMS_NON("yyyyMMddHHmmss"),
FORMAT_YYMMDDHMSS_NON("yyyyMMddHHmmssSSS"),
/**斜杠分隔符**/
FORMAT_YYMM_SLASH("yy/yy/MM"),
FORMAT_YYWW_SLASH("yyyy/ww"),
FORMAT_YYMMDD_SLASH("yyyy/MM/dd"),
FORMAT_YYMMDDH_SLASH("yyyy/MM/dd HH"),
FORMAT_YYMMDDHM_SLASH("yyyy/MM/dd HH:mm"),
FORMAT_YYMMDDHMS_SLASH("yyyy/MM/dd HH:mm:ss"),
FORMAT_YYMMDDHMSS_SLASH("yyyy/MM/dd HH:mm:ss:SSS"),
;
private String fmt;
Parttern(String fmt) {
this.fmt = fmt;
}
public String getFmt() {
return fmt;
}
}
/**新建时间对象**/
public static DateTime create(){
return DateTime.now();
}
/**注意:timestamp为13位,否则新建出来的日期是1970年1月18号**/
public static DateTime create(long timestamp){
return new DateTime(timestamp);
}
/**
* 基本功能:获取当前时间
* 一.日期的格式转换
* 1.日期对象转字符串 {@link #format(DateTime)}
* 2.日期对象转时间戳 {@link #create().getMillis() }
* 3.时间戳转日期对象 {@link #create(long timestamp) }
* 4.时间戳转字符串 {@link #create(long timestamp)} --> {@link #format(DateTime)}
*/
/**默认日期转换格式:yyyy-MM-dd HH:mm:ss**/
public static String format(DateTime dateTime){
return format(dateTime,Parttern.FORMAT_YYMMDDHMS_MID);
}
public static String format(DateTime dateTime,Parttern fmt){
return dateTime.toString(getFormatter(fmt));
}
public static String format(DateTime dateTime,String format){
return dateTime.toString(getFormatter(format));
}
public static DateTime parse(String date){
return parse(date,Parttern.FORMAT_YYMMDDHMS_MID);
}
/**转换日期**/
public static DateTime parse(String date,Parttern fmt){
return getFormatter(fmt).parseDateTime(date);
}
/**转换日期**/
public static DateTime parse(String date,String format){
return getFormatter(format).parseDateTime(date);
}
/**
* 二.秒的加减
* 0.当前日期加减N秒
*/
public static DateTime addSeconds(DateTime dateTime,int seconds){
return dateTime.plusSeconds(seconds);
}
/**
* 二.分钟的加减
* 0.当前日期加减N分钟
*/
public static DateTime addMinutes(DateTime dateTime,int minutes){
return dateTime.plusMinutes(minutes);
}
/**
* 二.小时的加减
* 0.当前日期加减N小时
*/
public static DateTime addHours(DateTime dateTime,int hours){
return dateTime.plusHours(hours);
}
/**
* 二.日期的加减
* 1.当前日期加减N天
*/
public static DateTime addDays(DateTime dateTime,int days){
return dateTime.plusDays(days);
}
/**
* 2.当前日期加减N周
*/
public static DateTime addWeeks(DateTime dateTime,int weeks){
return dateTime.plusWeeks(weeks);
}
/**
* 3.当前日期加减N月
*/
public static DateTime addMonths(DateTime dateTime,int months){
return dateTime.plusMonths(months);
}
/**
* 4.当前日期加减N年
*/
public static DateTime addYears(DateTime dateTime,int years){
return dateTime.plusYears(years);
}
/**
* 三.日期坐标转换
* 1.指定日期是本周的周几
* 2.指定日期是本年的第几周
*/
public static int getDayOfWeek(DateTime dateTime){
return dateTime.getDayOfWeek();
}
public static int getWeekOfYear(DateTime dateTime){
return dateTime.getWeekOfWeekyear();
}
/**
* 四.日期单位的特殊点
* 1.根据日期,获取当前的起止时间 {@link #getDayOfBegin(DateTime)} {@link #getDayOfEnd(DateTime)}
* 2.根据日期,获取本周的第一天的0点时间 {@link #getWeekOfBegin(DateTime)}
* 3.根据日期,获取本周的最后一天的23:59:59的时间戳 {@link #getWeekOfEnd(DateTime)}
* 4.根据日期,获取本月的第一天的0点时间 {@link #getMonthOfBegin(DateTime)}
* 5.根据日期,获取本月的最后一天的23:59:59的时间 {@link #getMonthOfEnd(DateTime)}
* 6.根据日期,获取本年的第一天的0点时间 {@link #getYearOfBegin(DateTime)}
* 7.根据日期,获取本年的最后一天的23:59:59的时间 {@link #getYearOfEnd(DateTime)}
*/
public static DateTime getDayOfBegin(DateTime dateTime){
return dateTime.withTimeAtStartOfDay();
}
public static DateTime getDayOfEnd(DateTime dateTime){
return dateTime.millisOfDay().withMaximumValue();
}
public static DateTime getWeekOfBegin(DateTime dateTime){
return dateTime.dayOfWeek().withMinimumValue();
}
public static DateTime getWeekOfEnd(DateTime dateTime){
return dateTime.dayOfWeek().withMaximumValue();
}
public static DateTime getMonthOfBegin(DateTime dateTime){
return dateTime.dayOfMonth().withMinimumValue();
}
public static DateTime getMonthOfEnd(DateTime dateTime){
return dateTime.dayOfMonth().withMaximumValue();
}
public static DateTime getYearOfBegin(DateTime dateTime){
return dateTime.dayOfYear().withMinimumValue();
}
public static DateTime getYearOfEnd(DateTime dateTime){
return dateTime.dayOfYear().withMaximumValue();
}
/**
* 五.日期大小的比较
* 1.两个日期,比较返回大小 {@link #compare(DateTime, DateTime)}
* 2.两个日期,比较返回差额,判断是否满足某一个阈值 {@link #between(DateTime, DateTime, DateTime)}
* left > right = 1
* left = right = 0
* left < right = -1
*/
public static int compare(DateTime left, DateTime right){
if( left.isBefore(right) ){
return 1;
}
if( left.isEqual(right) ){
return 0;
}
return -1;
}
public static boolean between(DateTime src,DateTime left, DateTime right){
if( src.isAfter(left) && src.isBefore(right) ){
return true;
}
return false;
}
/**
* 六.日期截断
* 1.获取指定日期的天的毫秒数
* 2018-04-08 16:33:01 285 -> 2018-04-08 00:00:00 000
* 2.获取指定日期的小时的毫秒数
* 2018-04-08 16:33:01 285 -> 2018-04-08 16:00:00 000
* 3.获取指定日期的分的毫秒数
* 2018-04-08 16:33:01 285 -> 2018-04-08 16:33:00 000
* 4.获取指定日期的秒的毫秒数
* 2018-04-08 16:33:01 285 -> 2018-04-08 16:33:01 000
*/
public static DateTime getHourOfBegin(DateTime dateTime){
return dateTime.hourOfDay().roundFloorCopy();
}
public static DateTime getMinuteOfBegin(DateTime dateTime){
return dateTime.minuteOfDay().roundFloorCopy();
}
public static DateTime getSecondOfBegin(DateTime dateTime){
return dateTime.secondOfDay().roundFloorCopy();
}
/**
* 七.获取时间段
* 1.获取起止日期之间的所有日期列表
* 2.获取起止日期之间的所有周列表
* 3.获取起止日期之间的所有月列表
* TODO 待完善...
*/
/**
* 获取格式解析器
*/
private static DateTimeFormatter getFormatter(Parttern fmt) {
return DateTimeFormat.forPattern(fmt.getFmt());
}
/**
* 获取格式解析器
*/
private static DateTimeFormatter getFormatter(String format) {
return DateTimeFormat.forPattern(format);
}
}
补充说明:
如果有改进建议,欢迎留言.