net.time4j.format

Class TimeSpanFormatter<U,S extends TimeSpan<U>>

java.lang.Object

net.time4j.format.TimeSpanFormatter<U,S>

Type Parameters:

U - generic type of time units

S - generic type of supported timespan

Direct Known Subclasses:

Duration.Formatter

public abstract class TimeSpanFormatter<U,S extends TimeSpan<U>>
extends java.lang.Object

Represents a non-localized and user-defined format for timespans based on a pattern containing some standard symbols and literals.

Since:

3.26/4.22

Method Summary

Modifier and Type	Method and Description
java.lang.String	format(TimeSpan<? super U> duration) Creates a textual output of given duration.
java.lang.String	getPattern() Yields the underlying format pattern.
java.lang.Class<U>	getType() Yields the associated reified unit type.
S	parse(java.lang.CharSequence text) Equivalent to parse(text, 0).
S	parse(java.lang.CharSequence text, int offset) Analyzes given text according to format pattern and parses the text to a duration.
void	print(TimeSpan<? super U> duration, java.lang.Appendable buffer) Creates a textual output of given duration and writes to the buffer.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getPattern

public java.lang.String getPattern()

Yields the underlying format pattern.

Returns:

String

getType

public java.lang.Class<U> getType()

Yields the associated reified unit type.

Returns:

Class

format

public java.lang.String format(TimeSpan<? super U> duration)

Creates a textual output of given duration.

Parameters:

duration - duration object

Returns:

textual representation of duration

Throws:

java.lang.IllegalArgumentException - if some aspects of duration prevents printing (for example too many nanoseconds)

print

public void print(TimeSpan<? super U> duration,
                  java.lang.Appendable buffer)
           throws java.io.IOException

Creates a textual output of given duration and writes to the buffer.

Parameters:

duration - duration object

buffer - I/O-buffer where the result is written to

Throws:

java.lang.IllegalArgumentException - if some aspects of duration prevents printing (for example too many nanoseconds)

java.io.IOException - if writing into buffer fails

parse

public S parse(java.lang.CharSequence text)
        throws java.text.ParseException

Equivalent to parse(text, 0).

Parameters:

text - custom textual representation to be parsed

Returns:

parsed duration

Throws:

java.text.ParseException - (for example in case of mixed signs)

See Also:

parse(CharSequence, int)

parse

public S parse(java.lang.CharSequence text,
               int offset)
        throws java.text.ParseException

Analyzes given text according to format pattern and parses the text to a duration.

Parameters:

text - custom textual representation to be parsed

offset - start position for the parser

Returns:

parsed duration

Throws:

java.text.ParseException - (for example in case of mixed signs)