EE4J 10.0.0 · jakarta.faces.convert.DateTimeConverter

Converter implementation for java.util.Date values.

The getAsObject() method parses a String into a java.util.Date, according to the following algorithm:

If the specified String is null, return a null. Otherwise, trim leading and trailing whitespace before proceeding.
If the specified String - after trimming - has a zero length, return null.
If the locale property is not null, use that Locale for managing parsing. Otherwise, use the Locale from the UIViewRoot.
If a pattern has been specified, its syntax must conform the rules specified by java.text.SimpleDateFormat or java.time.format.DateTimeFormatter. Which of these two formatters is used depends on the value of type. Such a pattern will be used to parse, and the type, dateStyle, and timeStyle properties will be ignored, unless the value of type is one of the java.time specific values listed in setType. In this case, DateTimeFormatter.ofPattern(String, Locale) must be called, passing the value of pattern as the first argument and the current Locale as the second argument, and this formatter must be used to parse the incoming value.
If a pattern has not been specified, parsing will be based on the type property, which expects a date value, a time value, both, or one of several values specific to classes in java.time as listed in setType. Any date and time values included will be parsed in accordance to the styles specified by dateStyle and timeStyle, respectively.
If a timezone has been specified, it must be passed to the underlying DateFormat instance. Otherwise the "GMT" timezone is used.
In all cases, parsing must be non-lenient; the given string must strictly adhere to the parsing format.

The getAsString() method expects a value of type java.util.Date (or a subclass), and creates a formatted String according to the following algorithm:

If the specified value is null, return a zero-length String.
If the specified value is a String, return it unmodified.
If the locale property is not null, use that Locale for managing formatting. Otherwise, use the Locale from the UIViewRoot.
If a timezone has been specified, it must be passed to the underlying DateFormat instance. Otherwise the "GMT" timezone is used.
If a pattern has been specified, its syntax must conform the rules specified by java.text.SimpleDateFormat or java.time.format.DateTimeFormatter. Which of these two formatters is used depends on the value of type. Such a pattern will be used to format, and the type, dateStyle, and timeStyle properties will be ignored, unless the value of type is one of the java.time specific values listed in setType. In this case, DateTimeFormatter.ofPattern(String, Locale) must be called, passing the value of pattern as the first argument and the current Locale as the second argument, and this formatter must be used to format the outgoing value.
If a pattern has not been specified, formatting will be based on the type property, which includes a date value, a time value, both or into the formatted String. Any date and time values included will be formatted in accordance to the styles specified by dateStyle and timeStyle, respectively.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	DateTimeConverter.FormatWrapper

Field Summary

Modifier and Type	Field and Description
public static final String	CONVERTER_ID The standard converter id for this converter.
public static final String	DATE_ID The message identifier of the `jakarta.faces.application.FacesMessage` to be created if the conversion to `Date` fails.
private String	dateStyle
public static final String	DATETIME_ID The message identifier of the `jakarta.faces.application.FacesMessage` to be created if the conversion to `DateTime` fails.
private static final TimeZone	DEFAULT_TIME_ZONE
private boolean	initialState
private Locale	locale
private String	pattern
public static final String	STRING_ID The message identifier of the `jakarta.faces.application.FacesMessage` to be created if the conversion of the `DateTime` value to `String` fails.
public static final String	TIME_ID The message identifier of the `jakarta.faces.application.FacesMessage` to be created if the conversion to `Time` fails.
private String	timeStyle
private TimeZone	timeZone
private boolean	transientFlag
private String	type

Constructor Summary

Access	Constructor and Description
public	DateTimeConverter()

Method Summary

Modifier and Type	Method and Description
public void	clearInitialState() Implements jakarta.faces.component.PartialStateHolder.clearInitialState. Reset the PartialStateHolder to a non-delta tracking state.
public Object	getAsObject(FacesContext `FacesContext` for the request being processed context, UIComponent `UIComponent` with which this model object value is associated component, String String value to be converted (may be `null`) value) Implements jakarta.faces.convert.Converter.getAsObject. Convert the specified string value, which is associated with the specified `UIComponent`, into a model data object that is appropriate for being stored during the Process Validations phase of the request processing lifecycle.
public String	getAsString(FacesContext `FacesContext` for the request being processed context, UIComponent `UIComponent` with which this model object value is associated component, Object Model object value to be converted (may be `null`) value) Implements jakarta.faces.convert.Converter.getAsString. Convert the specified model object value, which is associated with the specified `UIComponent`, into a String that is suitable for being included in the response generated during the Render Response phase of the request processing lifeycle.
private DateTimeConverter.FormatWrapper	getDateFormat(Locale The `Locale` used to select formatting and parsing conventions locale) Return a `DateFormat` instance to use for formatting and parsing in this `Converter`.
public String	Returns: the style getDateStyle() Return the style to be used to format or parse dates.
private static FormatStyle	getFormatStyle(String name)
public Locale	Returns: the `Locale` getLocale() Return the `Locale` to be used when parsing or formatting dates and times.
private Locale	getLocale(FacesContext The `FacesContext` for the current request context) Return the `Locale` we will use for localizing our formatting and parsing processing.
public String	Returns: the pattern getPattern() Return the format pattern to be used when formatting and parsing dates and times.
private static int	getStyle(String Name of the style for which to return a constant name) Return the style constant for the specified style name.
public String	Returns: the time style getTimeStyle() Return the style to be used to format or parse times.
public TimeZone	Returns: the `TimeZone` getTimeZone() Return the `TimeZone` used to interpret a time value.
public String	Returns: the type getType() Return the type of value to be formatted or parsed.
public boolean	initialStateMarked() Implements jakarta.faces.component.PartialStateHolder.initialStateMarked. Return `true` if delta state changes are being tracked, otherwise `false`
private static boolean	isJavaTimeType(String type)
public boolean	isTransient() Implements jakarta.faces.component.StateHolder.isTransient. If true, the Object implementing this interface must not participate in state saving or restoring.
public void	markInitialState() Implements jakarta.faces.component.PartialStateHolder.markInitialState. The runtime must ensure that the `markInitialState` method is called on each instance of this interface in the view at the appropriate time to indicate the component is in its initial state.
public void	restoreState(FacesContext the Faces context. context, Object the state. state) Implements jakarta.faces.component.StateHolder.restoreState. Perform any processing required to restore the state from the entries in the state Object.
public Object	saveState(FacesContext the Faces context. context) Implements jakarta.faces.component.StateHolder.saveState. Gets the state of the instance as a `Serializable` Object.
public void	setDateStyle(String The new style code dateStyle) Set the style to be used to format or parse dates.
public void	setLocale(Locale The new `Locale` (or `null`) locale) Set the `Locale` to be used when parsing or formatting dates and times.
public void	setPattern(String The new format pattern pattern) Set the format pattern to be used when formatting and parsing dates and times.
public void	setTimeStyle(String The new style code timeStyle) Set the style to be used to format or parse times.
public void	setTimeZone(TimeZone The new time zone timeZone) Set the `TimeZone` used to interpret a time value.
public void	setTransient(boolean boolean pass `true` if this Object will not participate in state saving or restoring, otherwise pass `false`. transientFlag) Implements jakarta.faces.component.StateHolder.setTransient. Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.
public void	setType(String The new date style type) Set the type of value to be formatted or parsed.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

CONVERTER_ID	back to summary
public static final String CONVERTER_ID The standard converter id for this converter.

DATE_ID back to summary

DATE_ID	back to summary
public static final String DATE_ID The message identifier of the `jakarta.faces.application.FacesMessage` to be created if the conversion to `Date` fails. The message format string for this message may optionally include the following placeholders: `{0}` replaced by the unconverted value. `{1}` replaced by an example value. `{2}` replaced by a `String` whose value is the label of the input component that produced this message.

public static final String DATE_ID

The message identifier of the jakarta.faces.application.FacesMessage to be created if the conversion to Date fails. The message format string for this message may optionally include the following placeholders:

{0} replaced by the unconverted value.
{1} replaced by an example value.
{2} replaced by a String whose value is the label of the input component that produced this message.

dateStyle	back to summary
private String dateStyle

DATETIME_ID back to summary

DATETIME_ID	back to summary
public static final String DATETIME_ID The message identifier of the `jakarta.faces.application.FacesMessage` to be created if the conversion to `DateTime` fails. The message format string for this message may optionally include the following placeholders: `{0}` replaced by the unconverted value. `{1}` replaced by an example value. `{2}` replaced by a `String` whose value is the label of the input component that produced this message.

public static final String DATETIME_ID

The message identifier of the jakarta.faces.application.FacesMessage to be created if the conversion to DateTime fails. The message format string for this message may optionally include the following placeholders:

{0} replaced by the unconverted value.
{1} replaced by an example value.
{2} replaced by a String whose value is the label of the input component that produced this message.

DEFAULT_TIME_ZONE	back to summary
private static final TimeZone DEFAULT_TIME_ZONE

initialState	back to summary
private boolean initialState

locale	back to summary
private Locale locale

pattern	back to summary
private String pattern

STRING_ID back to summary

STRING_ID	back to summary
public static final String STRING_ID The message identifier of the `jakarta.faces.application.FacesMessage` to be created if the conversion of the `DateTime` value to `String` fails. The message format string for this message may optionally include the following placeholders: `{0}` relaced by the unconverted value. `{1}` replaced by a `String` whose value is the label of the input component that produced this message.

public static final String STRING_ID

The message identifier of the jakarta.faces.application.FacesMessage to be created if the conversion of the DateTime value to String fails. The message format string for this message may optionally include the following placeholders:

{0} relaced by the unconverted value.
{1} replaced by a String whose value is the label of the input component that produced this message.

TIME_ID back to summary

TIME_ID	back to summary
public static final String TIME_ID The message identifier of the `jakarta.faces.application.FacesMessage` to be created if the conversion to `Time` fails. The message format string for this message may optionally include the following placeholders: `{0}` replaced by the unconverted value. `{1}` replaced by an example value. `{2}` replaced by a `String` whose value is the label of the input component that produced this message.

public static final String TIME_ID

The message identifier of the jakarta.faces.application.FacesMessage to be created if the conversion to Time fails. The message format string for this message may optionally include the following placeholders:

{0} replaced by the unconverted value.
{1} replaced by an example value.
{2} replaced by a String whose value is the label of the input component that produced this message.

timeStyle	back to summary
private String timeStyle

timeZone	back to summary
private TimeZone timeZone

transientFlag	back to summary
private boolean transientFlag

type	back to summary
private String type

Constructor Detail

DateTimeConverter	back to summary
public DateTimeConverter()

Method Detail

clearInitialState	back to summary
public void clearInitialState() Implements jakarta.faces.component.PartialStateHolder.clearInitialState. Doc from jakarta.faces.component.PartialStateHolder.clearInitialState. Reset the PartialStateHolder to a non-delta tracking state. Annotations @Override

clearInitialState

back to summary

public void clearInitialState()

Implements jakarta.faces.component.PartialStateHolder.clearInitialState.

Doc from jakarta.faces.component.PartialStateHolder.clearInitialState.

Reset the PartialStateHolder to a non-delta tracking state.

Annotations

@Override

getAsObject back to summary

getAsObject	back to summary
public Object getAsObject(FacesContext context, UIComponent component, String value) Implements jakarta.faces.convert.Converter.getAsObject. Doc from jakarta.faces.convert.Converter.getAsObject. Convert the specified string value, which is associated with the specified `UIComponent`, into a model data object that is appropriate for being stored during the Process Validations phase of the request processing lifecycle. Parameters context:FacesContext `FacesContext` for the request being processed component:UIComponent `UIComponent` with which this model object value is associated value:String String value to be converted (may be `null`) Returns:Object `null` if the value to convert is `null`, otherwise the result of the conversion Annotations @Override Exceptions ConverterException: if conversion cannot be successfully performed NullPointerException: if `context` or `component` is `null`

public Object getAsObject(FacesContext context, UIComponent component, String value)

Implements jakarta.faces.convert.Converter.getAsObject.

Doc from jakarta.faces.convert.Converter.getAsObject.

Convert the specified string value, which is associated with the specified UIComponent, into a model data object that is appropriate for being stored during the Process Validations phase of the request processing lifecycle.

Parameters

context:FacesContext: FacesContext for the request being processed
component:UIComponent: UIComponent with which this model object value is associated
value:String: String value to be converted (may be null)

Returns:Object

null if the value to convert is null, otherwise the result of the conversion

Annotations

@Override

Exceptions

ConverterException:: if conversion cannot be successfully performed
NullPointerException:: if context or component is null

getAsString back to summary

getAsString	back to summary
public String getAsString(FacesContext context, UIComponent component, Object value) Implements jakarta.faces.convert.Converter.getAsString. Doc from jakarta.faces.convert.Converter.getAsString. Convert the specified model object value, which is associated with the specified `UIComponent`, into a String that is suitable for being included in the response generated during the Render Response phase of the request processing lifeycle. Parameters context:FacesContext `FacesContext` for the request being processed component:UIComponent `UIComponent` with which this model object value is associated value:Object Model object value to be converted (may be `null`) Returns:String a zero-length String if value is `null`, otherwise the result of the conversion Annotations @Override Exceptions ConverterException: if conversion cannot be successfully performed NullPointerException: if `context` or `component` is `null`

public String getAsString(FacesContext context, UIComponent component, Object value)

Implements jakarta.faces.convert.Converter.getAsString.

Doc from jakarta.faces.convert.Converter.getAsString.

Convert the specified model object value, which is associated with the specified UIComponent, into a String that is suitable for being included in the response generated during the Render Response phase of the request processing lifeycle.

Parameters

context:FacesContext: FacesContext for the request being processed
component:UIComponent: UIComponent with which this model object value is associated
value:Object: Model object value to be converted (may be null)

Returns:String

a zero-length String if value is null, otherwise the result of the conversion

Annotations

@Override

Exceptions

ConverterException:: if conversion cannot be successfully performed
NullPointerException:: if context or component is null

getDateFormat back to summary

getDateFormat	back to summary
private DateTimeConverter.FormatWrapper getDateFormat(Locale locale) Return a `DateFormat` instance to use for formatting and parsing in this `Converter`. Parameters locale:Locale The `Locale` used to select formatting and parsing conventions Exceptions ConverterException: if no instance can be created

private DateTimeConverter.FormatWrapper getDateFormat(Locale locale)

Return a DateFormat instance to use for formatting and parsing in this Converter.

Parameters

locale:Locale: The Locale used to select formatting and parsing conventions

Exceptions

ConverterException:: if no instance can be created

getDateStyle back to summary

getDateStyle	back to summary
public String getDateStyle() Return the style to be used to format or parse dates. If not set, the default value, `default`, is returned. Returns:String the style

public String getDateStyle()

Return the style to be used to format or parse dates. If not set, the default value, default, is returned.

Returns:String: the style

getFormatStyle	back to summary
private static FormatStyle getFormatStyle(String name)

getLocale back to summary

getLocale	back to summary
public Locale getLocale() Return the `Locale` to be used when parsing or formatting dates and times. If not explicitly set, the `Locale` stored in the `jakarta.faces.component.UIViewRoot` for the current request is returned. Returns:Locale the `Locale`

public Locale getLocale()

Return the Locale to be used when parsing or formatting dates and times. If not explicitly set, the Locale stored in the jakarta.faces.component.UIViewRoot for the current request is returned.

Returns:Locale: the Locale

getLocale back to summary

getLocale	back to summary
private Locale getLocale(FacesContext context) Return the `Locale` we will use for localizing our formatting and parsing processing. Parameters context:FacesContext The `FacesContext` for the current request

private Locale getLocale(FacesContext context)

Return the Locale we will use for localizing our formatting and parsing processing.

Parameters

context:FacesContext: The FacesContext for the current request

getPattern	back to summary
public String getPattern() Return the format pattern to be used when formatting and parsing dates and times. Returns:String the pattern

getPattern

back to summary

public String getPattern()

Return the format pattern to be used when formatting and parsing dates and times.

Returns:String: the pattern

getStyle	back to summary
private static int getStyle(String name) Return the style constant for the specified style name. Parameters name:String Name of the style for which to return a constant Exceptions ConverterException: if the style name is not valid

getStyle

back to summary

private static int getStyle(String name)

Return the style constant for the specified style name.

Parameters

name:String: Name of the style for which to return a constant

Exceptions

ConverterException:: if the style name is not valid

getTimeStyle back to summary

getTimeStyle	back to summary
public String getTimeStyle() Return the style to be used to format or parse times. If not set, the default value, `default`, is returned. Returns:String the time style

public String getTimeStyle()

Return the style to be used to format or parse times. If not set, the default value, default, is returned.

Returns:String: the time style

getTimeZone back to summary

getTimeZone	back to summary
public TimeZone getTimeZone() Return the `TimeZone` used to interpret a time value. If not explicitly set, the default time zone of `GMT` returned. Returns:TimeZone the `TimeZone`

public TimeZone getTimeZone()

Return the TimeZone used to interpret a time value. If not explicitly set, the default time zone of GMT returned.

Returns:TimeZone: the TimeZone

getType back to summary

getType	back to summary
public String getType() Return the type of value to be formatted or parsed. If not explicitly set, the default type, `date` is returned. Returns:String the type

public String getType()

Return the type of value to be formatted or parsed. If not explicitly set, the default type, date is returned.

Returns:String: the type

initialStateMarked back to summary

initialStateMarked	back to summary
public boolean initialStateMarked() Implements jakarta.faces.component.PartialStateHolder.initialStateMarked. Doc from jakarta.faces.component.PartialStateHolder.initialStateMarked. Return `true` if delta state changes are being tracked, otherwise `false` Returns:boolean `true` if the initial state is marked, `false` otherwise. Annotations @Override

public boolean initialStateMarked()

Implements jakarta.faces.component.PartialStateHolder.initialStateMarked.

Doc from jakarta.faces.component.PartialStateHolder.initialStateMarked.

Return true if delta state changes are being tracked, otherwise false

Returns:boolean

true if the initial state is marked, false otherwise.

Annotations

@Override

isJavaTimeType	back to summary
private static boolean isJavaTimeType(String type)

isTransient back to summary

isTransient	back to summary
public boolean isTransient() Implements jakarta.faces.component.StateHolder.isTransient. Doc from jakarta.faces.component.StateHolder.isTransient. If true, the Object implementing this interface must not participate in state saving or restoring. Returns:boolean `true` if transient, `false` otherwise. Annotations @Override

public boolean isTransient()

Implements jakarta.faces.component.StateHolder.isTransient.

Doc from jakarta.faces.component.StateHolder.isTransient.

If true, the Object implementing this interface must not participate in state saving or restoring.

Returns:boolean

true if transient, false otherwise.

Annotations

@Override

markInitialState back to summary

markInitialState	back to summary
public void markInitialState() Implements jakarta.faces.component.PartialStateHolder.markInitialState. Doc from jakarta.faces.component.PartialStateHolder.markInitialState. The runtime must ensure that the `markInitialState` method is called on each instance of this interface in the view at the appropriate time to indicate the component is in its initial state. The implementor of the interface must ensure that `initialStateMarked` returns `true` from the time `markInitialState()` is called until `clearInitialState` is called, after which time `initialStateMarked()` must return `false`. Also, during the time that the instance returns `true` from `initialStateMarked()`, the implementation must return only the state that has changed in its implementation of `StateHolder#saveState`. Annotations @Override

public void markInitialState()

Implements jakarta.faces.component.PartialStateHolder.markInitialState.

Doc from jakarta.faces.component.PartialStateHolder.markInitialState.

The runtime must ensure that the markInitialState method is called on each instance of this interface in the view at the appropriate time to indicate the component is in its initial state. The implementor of the interface must ensure that initialStateMarked returns true from the time markInitialState() is called until clearInitialState is called, after which time initialStateMarked() must return false. Also, during the time that the instance returns true from initialStateMarked(), the implementation must return only the state that has changed in its implementation of StateHolder#saveState.

Annotations

@Override

restoreState back to summary

restoreState	back to summary
public void restoreState(FacesContext context, Object state) Implements jakarta.faces.component.StateHolder.restoreState. Doc from jakarta.faces.component.StateHolder.restoreState. Perform any processing required to restore the state from the entries in the state Object. If the class that implements this interface has references to instances that also implement StateHolder (such as a `UIComponent` with event handlers, validators, etc.) this method must call the `restoreState` method on all those instances as well. If the `state` argument is `null`, take no action and return. Parameters context:FacesContext the Faces context. state:Object the state. Annotations @Override

public void restoreState(FacesContext context, Object state)

Implements jakarta.faces.component.StateHolder.restoreState.

Doc from jakarta.faces.component.StateHolder.restoreState.

Perform any processing required to restore the state from the entries in the state Object.

If the class that implements this interface has references to instances that also implement StateHolder (such as a UIComponent with event handlers, validators, etc.) this method must call the restoreState method on all those instances as well.

If the state argument is null, take no action and return.

Parameters

context:FacesContext: the Faces context.
state:Object: the state.

Annotations

@Override

saveState back to summary

saveState	back to summary
public Object saveState(FacesContext context) Implements jakarta.faces.component.StateHolder.saveState. Doc from jakarta.faces.component.StateHolder.saveState. Gets the state of the instance as a `Serializable` Object. If the class that implements this interface has references to instances that implement StateHolder (such as a `UIComponent` with event handlers, validators, etc.) this method must call the `saveState` method on all those instances as well. This method must not save the state of children and facets. That is done via the `jakarta.faces.application.StateManager` This method must not alter the state of the implementing object. In other words, after executing this code: `Object state = component.saveState(facesContext);` `component` should be the same as before executing it. The return from this method must be `Serializable` Parameters context:FacesContext the Faces context. Returns:Object the saved state. Annotations @Override

public Object saveState(FacesContext context)

Implements jakarta.faces.component.StateHolder.saveState.

Doc from jakarta.faces.component.StateHolder.saveState.

Gets the state of the instance as a Serializable Object.

If the class that implements this interface has references to instances that implement StateHolder (such as a UIComponent with event handlers, validators, etc.) this method must call the saveState method on all those instances as well. This method must not save the state of children and facets. That is done via the jakarta.faces.application.StateManager

This method must not alter the state of the implementing object. In other words, after executing this code:


Object state = component.saveState(facesContext);

component should be the same as before executing it.

The return from this method must be Serializable

Parameters

context:FacesContext: the Faces context.

Returns:Object

the saved state.

Annotations

@Override

setDateStyle back to summary

setDateStyle	back to summary
public void setDateStyle(String dateStyle) Set the style to be used to format or parse dates. Valid values are `default`, `short`, `medium`, `long`, and `full`. An invalid value will cause a `ConverterException` when `getAsObject()` or `getAsString()` is called. Parameters dateStyle:String The new style code

public void setDateStyle(String dateStyle)

Set the style to be used to format or parse dates. Valid values are default, short, medium, long, and full. An invalid value will cause a ConverterException when getAsObject() or getAsString() is called.

Parameters

dateStyle:String: The new style code

setLocale back to summary

setLocale	back to summary
public void setLocale(Locale locale) Set the `Locale` to be used when parsing or formatting dates and times. If set to `null`, the `Locale` stored in the `jakarta.faces.component.UIViewRoot` for the current request will be utilized. Parameters locale:Locale The new `Locale` (or `null`)

public void setLocale(Locale locale)

Set the Locale to be used when parsing or formatting dates and times. If set to null, the Locale stored in the jakarta.faces.component.UIViewRoot for the current request will be utilized.

Parameters

locale:Locale: The new Locale (or null)

setPattern back to summary

setPattern	back to summary
public void setPattern(String pattern) Set the format pattern to be used when formatting and parsing dates and times. Valid values are those supported by `java.text.SimpleDateFormat`. An invalid value will cause a `ConverterException` when `getAsObject()` or `getAsString()` is called. Parameters pattern:String The new format pattern

public void setPattern(String pattern)

Set the format pattern to be used when formatting and parsing dates and times. Valid values are those supported by java.text.SimpleDateFormat. An invalid value will cause a ConverterException when getAsObject() or getAsString() is called.

Parameters

pattern:String: The new format pattern

setTimeStyle back to summary

setTimeStyle	back to summary
public void setTimeStyle(String timeStyle) Set the style to be used to format or parse times. Valid values are `default`, `short`, `medium`, `long`, and `full`. An invalid value will cause a `ConverterException` when `getAsObject()` or `getAsString()` is called. Parameters timeStyle:String The new style code

public void setTimeStyle(String timeStyle)

Set the style to be used to format or parse times. Valid values are default, short, medium, long, and full. An invalid value will cause a ConverterException when getAsObject() or getAsString() is called.

Parameters

timeStyle:String: The new style code

setTimeZone back to summary

setTimeZone	back to summary
public void setTimeZone(TimeZone timeZone) Set the `TimeZone` used to interpret a time value. Parameters timeZone:TimeZone The new time zone

public void setTimeZone(TimeZone timeZone)

Set the TimeZone used to interpret a time value.

Parameters

timeZone:TimeZone: The new time zone

setTransient back to summary

setTransient	back to summary
public void setTransient(boolean transientFlag) Implements jakarta.faces.component.StateHolder.setTransient. Doc from jakarta.faces.component.StateHolder.setTransient. Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring. Parameters transientFlag:boolean boolean pass `true` if this Object will not participate in state saving or restoring, otherwise pass `false`. Annotations @Override

public void setTransient(boolean transientFlag)

Implements jakarta.faces.component.StateHolder.setTransient.

Doc from jakarta.faces.component.StateHolder.setTransient.

Denotes whether or not the Object implementing this interface must or must not participate in state saving or restoring.

Parameters

transientFlag:boolean: boolean pass true if this Object will not participate in state saving or restoring, otherwise pass false.

Annotations

@Override

setType back to summary

setType	back to summary
public void setType(String type) Set the type of value to be formatted or parsed. Valid values are `both`, `date`, `time` `localDate`, `localDateTime`, `localTime`, `offsetTime`, `offsetDateTime`, or `zonedDateTime`. The values starting with "local", "offset" and "zoned" correspond to Java SE 8 Date Time API classes in package `java.time` with the name derived by upper casing the first letter. For example, `java.time.LocalDate` for the value `"localDate"`. An invalid value will cause a `ConverterException` when `getAsObject()` or `getAsString()` is called. Parameters type:String The new date style

public void setType(String type)

Set the type of value to be formatted or parsed. Valid values are both, date, time localDate, localDateTime, localTime, offsetTime, offsetDateTime, or zonedDateTime. The values starting with "local", "offset" and "zoned" correspond to Java SE 8 Date Time API classes in package java.time with the name derived by upper casing the first letter. For example, java.time.LocalDate for the value "localDate". An invalid value will cause a ConverterException when getAsObject() or getAsString() is called.

Parameters

type:String: The new date style

Modifier and Type	Field and Description
private final DateFormat	dateFormat
private final DateTimeFormatter	dateTimeFormatter
private final TemporalQuery<Object>	from

Modifier and Type	Method and Description
private String	format(Object obj)
private String	formatNow()
private Object	parse(CharSequence text)
private void	setTimeZone(TimeZone zone)

public Class DateTimeConverter

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class DateTimeConverter.FormatWrapper

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

Access	Constructor and Description
private	FormatWrapper(DateFormat dataFormat)
private	FormatWrapper(DateTimeFormatter dateTimeFormatter, TemporalQuery<Object> from)