Joda-time的使用

Posted 2023-02-25 tanyunlong_nice

在实际的开发过程中，对于日期的操作，往往很头疼，一次操作可能就要多行代码或者调用很多API，很多时候可能会出错，最近了解了一个很不错的类库Joda-time，这里学习记录下。

一、什么是Joda-Time

Joda-Time 令时间和日期值变得易于管理、操作和理解。事实上，易于使用是 Joda 的主要设计目标。其他目标包括可扩展性、完整的特性集以及对多种日历系统的支持。并且 Joda 与 JDK 是百分之百可互操作的，因此您无需替换所有 Java 代码，只需要替换执行日期/时间计算的那部分代码。

二、使用与JDK比较

1、创建一个新的时间

如果使用jdk 提供的方法

Calendar calendar = Calendar.getInstance();
calendar.set(2000, Calendar.JANUARY, 1, 0, 0, 0);

使用 Joda，代码应该类似如下所示：

DateTime dateTime = new DateTime(2000, 1, 1, 0, 0, 0, 0);

2、在这个日期上加上 90 天并输出结果。

  使用 JDK

Calendar calendar = Calendar.getInstance();
calendar.set(2000, Calendar.JANUARY, 1, 0, 0, 0);
SimpleDateFormat sdf =
  new SimpleDateFormat("E MM/dd/yyyy HH:mm:ss.SSS");
calendar.add(Calendar.DAY_OF_MONTH, 90);
System.out.println(sdf.format(calendar.getTime()));

 以 Joda 的方式向某一个瞬间加上 90 天并输出结果

DateTime dateTime = new DateTime(2000, 1, 1, 0, 0, 0, 0);
System.out.println(dateTime.plusDays(90).toString("E MM/dd/yyyy HH:mm:ss.SSS");

三、Joda与JDK互操性

将 Joda 计算结果插入到 JDK 对象中

Calendar calendar = Calendar.getInstance();
DateTime dateTime = new DateTime(2000, 1, 1, 0, 0, 0, 0);
System.out.println(dateTime.plusDays(45).plusMonths(1).dayOfWeek()
  .withMaximumValue().toString("E MM/dd/yyyy HH:mm:ss.SSS");
calendar.setTime(dateTime.toDate());

四、使用demo

import java.util.Scanner;  
import org.joda.time.DateTime;  
import org.joda.time.Days;  
import org.joda.time.LocalDate;  
import org.joda.time.format.DateTimeFormat;  
import org.joda.time.format.DateTimeFormatter;  
  
public class CalBabyJoda   
      
    private final static String birthday = "2012-3-10 08:20:55";  
  
    public static void main(String[] args)   
        while(true)  
            Scanner s = new Scanner(System.in);  
            System.out.println("########################################");  
            DateTimeFormatter format1 = DateTimeFormat .forPattern("yyyy-MM-dd HH:mm:ss");  
            DateTimeFormatter format2 = DateTimeFormat .forPattern("yyyy-MM-dd");  
            DateTime startDateTime = DateTime.parse(birthday, format1);  
            System.out.println("宝宝来到这个世界已经");  
            calDateToDay(startDateTime,new DateTime());  
            System.out.println("如选择其它日期请输入(格式例如:2012-11-08 14:24:54或着2012-11-08)");  
            System.out.println("########################################");  
            String endDate = s.nextLine();  
            DateTime endDateTime = null;  
            try  
                endDateTime = DateTime.parse(endDate,format1);  
            catch(Exception e)  
                try  
                    endDateTime = DateTime.parse(endDate,format2);  
                catch(Exception e1)  
                    System.out.println("输入格式错误!请重新输入.");  
                    continue;  
                  
              
            System.out.println("宝宝从出生到" + endDateTime.toString("yyyy-MM-dd HH:mm:ss") + "已经");  
            calDateToDay(startDateTime,endDateTime);  
          
      
      
    public static void calDateToDay(DateTime startDateTime,DateTime endDateTime)  
          
         LocalDate start=new LocalDate(startDateTime);    
        LocalDate end=new LocalDate(endDateTime);  
        Days days = Days.daysBetween(start, end);  
        int intervalDays = days.getDays();  
        int intervalHours = endDateTime.getHourOfDay() - startDateTime.getHourOfDay();  
        int intervalMinutes = endDateTime.getMinuteOfHour() - startDateTime.getMinuteOfHour();  
        int intervalSeconds = endDateTime.getSecondOfMinute() - startDateTime.getSecondOfMinute();  
          
          
        if(intervalSeconds < 0)  
            intervalMinutes = intervalMinutes -1;  
            intervalSeconds = 60 + intervalSeconds;  
          
          
        if(intervalMinutes < 0)  
            intervalHours = intervalHours -1;  
            intervalMinutes = 60 + intervalMinutes;  
          
          
        if(intervalHours < 0)  
            intervalDays = intervalDays -1;  
            intervalHours = 24 + intervalHours;  
          
                  
        System.out.println(intervalDays + "天" + intervalHours +   
                "小时" + intervalMinutes + "分钟" + intervalSeconds + "秒");  
        System.out.println("############################");  
      
  
  

六、使用工具类

public class DateTimeUtil 

    public static final String STANDARD_FORMAT = "yyyy-MM-dd HH:mm:ss";


    /**
     * joda-time
     * formatStr时间字符串转换 Date
     * @param dateTimeStr
     * @param formatStr
     * @return
     */
    public static Date strToDate(String dateTimeStr, String formatStr) 
        DateTimeFormatter dateTimeFormatter = DateTimeFormat.forPattern(formatStr);
        DateTime dateTime = dateTimeFormatter.parseDateTime(dateTimeStr);

        return dateTime.toDate();

    

    /**
     * 常见时间类型工具方法重载
     * yyyy-MM-dd HH:mm:ss转换 Date
     * @param dateTimeStr
     * @return
     */
    public static Date strToDate(String dateTimeStr) 
        DateTimeFormatter dateTimeFormatter = DateTimeFormat.forPattern(STANDARD_FORMAT);
        DateTime dateTime = dateTimeFormatter.parseDateTime(dateTimeStr);

        return dateTime.toDate();
    

    /**
     * joda-time
     * date转换formatStr格式字符串
     * @param date
     * @param formatStr
     * @return
     */
    public static String dateToStr(Date date, String formatStr) 

        if (date == null) 
            return StringUtils.EMPTY;
        
        DateTime dateTime = new DateTime(date);
        return dateTime.toString(formatStr);
    

    /**
     * 常见时间类型工具方法重载
     * date转换 yyyy-MM-dd HH:mm:ss 格式字符串
     * @param date
     * @return
     */
    public static String dateToStr(Date date) 

        if (date == null) 
            return StringUtils.EMPTY;
        
        DateTime dateTime = new DateTime(date);
        return dateTime.toString(STANDARD_FORMAT);
    





    public static void main(String[] args) 
        System.out.println(DateTimeUtil.dateToStr(new Date(),"yyyy-MM-dd HH:mm:ss"));
        System.out.println(DateTimeUtil.strToDate("2010-01-01 10:10:10","yyyy-MM-dd HH:mm:ss"));
    

七、maven 依赖

<dependency>
  <groupId>joda-time</groupId>
  <artifactId>joda-time</artifactId>
  <version>2.9.9</version>
</dependency>

package com.hhx.offline_tools;  
  
import java.nio.channels.NonWritableChannelException;  
import java.util.Calendar;  
import java.util.Date;  
import java.util.Locale;  
  
import org.joda.time.DateTime;  
import org.joda.time.Days;  
import org.joda.time.Duration;  
import org.joda.time.Interval;  
import org.joda.time.LocalDate;  
import org.joda.time.LocalDate.Property;  
import org.joda.time.Period;  
import org.joda.time.PeriodType;   
  
/** 
 * 第三方时间处理类 
 *  
 * @author 清水贤人 
 * 
 */  
public class JodaTime   
      
    private static final String FORMATE_DATE = "yyyy-MM-dd";    
    private static final String FORMATE_SECONDS = "HH:mm:ss";    
    private static final String FORMATE_FULL = FORMATE_DATE.concat(" ").concat(FORMATE_SECONDS);   
      
    /** 
     * 初始化方法 
     * 1、参的构造方法会创建一个在当前系统所在时区的当前时间，精确到毫秒 2017-03-15T12:31:33.517+08:00 
     * 2、DateTime(int year, int monthOfYear, int dayOfMonth, int hourOfDay, int minuteOfHour)根据传入的时间构造 
     * 3、DateTime(long instant) 这个构造方法创建出来的实例，是通过一个long类型的时间戳，它表示这个时间戳距1970-01-01T00:00:00Z的毫秒数。使用默认的时区 
     * 4、DateTime(Object instant) 这个构造方法可以通过一个Object对象构造一个实例。这个Object对象可以是这些类型 
     */  
    private static void useCaseOne()  
          
        DateTime dt = new DateTime();   
        DateTime dt1 = new DateTime(2017,12,12,12,12,8);  
        DateTime dt2 = new DateTime(1487473917004L);  
        DateTime dt3 = new DateTime(new Date());  
        DateTime dt4 = new DateTime("2017-03-15T12:22:22");  
        //格式化数据     输出： 2017年03月16日 13:53:42 星期四  
       System.out.println(dt.toString("yyyy年MM月dd日 HH:mm:ss EE",Locale.CHINESE));   
          
      
      
    /** 
     * 涉及时间计算 
     */  
    private static void useCaseWith()  
          
        DateTime dt = new DateTime();  
        // 获取当前时间月的第一天  
        LocalDate firstDayOfMonth = dt.toLocalDate().withDayOfMonth(1);    
          
        // 获取当前周的周一和周末  
        System.out.println(String.format("min:%s, max:%s",DateTime.now().dayOfWeek().withMinimumValue().toString("yyyy-MM-dd"),DateTime.now().dayOfWeek().withMaximumValue().toString("yyyy-MM-dd")));   
          
        // 当前月的第一天和最后一天    
        System.out.println(String.format("min:%s, max:%s",DateTime.now().dayOfMonth().withMinimumValue().toString("yyyy-MM-dd"),DateTime.now().dayOfMonth().withMaximumValue().toString("yyyy-MM-dd")));    
     
        // 当前年的第一天和最后一天    
        System.out.println(String.format( "min:%s, max:%s",DateTime.now().dayOfYear().withMinimumValue().toString("yyyy-MM-dd"),DateTime.now().dayOfYear().withMaximumValue().toString("yyyy-MM-dd")));       
         
        // 10天后的日期  
        System.out.println(DateTime.now().dayOfYear().addToCopy(10).toString(FORMATE_DATE));   
        System.out.println(DateTime.now().plusDays(10).toString(FORMATE_DATE));   
          
        // 10天前的日期  
        System.out.println(DateTime.now().minusDays(10).toString(FORMATE_DATE));   
          
        // 当前时间的10小时之前的时间  
        System.out.println(DateTime.now().minusHours(10).toString(FORMATE_DATE));   
          
        //取前几秒的时间  
        System.out.println( dt.secondOfMinute().addToCopy(-3));      
   
         
        DateTime begin = new DateTime(2017, 3, 1, 11, 13, 40);   
        Duration duration = new Duration(begin, dt);   
         
        // 两个时间之间 所差 天，小时 ，分，秒  
        System.out.println( begin.toString(FORMATE_FULL) + " 与 " + dt.toString(FORMATE_FULL) + " 相差的天数：" + duration.getStandardDays());    
        System.out.println(begin.toString(FORMATE_FULL) + " 与 "  + dt.toString(FORMATE_FULL) + " 相差的小时数：" + duration.getStandardHours());   
        System.out.println(begin.toString(FORMATE_FULL) + " 与 "  + dt.toString(FORMATE_FULL) + " 相差的分钟：" + duration.getStandardMinutes());   
        System.out.println(begin.toString(FORMATE_FULL) + " 与 "  + dt.toString(FORMATE_FULL) + " 相差的秒：" + duration.getStandardSeconds());   
        //计算区间天数  ,小时，秒  
        Period p = new Period(new DateTime(2017, 1, 1, 0, 0, 0),new DateTime(2017, 3, 30, 0, 0, 0), PeriodType.days());    
        System.out.println("相隔的天："+p.getDays());   
          
          
        // 计算两个日期相差几天 (同上面方法)  
        System.out.println("Days.daysBetween:"+ Days.daysBetween(DateTime.parse("2017-03-16"), DateTime.parse("2017-04-02")).getDays());    
          
        // 计算之前月份的时间操作  
        LocalDate d = LocalDate.now();    
          
        // 上个月(可以是之前的任意月)的最后一天  
        LocalDate lastDayOfPreviousMonth = d.minusMonths(1).dayOfMonth().withMaximumValue();    
          
          
        Property e = d.minusWeeks(1).dayOfWeek();    
        System.out.println("上周的周一：" + e.withMinimumValue().toString(FORMATE_DATE, Locale.CHINESE));    
        System.out.println("上周的周日：" + e.withMaximumValue().toString(FORMATE_DATE, Locale.CHINESE));    
          
        //汉字形式标识今年和去年时间  
        System.out.println("汉字形式：" + dt.minusYears(0).year().getAsText(Locale.CHINESE));  
        System.out.println("汉字形式：" + dt.minusYears(1).monthOfYear().getAsText(Locale.CHINESE));  
        System.out.println("汉字形式："+ dt.minusYears(1).dayOfMonth().getAsText(Locale.CHINESE));  
        System.out.println("汉字形式：" + dt.minusYears(1).dayOfWeek().getAsText(Locale.CHINESE));    
          
        // 判断是否是闰年 闰月  
        System.out.println("是否闰月:" + dt.monthOfYear().isLeap());  
        System.out.println("是否闰年:" + dt.year().isLeap());    
        System.out.println("去年是否闰年:" + dt.minusYears(1).year().isLeap());    
          
        //取得一天的开始时间和结束时间  
        System.out.println(dt.withTimeAtStartOfDay().toString(FORMATE_FULL));  
        System.out.println(dt.millisOfDay().withMaximumValue().toString(FORMATE_FULL));  
          
        //获取现在距离今天结束还有多久时间  
        System.out.println( dt.millisOfDay().withMaximumValue().getMillis() - dt.getMillis());  
     
        //判断时间跨度是否包含当前时间,某个时间  
        Interval interval = new Interval(new DateTime(2017, 1, 1, 0, 0, 0),new DateTime(2017, 3, 30, 0, 0, 0));  
        System.out.println(interval.containsNow());  
        boolean contained = interval.contains(new DateTime("2012-03-01"));   
          
      
        //10 天后 那周的周一是  
        System.out.println(dt.plusDays(10).dayOfWeek().withMinimumValue().toString(FORMATE_FULL));   
      
        // DateTime与java.util.Date对象,当前系统TimeMillis转换    
        DateTime temp1 = new DateTime(new Date());    
        Date temp2 = dt.toDate();    
        DateTime temp3 = new DateTime(System.currentTimeMillis());    
        
        Calendar calendar = Calendar.getInstance();    
        DateTime  temp4 = new DateTime(calendar);  
      
      
      
    /** 
     * 这个是get方法 
     * 最大单位是年，最小单位毫秒 
     * api中均可以最大单位下的子类 
     * 比如：可以获取年终 月、日、时、分、秒、毫秒 
     * 一下代码不全部列出 
     */  
    private static void useCaseGet()  
          
        DateTime dt = new DateTime();  
        //获取当前时间的年  
        int year = dt.getYear();  
        //获取当前时间的月  
        int month = dt.getMonthOfYear();  
        //获取当前时间是一年中的第几天  
        int dayOfYear = dt.getDayOfYear();  
        //获取一个月中的天  
        int day =  dt.getDayOfMonth();  
        //获取一周中的周几  
        int week = dt.getDayOfWeek();  
        //一天中的第几小时(取整)  
        int hour = dt.getHourOfDay();  
        //获取星期年  
        int weekOfyear =  dt.getWeekyear();  
        //当前时间的秒中的毫秒   
        int ms = dt.getMillisOfSecond();  
        //获取当前时间的秒  
        int second = dt.getSecondOfDay();    
        //获取当前时间的毫秒  
        long millis = dt.getMillis();  
           
      
      
      
    public static void main(String[] args)   
        //useCaseOne();  
        //  useCaseTwo();  
        //useCaseGet();  
        useCaseWith();  
           
  
      
  
  

附：Joda-time中文文档

参考文章：https://www.ibm.com/developerworks/cn/java/j-jodatime.html

               http://ylq365.iteye.com/blog/1769680

http://blog.csdn.net/wjsshhx/article/details/62422844