public interface

PeriodPrinter

org.joda.time.format.PeriodPrinter

Class Overview

Internal interface for printing textual representations of time periods.

Application users will rarely use this class directly. Instead, you will use one of the factory classes to create a PeriodFormatter.

The factory classes are:
- PeriodFormatterBuilder
- PeriodFormat
- ISOPeriodFormat

Summary

Public Methods
abstract int calculatePrintedLength(ReadablePeriod period, Locale locale)
Returns the exact number of characters produced for the given period.
abstract int countFieldsToPrint(ReadablePeriod period, int stopAt, Locale locale)
Returns the amount of fields from the given period that this printer will print.
abstract void printTo(StringBuffer buf, ReadablePeriod period, Locale locale)
Prints a ReadablePeriod to a StringBuffer.
abstract void printTo(Writer out, ReadablePeriod period, Locale locale)
Prints a ReadablePeriod to a Writer.

Public Methods

public abstract int calculatePrintedLength (ReadablePeriod period, Locale locale)

Returns the exact number of characters produced for the given period.

Parameters
period the period to use
locale the locale to use
Returns
  • the estimated length

public abstract int countFieldsToPrint (ReadablePeriod period, int stopAt, Locale locale)

Returns the amount of fields from the given period that this printer will print.

Parameters
period the period to use
stopAt stop counting at this value, enter a number ≥ 256 to count all
locale the locale to use
Returns
  • amount of fields printed

public abstract void printTo (StringBuffer buf, ReadablePeriod period, Locale locale)

Prints a ReadablePeriod to a StringBuffer.

Parameters
buf the formatted period is appended to this buffer
period the period to format
locale the locale to use

public abstract void printTo (Writer out, ReadablePeriod period, Locale locale)

Prints a ReadablePeriod to a Writer.

Parameters
out the formatted period is written out
period the period to format
locale the locale to use
Throws
IOException