RelativeDateTimeFormatter

public final class RelativeDateTimeFormatter
extends Object

格式化简单的相对日期。 它处理的相对日期有两种类型：

• relative dates with a quantity e.g "in 5 days"
• relative dates without a quantity e.g "next Tuesday"

这个API是非常基础的，并且旨在成为更多花哨的API的构建块。 调用者确切地告诉它要以独立于区域的方式显示的内容。 虽然这个类自动提供了正确的复数形式，但其语法形式应尽可能保持中立。 来电者有责任处理截止逻辑，例如决定在“7天内”还是“1周内”之间进行显示。 该API支持涉及单个单元的相对日期。 此API不支持涉及复合单位的相对日期。 例如“5天4小时”，也不支持解析。 这个类既是不可变的，也是线程安全的。

以下是一些使用示例：

 RelativeDateTimeFormatter fmt = RelativeDateTimeFormatter.getInstance();
 fmt.format(1, Direction.NEXT, RelativeUnit.DAYS); // "in 1 day"
 fmt.format(3, Direction.NEXT, RelativeUnit.DAYS); // "in 3 days"
 fmt.format(3.2, Direction.LAST, RelativeUnit.YEARS); // "3.2 years ago"
 
 fmt.format(Direction.LAST, AbsoluteUnit.SUNDAY); // "last Sunday"
 fmt.format(Direction.THIS, AbsoluteUnit.SUNDAY); // "this Sunday"
 fmt.format(Direction.NEXT, AbsoluteUnit.SUNDAY); // "next Sunday"
 fmt.format(Direction.PLAIN, AbsoluteUnit.SUNDAY); // "Sunday"
 
 fmt.format(Direction.LAST, AbsoluteUnit.DAY); // "yesterday"
 fmt.format(Direction.THIS, AbsoluteUnit.DAY); // "today"
 fmt.format(Direction.NEXT, AbsoluteUnit.DAY); // "tomorrow"
 
 fmt.format(Direction.PLAIN, AbsoluteUnit.NOW); // "now"
 

未来，我们可能会添加更多表单，如缩短/短格式（3秒前）和相对日期（“昨天下午”）等。

Summary

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用方法 notify()或 notifyAll()方法，或者其他线程中断当前线程或经过了一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法，或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。

Public methods

String combineDateAndTime (String relativeDateString, 
                String timeString)

String format (double quantity, 
                RelativeDateTimeFormatter.Direction direction, 
                RelativeDateTimeFormatter.RelativeUnit unit)

String format (RelativeDateTimeFormatter.Direction direction, 
                RelativeDateTimeFormatter.AbsoluteUnit unit)

DisplayContext getCapitalizationContext ()

RelativeDateTimeFormatter.Style getFormatStyle ()

RelativeDateTimeFormatter getInstance (ULocale locale, 
                NumberFormat nf, 
                RelativeDateTimeFormatter.Style style, 
                DisplayContext capitalizationContext)

RelativeDateTimeFormatter getInstance (ULocale locale)

RelativeDateTimeFormatter getInstance ()

RelativeDateTimeFormatter getInstance (Locale locale)

RelativeDateTimeFormatter getInstance (ULocale locale, 
                NumberFormat nf)

RelativeDateTimeFormatter getInstance (Locale locale, 
                NumberFormat nf)

NumberFormat getNumberFormat ()