joda－time快速上手指导

最新推荐文章于 2024-08-27 08:23:04 发布

翻译最新推荐文章于 2024-08-27 08:23:04 发布 · 469 阅读

文章标签：

#joda-time

java 专栏收录该内容

1 篇文章

订阅专栏

本文介绍 Joda-Time 的核心类及用法，包括 Instant、DateTime、LocalDate 等，涵盖日期时间操作、时区处理等实用技巧。

原文链接

快速上手指导

这份指南是对joda－time的一个简介。想查看更多信息请参考完整的用户指南。

日期和时间

日期和时间是一个十分复杂的领域。joda-time中设计了许多类来完整地阐述这个范畴的细微差别。

最常用的5个日期时间类是：

Instant- 代表时间线上一个瞬间点的不可变的类。
DateTime 用来替代JDK中Calendar的不可变类。
LocalDate - 代表一个不带时间的本地日期的不可变类（不分时区）
LocalTime -代表一个本地时间的不可变类。（不分时区）
LocalDateTime - 表示一个本地日期和时间的不可变类（不分时区）

instant适合表示一个事件的时间戳，因为不必担心历法和时区问题。LocalDate适合表示出生日期，因为没必要指明时间。LocalTime适合表示一天中商店开门或者打烊的时间。DateTime适合作为JDK的Calendar类的一种通用替代者，它比较强调时区的概念。查看关于 instants 和 partials 的文档。

使用日期和时间类

每个日期时间类都提供了各种构造函数，包括对象构造函数。从而允许你从各种不同的对象中构造一个实例对象：例如，一个 DateTime可以从如下的对象中构造出来:

Date JDK中的瞬间
Calendar JDK中的日历
String 遵从ISO8601格式
Long 毫秒数
任何joda-time中的日期时间类

对象构造器不是很常用，使用它是因为以上列出的类型是可扩展的。主要的优势是从一个 JDK的Date类或者一个Calendar类转为 joda-time类非常简单，只需要把这个类传进构造器。例如，下面这段代码把一个 java.util.Date转换为一个DateTime类：

  java.util.Date juDate = new Date();
  DateTime dt = new DateTime(juDate);

每个日期时间类提供了访问日期时间属性的简便方法。例如，可以通过下面的方式访问月份和年份：

  DateTime dt = new DateTime();
  int month = dt.getMonthOfYear();  // 这里1月份是1，十二月份是12
  int year = dt.getYear();

和String类似，所有的日期时间类都是在创建之后不能的不可变类，但是可以用提供的简单方法来对一个新创建的对象中更改属性值。例如，想要对日期时间类设置年份或者加2小时你可以使用下面的方式：

  DateTime dt = new DateTime();
  DateTime year2000 = dt.withYear(2000);
  DateTime twoHoursLater = dt.plusHours(2);

除了基本的get方法，每个日期时间类对每个属性提供了合适的方法以便充分利用joda-time丰富的功能。例如，获取关于某一月或者某一年的详情：

  DateTime dt = new DateTime();
  String monthName = dt.monthOfYear().getAsText();
  String frenchShortName = dt.monthOfYear().getAsShortText(Locale.FRENCH);
  boolean isLeapYear = dt.year().isLeap();
  DateTime rounded = dt.dayOfMonth().roundFloorCopy();

日历系统和时区

joda-Time支持多种日历系统和全部的时区，Chronology 和 DateTimeZone 类提供了这个支持。

joda-Time默认使用ISO日历系统，也是世界各地都在使用的日历。默认的时区和JDK默认时区保持一致。可以在需要的时候更改这些默认值。请注意由于历史原因，1583年之前的ISO日历系统并不精确。

joda-Time使用了可插拨的结构支持多种日历。而JDK使用了像 GregorianCalendar这样的子类来支持多种日历。通过调用一个取决于Chronology具体实现的工厂方法，下面这段代码得到了一个joda-time的Chronology对象：

  Chronology coptic = CopticChronology.getInstance();

时间间隔和时间周期

joda-time支持时间间隔和时间周期。

使用interval类来表示一段时间间隔。它包含了一个开始时间和一个结束时间，允许在这段时间上进行一些操作。

使用Period类来表示一段时间周期。它包含了一段时间周期，像是6个月，3天或7小时。你可以直接创建一个Period，或者从一个interval派生出来。

使用Duration类来表示一段持续时间段。它包含了一个准确的持续时间段的毫秒数。你可以直接创建一个 Duration类，或者从一个interval对象派生。

尽管period和duration可能很相似，但是他们的操作并不相同。假如，考虑夏令时的切换时把一个 DateTime加一天：

  DateTime dt = new DateTime(2005, 3, 26, 12, 0, 0, 0);
  DateTime plusPeriod = dt.plus(Period.days(1));
  DateTime plusDuration = dt.plus(new Duration(24L*60L*60L*1000L));