javax.faces.convert
Class DateTimeConverter

java.lang.Object
  javax.faces.convert.DateTimeConverter

All Implemented Interfaces:

StateHolder, Converter

public class DateTimeConverter
extends java.lang.Object
implements Converter, StateHolder

This tag associates a date time converter with the nearest parent UIComponent. Unless otherwise specified, all attributes accept static values or EL expressions. see Javadoc of JSF Specification

Version:

$Revision: 676278 $ $Date: 2008-07-13 03:35:04 -0500 (Sun, 13 Jul 2008) $

Author:

Thomas Spiegl (latest modification by $Author: skitching $)

Field Summary

static java.lang.String

CONVERTER_ID

Constructor Summary

DateTimeConverter()

Method Summary

java.lang.Object	getAsObject(FacesContext context, UIComponent component, java.lang.String value)
java.lang.String	getAsString(FacesContext context, UIComponent component, java.lang.Object value)
java.lang.String	getDateStyle() The style of the date.
java.util.Locale	getLocale() The name of the locale to be used, instead of the default.
java.lang.String	getPattern() A custom Date formatting pattern, in the format used by java.text.SimpleDateFormat.
java.lang.String	getTimeStyle() The style of the time.
java.util.TimeZone	getTimeZone() The time zone to use instead of GMT (the default timezone).
java.lang.String	getType() Specifies whether the date, time, or both should be parsed/formatted.
boolean	isTransient()
void	restoreState(FacesContext facesContext, java.lang.Object state)
java.lang.Object	saveState(FacesContext facesContext)
void	setDateStyle(java.lang.String dateStyle)
void	setLocale(java.util.Locale locale)
void	setPattern(java.lang.String pattern)
void	setTimeStyle(java.lang.String timeStyle)
void	setTimeZone(java.util.TimeZone timeZone)
void	setTransient(boolean aTransient)
void	setType(java.lang.String type)

Methods inherited from class java.lang.Object

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

Field Detail

CONVERTER_ID

public static final java.lang.String CONVERTER_ID

See Also:

Constant Field Values

Constructor Detail

DateTimeConverter

public DateTimeConverter()

Method Detail

getAsObject

public java.lang.Object getAsObject(FacesContext context,
                                    UIComponent component,
                                    java.lang.String value)
                             throws ConverterException

Specified by:

getAsObject in interface Converter

Throws:

ConverterException

getAsString

public java.lang.String getAsString(FacesContext context,
                                    UIComponent component,
                                    java.lang.Object value)
                             throws ConverterException

Specified by:

getAsString in interface Converter

Throws:

ConverterException

restoreState

public void restoreState(FacesContext facesContext,
                         java.lang.Object state)

Specified by:

restoreState in interface StateHolder

saveState

public java.lang.Object saveState(FacesContext facesContext)

Specified by:

saveState in interface StateHolder

getDateStyle

public java.lang.String getDateStyle()

The style of the date. Values include: default, short, medium, long, and full.

setDateStyle

public void setDateStyle(java.lang.String dateStyle)

getLocale

public java.util.Locale getLocale()

The name of the locale to be used, instead of the default.

setLocale

public void setLocale(java.util.Locale locale)

getPattern

public java.lang.String getPattern()

A custom Date formatting pattern, in the format used by java.text.SimpleDateFormat.

setPattern

public void setPattern(java.lang.String pattern)

getTimeStyle

public java.lang.String getTimeStyle()

The style of the time. Values include: default, short, medium, long, and full.

setTimeStyle

public void setTimeStyle(java.lang.String timeStyle)

getTimeZone

public java.util.TimeZone getTimeZone()

The time zone to use instead of GMT (the default timezone). When this value is a value-binding to a TimeZone instance, that timezone is used. Otherwise this value is treated as a String containing a timezone id, ie as the ID parameter of method java.util.TimeZone.getTimeZone(String).

setTimeZone

public void setTimeZone(java.util.TimeZone timeZone)

isTransient

public boolean isTransient()

Specified by:

isTransient in interface StateHolder

setTransient

public void setTransient(boolean aTransient)

Specified by:

setTransient in interface StateHolder

getType

public java.lang.String getType()

Specifies whether the date, time, or both should be parsed/formatted. Values include: date, time, and both. Default based on setting of timeStyle and dateStyle.

setType

public void setType(java.lang.String type)