Interface DatePrinter
-
- All Known Implementing Classes:
FastDateFormat
,FastDatePrinter
public interface DatePrinter
DatePrinter is the "missing" interface for the format methods ofDateFormat
. You can obtain an object implementing this interface by using one of the FastDateFormat factory methods.Warning: Since binary compatible methods may be added to this interface in any release, developers are not expected to implement this interface.
- Since:
- 3.2
-
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description String
format(long millis)
Formats a millisecondlong
value.<B extends Appendable>
Bformat(long millis, B buf)
Formats a millisecondlong
value into the suppliedAppendable
.StringBuffer
format(long millis, StringBuffer buf)
Deprecated.Use {format(long, Appendable)
.StringBuffer
format(Object obj, StringBuffer toAppendTo, FieldPosition pos)
Formats aDate
,Calendar
orLong
(milliseconds) object.String
format(Calendar calendar)
Formats aCalendar
object.<B extends Appendable>
Bformat(Calendar calendar, B buf)
Formats aCalendar
object into the suppliedAppendable
.StringBuffer
format(Calendar calendar, StringBuffer buf)
Deprecated.String
format(Date date)
Formats aDate
object using aGregorianCalendar
.<B extends Appendable>
Bformat(Date date, B buf)
Formats aDate
object into the suppliedAppendable
using aGregorianCalendar
.StringBuffer
format(Date date, StringBuffer buf)
Deprecated.Use {format(Date, Appendable)
.Locale
getLocale()
Gets the locale used by this printer.String
getPattern()
Gets the pattern used by this printer.TimeZone
getTimeZone()
Gets the time zone used by this printer.
-
-
-
Method Detail
-
format
String format(long millis)
Formats a millisecond
long
value.- Parameters:
millis
- the millisecond value to format- Returns:
- the formatted string
- Since:
- 2.1
-
format
String format(Date date)
Formats a
Date
object using aGregorianCalendar
.- Parameters:
date
- the date to format- Returns:
- the formatted string
-
format
String format(Calendar calendar)
Formats a
The TimeZone set on the Calendar is only used to adjust the time offset. The TimeZone specified during the construction of the Parser will determine the TimeZone used in the formatted string.Calendar
object.- Parameters:
calendar
- the calendar to format.- Returns:
- the formatted string
-
format
@Deprecated StringBuffer format(long millis, StringBuffer buf)
Deprecated.Use {format(long, Appendable)
.Formats a millisecond
long
value into the suppliedStringBuffer
.- Parameters:
millis
- the millisecond value to formatbuf
- the buffer to format into- Returns:
- the specified string buffer
-
format
@Deprecated StringBuffer format(Date date, StringBuffer buf)
Deprecated.Use {format(Date, Appendable)
.Formats a
Date
object into the suppliedStringBuffer
using aGregorianCalendar
.- Parameters:
date
- the date to formatbuf
- the buffer to format into- Returns:
- the specified string buffer
-
format
@Deprecated StringBuffer format(Calendar calendar, StringBuffer buf)
Deprecated.Formats a
The TimeZone set on the Calendar is only used to adjust the time offset. The TimeZone specified during the construction of the Parser will determine the TimeZone used in the formatted string.Calendar
object into the suppliedStringBuffer
.- Parameters:
calendar
- the calendar to formatbuf
- the buffer to format into- Returns:
- the specified string buffer
-
format
<B extends Appendable> B format(long millis, B buf)
Formats a millisecond
long
value into the suppliedAppendable
.- Type Parameters:
B
- the Appendable class type, usually StringBuilder or StringBuffer.- Parameters:
millis
- the millisecond value to formatbuf
- the buffer to format into- Returns:
- the specified string buffer
- Since:
- 3.5
-
format
<B extends Appendable> B format(Date date, B buf)
Formats a
Date
object into the suppliedAppendable
using aGregorianCalendar
.- Type Parameters:
B
- the Appendable class type, usually StringBuilder or StringBuffer.- Parameters:
date
- the date to formatbuf
- the buffer to format into- Returns:
- the specified string buffer
- Since:
- 3.5
-
format
<B extends Appendable> B format(Calendar calendar, B buf)
Formats a
The TimeZone set on the Calendar is only used to adjust the time offset. The TimeZone specified during the construction of the Parser will determine the TimeZone used in the formatted string.Calendar
object into the suppliedAppendable
.- Type Parameters:
B
- the Appendable class type, usually StringBuilder or StringBuffer.- Parameters:
calendar
- the calendar to formatbuf
- the buffer to format into- Returns:
- the specified string buffer
- Since:
- 3.5
-
getPattern
String getPattern()
Gets the pattern used by this printer.
- Returns:
- the pattern,
SimpleDateFormat
compatible
-
getTimeZone
TimeZone getTimeZone()
Gets the time zone used by this printer.
This zone is always used for
Date
printing.- Returns:
- the time zone
-
getLocale
Locale getLocale()
Gets the locale used by this printer.
- Returns:
- the locale
-
format
StringBuffer format(Object obj, StringBuffer toAppendTo, FieldPosition pos)
Formats a
Date
,Calendar
orLong
(milliseconds) object.- Parameters:
obj
- the object to formattoAppendTo
- the buffer to append topos
- the position - ignored- Returns:
- the buffer passed in
- See Also:
DateFormat.format(Object, StringBuffer, FieldPosition)
-
-