public abstract class DurationFormat extends UFormat
Modifier | Constructor and Description |
---|---|
protected |
DurationFormat()
Deprecated.
This API is ICU internal only.
|
protected |
DurationFormat(ULocale locale)
Deprecated.
This API is ICU internal only.
|
Modifier and Type | Method and Description |
---|---|
abstract java.lang.StringBuffer |
format(java.lang.Object object,
java.lang.StringBuffer toAppend,
java.text.FieldPosition pos)
Format an arbitrary object.
|
abstract java.lang.String |
formatDurationFrom(long duration,
long referenceDate)
Formats a duration expressed in milliseconds from a reference date.
|
abstract java.lang.String |
formatDurationFromNow(long duration)
Formats a duration expressed in milliseconds.
|
abstract java.lang.String |
formatDurationFromNowTo(java.util.Date targetDate)
Formats the duration between now and a target date.
|
static DurationFormat |
getInstance(ULocale locale)
Construct a duration format for the specified locale
|
java.lang.Object |
parseObject(java.lang.String source,
java.text.ParsePosition pos)
DurationFormat cannot parse, by default.
|
@Deprecated protected DurationFormat()
@Deprecated protected DurationFormat(ULocale locale)
public static DurationFormat getInstance(ULocale locale)
public abstract java.lang.StringBuffer format(java.lang.Object object, java.lang.StringBuffer toAppend, java.text.FieldPosition pos)
format
in class java.text.Format
object
- the object to format. Should be either a Long, Date, or javax.xml.datatype.Duration object.toAppend
- the buffer to append topos
- the field position, may contain additional error messages.public java.lang.Object parseObject(java.lang.String source, java.text.ParsePosition pos)
parseObject
in class java.text.Format
public abstract java.lang.String formatDurationFromNowTo(java.util.Date targetDate)
This is a convenience method that calls
formatDurationFrom(long, long) using now
as the reference date, and the difference between now and
targetDate.getTime()
as the duration.
targetDate
- the ending datepublic abstract java.lang.String formatDurationFromNow(long duration)
This is a convenience method that calls formatDurationFrom using the current system time as the reference date.
duration
- the duration in millisecondspublic abstract java.lang.String formatDurationFrom(long duration, long referenceDate)
The reference date allows formatters to use actual durations of variable-length periods (like months) if they wish.
The duration is expressed as the number of milliseconds in the past (negative values) or future (positive values) with respect to a reference date (expressed as milliseconds in epoch).
duration
- the duration in millisecondsreferenceDate
- the date from which to compute the durationCopyright (c) 2014 IBM Corporation and others.