javax.faces.convert
Class DateTimeConverter

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

All Implemented Interfaces:

PartialStateHolder, StateHolder, Converter

@JSFConverter(name="f:convertDateTime",
              bodyContent="empty",
              tagClass="org.apache.myfaces.taglib.core.ConvertDateTimeTag")
@JSFJspProperty(name="binding",
                returnType="javax.faces.convert.DateTimeConverter",
                longDesc="A ValueExpression that evaluates to a DateTimeConverter.")
public class DateTimeConverter
extends java.lang.Object
implements Converter, PartialStateHolder

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: 881558 $ $Date: 2009-11-17 16:55:58 -0500 (Tue, 17 Nov 2009) $

Author:

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

Field Summary

static java.lang.String	CONVERTER_ID
static java.lang.String	DATE_ID
static java.lang.String	DATETIME_ID
static java.lang.String	STRING_ID
static java.lang.String	TIME_ID

Constructor Summary

DateTimeConverter()

Method Summary

void	clearInitialState()
java.lang.Object	getAsObject(FacesContext facesContext, UIComponent uiComponent, java.lang.String value)
java.lang.String	getAsString(FacesContext facesContext, UIComponent uiComponent, 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	initialStateMarked()
boolean	isTransient()
void	markInitialState()
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

DATE_ID

public static final java.lang.String DATE_ID

See Also:

Constant Field Values

DATETIME_ID

public static final java.lang.String DATETIME_ID

See Also:

Constant Field Values

STRING_ID

public static final java.lang.String STRING_ID

See Also:

Constant Field Values

TIME_ID

public static final java.lang.String TIME_ID

See Also:

Constant Field Values

Constructor Detail

DateTimeConverter

public DateTimeConverter()

Method Detail

getAsObject

public java.lang.Object getAsObject(FacesContext facesContext,
                                    UIComponent uiComponent,
                                    java.lang.String value)

Specified by:

getAsObject in interface Converter

getAsString

public java.lang.String getAsString(FacesContext facesContext,
                                    UIComponent uiComponent,
                                    java.lang.Object value)

Specified by:

getAsString in interface Converter

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

@JSFProperty
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

@JSFProperty
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

@JSFProperty
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

@JSFProperty
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

@JSFProperty
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

@JSFProperty
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)

clearInitialState

public void clearInitialState()

Specified by:

clearInitialState in interface PartialStateHolder

initialStateMarked

public boolean initialStateMarked()

Specified by:

initialStateMarked in interface PartialStateHolder

markInitialState

public void markInitialState()

Specified by:

markInitialState in interface PartialStateHolder