JodaTime初窥（0321）

1. 简介：

既然无法摆脱时间，为何不设法简化时间处理？

例子：

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

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

2. 以 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");

2. 时间概念

• 不可变性
• 瞬间性
• 局部性
• 年表
• 时区

不可变性

Joda 类具有不可变性，因此它们的实例无法被修改。（不可变类的一个优点就是它们是线程安全的）。

瞬间性

一个瞬间 就是指时间线上只出现一次且唯一的一个时间点，并且这种日期结构只能以一种有意义的方式出现一次。

局部性

局部时间片段指的是在时间上可以来回 “移动” 的一个时刻，这样它便可以应用于多个实例。比如，6 月 2 日 可以应用于任意一年的 6 月份（使用 Gregorian 日历）的第二天的任意瞬间。同样，11:06 p.m. 可以应用于任意一年的任意一天，并且每天只能使用一次。即使它们没有指定一个时间上的精确时刻，局部时间片段仍然是有用的。

年表

年表是一种日历系统 — 一种计算时间的特殊方式 — 并且是一种在其中执行日历算法的框架。

时区

要了解事件发生的精确时间，还必须知道发生此事件的位置。

3. 创建Joda Time对象

• DateTime

这是最常用的一个类。它以毫秒级的精度封装时间上的某个瞬间时刻。DateTime 始终与 DateTimeZone 相关，如果您不指定它的话，它将被默认设置为运行代码的机器所在的时区。

它有多种构建方式（使用 String必须经过格式化）：

1.默认构造

DateTime dateTime = new DateTime();    

2.表示时间上的某个特定的瞬间。

DateTime dateTime = new DateTime(
  2000, //year
  1,    // month
  1,    // day
  0,    // hour (midnight is zero)
  0,    // minute
  0,    // second
  0     // milliseconds
);

3.Joda 支持使用许多其他对象作为构造函数的参数，用于创建 DateTime

// Use a Calendar
java.util.Calendar calendar = obtainCalendarSomehow();
dateTime = new DateTime(calendar);

// Use another Joda DateTime
DateTime anotherDateTime = obtainDateTimeSomehow();
dateTime = new DateTime(anotherDateTime);

// Use a String (must be formatted properly)
String timeString = "2006-01-26T13:30:00-06:00";
dateTime = new DateTime(timeString);
timeString = "2006-01-26";
dateTime = new DateTime(timeString);

• LocalDate

该类封装了一个年/月/日的组合。当地理位置（即时区）变得不重要时，使用它存储日期将非常方便。例如，某个特定对象的出生日期 可能为 1999 年 4 月 16 日，但是从技术角度来看，在保存所有业务值的同时不会了解有关此日期的任何其他信息（比如这是一周中的星期几，或者这个人出生地所在的时区）。

构造方式同DateTime前两种：

LocalDate localDate = SystemFactory.getClock().getLocalDate();

LocalDate localDate = new LocalDate(2009, 9, 6);// September 6, 2009

• LocalTime

这个类封装一天中的某个时间，当地理位置不重要的情况下，可以使用这个类来只存储一天当中的某个时间。例如，晚上 11:52 可能是一天当中的一个重要时刻（比如，一个 cron 任务将启动，它将备份文件系统的某个部分），但是这个时间并没有特定于某一天，因此我不需要了解有关这一时刻的其他信息。

构造方式同上：

LocalTime localTime = SystemFactory.getClock().getLocalTime();

LocalTime localTime = new LocalTime(13, 30, 26, 0);// 1:30:26PM

• 时间跨度

1.Duration
这个类表示一个绝对的精确跨度，使用毫秒为单位。这个类提供的方法可以用于通过标准的数学转换（比如 1 分钟 = 60 秒，1 天 = 24 小时），将时间跨度转换为标准单位（比如秒、分和小时）。

2.Period
这个类表示与 Duration 相同的概念，但是以人们比较熟悉的单位表示，比如年、月、周。

3.Interval
这个类表示一个特定的时间跨度，将使用一个明确的时刻界定这段时间跨度的范围。Interval 为半开 区间，这表示由 Interval 封装的时间跨度包括这段时间的起始时刻，但是不包含结束时刻。

可以在以下情况使用 Interval：需要表示在时间连续区间中以特定的点开始和结束的一段时间跨度。

4. 以Joda处理时间

• 计算上一个月的最后一天

  LocalDate now = SystemFactory.getClock().getLocalDate();
  LocalDate lastDayOfPreviousMonth = now.minusMonths(1).dayOfMonth().withMaximumValue();

同样还有：yearOfCentury、dayOfYear、monthOfYear、dayOfMonth、dayOfWeek

• 计算 11 月中第一个星期一之后的第一个星期二

  LocalDate now = SystemFactory.getClock().getLocalDate();
  LocalDate electionDate = now.monthOfYear()
  .setCopy(11) // November
  .dayOfMonth() // Access Day Of Month Property
  .withMinimumValue() // Get its minimum value
  .plusDays(6) // Add 6 days
  .dayOfWeek() // Access Day Of Week Property
  .setCopy("Monday") // Set to Monday (it will round down)
  .plusDays(1); // Gives us Tuesday

5. JDK互操作性

• 从 Joda DateTime 类创建 JDK 类

  DateTime dateTime = SystemFactory.getClock().getDateTime();
  Calendar calendar = dateTime.toCalendar(Locale.getDefault());
  Date date = dateTime.toDate();
  DateMidnight dateMidnight = SystemFactory.getClock().getDateMidnight();
  date = dateMidnight.toDate();

• 创建表示 LocalDate 的 Date 对象（多一步）

  LocalDate localDate = SystemFactory.getClock().getLocalDate();
  Date date = localDate.toDateMidnight().toDate();

6. 以Joda格式化时间

• 使用 ISO-8601

  DateTime dateTime = SystemFactory.getClock().getDateTime();
  dateTime.toString(ISODateTimeFormat.basicDateTime());
  dateTime.toString(ISODateTimeFormat.basicDateTimeNoMillis());
  dateTime.toString(ISODateTimeFormat.basicOrdinalDateTime());
  dateTime.toString(ISODateTimeFormat.basicWeekDateTime());

20090906T080000.000-0500
20090906T080000-0500
2009249T080000.000-0500
2009W367T080000.000-0500

• 传递 SimpleDateFormat 字符串(规则待补充)

  DateTime dateTime = SystemFactory.getClock().getDateTime();
  dateTime.toString("MM/dd/yyyy hh:mm:ss.SSSa");
  dateTime.toString("dd-MM-yyyy HH:mm:ss");
  dateTime.toString("EEEE dd MMMM, yyyy HH:mm:ssa");
  dateTime.toString("MM/dd/yyyy HH:mm ZZZZ");
  dateTime.toString("MM/dd/yyyy HH:mm Z");

09/06/2009 02:30:00.000PM
06-Sep-2009 14:30:00
Sunday 06 September, 2009 14:30:00PM
09/06/2009 14:30 America/Chicago
09/06/2009 14:30 -0500