开箱即用系列-工具包-日期工具类

使用背景:

  1. 项目中, 许多地方使用到日期的转换, 这个类可以满足你的需求.
  2. 项目中,因实现的日期工具不规范,导致使用不规范,不好统一处理,于是自己封装了一个实现.

日期工具类实现:

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);
    }
}

补充说明:
如果有改进建议,欢迎留言.

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值