DateTime类的使用

首先我们在开发过程中经常会遇到对日期的一些处理，比如获取当前系统时间，时间的格式化，获取年月日时分秒毫秒、周几、取特殊的日期，以及日期的比较，日期的后推，设置时区，计算区间的秒、毫秒、天等的数量；有时候jdk提供的 Date和 Calendar 不一定能够满足我们的需求，或则实现起来比较麻烦，这时我们可以试着使用一下DateTime。

一、下面介绍一下DateTime常用的API：

1、首先我们要使用DateTime ，必须要知道它的依赖：如果你不知道，可以进入maven仓库找到依赖或自己下完jar包，添加自己的项目中，下面提供一下pom文件的依赖，进入maven的仓库主页 https://mvnrepository.com/ 搜索 Joda Time ,然后找到pom依赖：

<!-- https://mvnrepository.com/artifact/joda-time/joda-time -->
<dependency>
    <groupId>joda-time</groupId>
    <artifactId>joda-time</artifactId>
    <version>2.10.5</version>
</dependency>

2、DateTime常用的API：

 /*
         * 1.初始化
         */
        //方法一：取系统点间
        DateTime dt = new DateTime();

        //方法二：通过java.util.Date对象生成
        dt = new DateTime(new Date());

        //方法三：指定年月日点分秒生成(参数依次是：年,月,日,时,分,秒,毫秒)
        dt = new DateTime(2012, 5, 20, 13, 14, 0, 0);

        //方法四：ISO8601形式生成
        dt = new DateTime("2012-05-20");
        dt = new DateTime("2012-05-20T13:14:00");

        //只需要年月日的时候
        LocalDate localDate = new LocalDate(2009, 9, 6);// September 6, 2009

        //只需要时分秒毫秒的时候
        LocalTime localTime = new LocalTime(13, 30, 26, 0);// 1:30:26PM

        /*
         * 2.获取年月日点分秒
         */
        //年
        int year = dt.getYear();
        //月
        int month = dt.getMonthOfYear();
        //日
        int day = dt.getDayOfMonth();
        //星期
        int week = dt.getDayOfWeek();
        //点
        int hour = dt.getHourOfDay();
        //分
        int min = dt.getMinuteOfHour();
        //秒
        int sec = dt.getSecondOfMinute();
        //毫秒
        int msec = dt.getMillisOfSecond();


        // 判断当前是星期几
        switch(dt.getDayOfWeek()) {
            case DateTimeConstants.SUNDAY:
                System.out.println("星期日");
                break;
            case DateTimeConstants.MONDAY:
                System.out.println("星期一");
                break;
            case DateTimeConstants.TUESDAY:
                System.out.println("星期二");
                break;
            case DateTimeConstants.WEDNESDAY:
                System.out.println("星期三");
                break;
            case DateTimeConstants.THURSDAY:
                System.out.println("星期四");
                break;
            case DateTimeConstants.FRIDAY:
                System.out.println("星期五");
                break;
            case DateTimeConstants.SATURDAY:
                System.out.println("星期六");
                break;
        }

        /*
         * 3.与JDK日期对象的转换
         */
        //转换成java.util.Date对象
        Date d1 = new Date(dt.getMillis());
        Date d2 = dt.toDate();

        //转换成java.util.Calendar对象
        Calendar c1 = Calendar.getInstance();
        c1.setTimeInMillis(dt.getMillis());
        Calendar c2 = dt.toCalendar(Locale.getDefault());


        /*
         * 4.日期前后推算 （这个方法比较实用）
         */
        //天
        DateTime yesterday = dt.minusDays(1);
        DateTime tomorrow = dt.plusDays(1);

        //月
        DateTime lastMonth = dt.minusMonths(1);
        DateTime nextMonth = dt.plusMonths(1);

        //周
        DateTime lastWeek = dt.minusWeeks(-1);
        DateTime nexWeek = dt.plusWeeks(1);

        //年
        DateTime lastYear = dt.minusYears(1);
        DateTime nextYear = dt.plusYears(1);


        /*
         * 5.取特殊日期
         */
        //月末日期
        DateTime lastday = dt.dayOfMonth().withMaximumValue();

        //90天后那周的周一
        DateTime firstday = dt.plusDays(90).dayOfWeek().withMinimumValue();


        /*
         * 6.设置时区
         */
        //日本时间
        DateTimeZone.setDefault(DateTimeZone.forID("Asia/Tokyo"));
        dt = new DateTime();

        //伦敦时间
        dt = new DateTime(DateTimeZone.forID("Europe/London"));

        //东八区时间
        DateTimeZone.setDefault(DateTimeZone.forID("Asia/Shanghai"));


        /*
         * 7.计算区间
         */
        DateTime begin = new DateTime("2012-02-01");
        DateTime end = new DateTime("2012-05-01");

        //计算区间毫秒数
        Duration d = new Duration(begin, end);
        long time = d.getMillis();

        //计算区间天数
        Period p = new Period(begin, end, PeriodType.days());
        int days = p.getDays();

        //计算特定日期是否在该区间内
        Interval i = new Interval(begin, end);
        boolean contained = i.contains(new DateTime("2012-03-01"));


        /*
         * 8.日期比较
         */
        DateTime dt1 = new DateTime("2012-02-01");
        DateTime dt2 = new DateTime("2012-05-01");

        //和系统时间比
        boolean b1 = dt1.isAfterNow();
        boolean b2 = dt1.isBeforeNow();
        boolean b3 = dt1.isEqualNow();

        //和其他日期比
        boolean f1 = dt1.isAfter(dt2);
        boolean f2 = dt1.isBefore(dt2);
        boolean f3 = dt1.isEqual(dt2);

        /*
         * 9.格式化输出
         */
        DateTime dateTime = new DateTime();

        String s1 = dateTime.toString("yyyy/MM/dd hh:mm:ss.SSSa");
        String s2 = dateTime.toString("yyyy-MM-dd HH:mm:ss");
        String s3 = dateTime.toString("EEEE dd MMMM, yyyy HH:mm:ssa");
        String s4 = dateTime.toString("yyyy/MM/dd HH:mm ZZZZ");  //ZZZZ 表示 时区
        String s5 = dateTime.toString("yyyy/MM/dd HH:mm Z");

二、举个实例：项目开发阶段，有一个关于下单发货的需求：如果今天下午 3 点前进行下单，那么发货时间是明天， 如果今天下午 3 点后进行下单，那么发货时间是后天，如果被确定的时间是周日，那么在此时间上再加 1 天为发货时间。

    public static void main(String [] args){
        //下单时间为 orderTime
        DateTime orderTime = new DateTime();
        orderTime = new DateTime(2020, 8, 28, 16, 14, 0, 0);
        //返回发货时间点
        Date date = DealUtils.calculateDistributionTimeByOrderCreateTime(orderTime.toDate());
        System.out.println(DateFormatUtils.format(date , "yyyy-MM-dd HH:mm:ss"));
    }


    // 定义一个常量当前天下的 15:00:00:00 时 分 秒 毫秒
    final static DateTime DISTRIBUTION_TIME_SPLIT_TIME = new DateTime().withTime(15,0,0,0);

    /**
     *  项目开发阶段，有一个关于下单发货的需求：如果今天下午 3 点前进行下单，那么发货时间是明天，
     *  如果今天下午 3 点后进行下单，那么发货时间是后天，如果被确定的时间是周日，那么在此时间上再加 1 天为发货时间。
     *
     *
     * @param orderCreateTime  下单时间
     * @return  返回发货时间
     */
    private static Date calculateDistributionTimeByOrderCreateTime(Date orderCreateTime){
        //定义一个DateTime
        DateTime orderCreateDateTime = new DateTime(orderCreateTime);
        //时间后推一天 并转换成Date类
        Date tomorrow = orderCreateDateTime.plusDays(1).toDate();
        //时间后推两天 并转换成Date类
        Date theDayAfterTomorrow = orderCreateDateTime.plusDays(2).toDate();
        //下单时间与下午三点比  大于三点往后推两天 小于等于则往后推一天   然后对推算后的发货日期进行判断是否为周日
        return  orderCreateDateTime.isAfter(new DateTime(orderCreateTime).withTime(15,0,0,0)) ?
                wrapDistributionTime(theDayAfterTomorrow) : wrapDistributionTime(tomorrow);
    }

    /**
     *  判断日期是否为周日  若是 往后推一天  否则什么都不做
     * @param distributionTime
     * @return
     */
    private static Date wrapDistributionTime(Date distributionTime){
        DateTime currentDistributionDateTime = new DateTime(distributionTime);
        //日期往后推一天
        DateTime plusOneDay = currentDistributionDateTime.plusDays(1);
        //判断是否为周末
        boolean isSunday = (DateTimeConstants.SUNDAY == currentDistributionDateTime.getDayOfWeek());
        //如果是周日 把推算后的日期返回  否则不处理
        return isSunday ? plusOneDay.toDate() : currentDistributionDateTime.toDate();
    }

【结论】DateTime 中提供了很多的方法，对于我们在开发过程中可以方便很多，减少程序出错的可能性。