Configures basic date formatting for use with Spring, primarily for org.springframework.format.annotation.DateTimeFormat declarations. Applies to fields of type Date, Calendar and long.

Designed for direct instantiation but also exposes the static addDateConverters(ConverterRegistry) utility method for ad-hoc use against any ConverterRegistry instance.

Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	DateFormatterRegistrar.CalendarToDateConverter
private static class	DateFormatterRegistrar.CalendarToLongConverter
private static class	DateFormatterRegistrar.DateToCalendarConverter
private static class	DateFormatterRegistrar.DateToLongConverter
private static class	DateFormatterRegistrar.LongToCalendarConverter
private static class	DateFormatterRegistrar.LongToDateConverter

Field Summary

Modifier and Type	Field and Description
private DateFormatter	dateFormatter

Access	Constructor and Description
public	DateFormatterRegistrar()

Method Summary

Modifier and Type	Method and Description
public static void	addDateConverters(ConverterRegistry the registry of converters to add to converterRegistry) Add date converters to the specified registry.
public void	registerFormatters(FormatterRegistry the FormatterRegistry instance to use. registry) Implements org.springframework.format.FormatterRegistrar.registerFormatters. Register Formatters and Converters with a FormattingConversionService through a FormatterRegistry SPI.
public void	setFormatter(DateFormatter dateFormatter) Set a global date formatter to register.

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

Field Detail

dateFormatter	back to summary
private DateFormatter dateFormatter Annotations @Nullable

DateFormatterRegistrar	back to summary
public DateFormatterRegistrar()

Method Detail

addDateConverters	back to summary
public static void addDateConverters(ConverterRegistry converterRegistry) Add date converters to the specified registry. Parameters converterRegistry:ConverterRegistry the registry of converters to add to

addDateConverters

back to summary

public static void addDateConverters(ConverterRegistry converterRegistry)

Add date converters to the specified registry.

Parameters

converterRegistry:ConverterRegistry: the registry of converters to add to

registerFormatters	back to summary
public void registerFormatters(FormatterRegistry registry) Implements org.springframework.format.FormatterRegistrar.registerFormatters. Doc from org.springframework.format.FormatterRegistrar.registerFormatters. Register Formatters and Converters with a FormattingConversionService through a FormatterRegistry SPI. Parameters registry:FormatterRegistry the FormatterRegistry instance to use. Annotations @Override

registerFormatters

back to summary

public void registerFormatters(FormatterRegistry registry)

Implements org.springframework.format.FormatterRegistrar.registerFormatters.

Doc from org.springframework.format.FormatterRegistrar.registerFormatters.

Parameters

registry:FormatterRegistry: the FormatterRegistry instance to use.

Annotations

@Override

setFormatter back to summary

setFormatter	back to summary
public void setFormatter(DateFormatter dateFormatter) Set a global date formatter to register. If not specified, no general formatter for non-annotated `Date` and `Calendar` fields will be registered.

public void setFormatter(DateFormatter dateFormatter)

Set a global date formatter to register.

If not specified, no general formatter for non-annotated Date and Calendar fields will be registered.

org.springframework.format.datetime back to summary

private Class DateFormatterRegistrar.CalendarToDateConverter

Class Inheritance

extends Object
implements Converter<Calendar, Date>

java.lang.Object
org.springframework.format.datetime.DateFormatterRegistrar.CalendarToDateConverter

All Implemented Interfaces

org.springframework.core.convert.converter.Converter

Constructor Summary

Access	Constructor and Description
private	CalendarToDateConverter()

Method Summary

Modifier and Type	Method and Description
public Date	convert(Calendar the source object to convert, which must be an instance of `S` (never `null`) source) Implements org.springframework.core.convert.converter.Converter.convert. Convert the source object of type `S` to target type `T`.

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

Constructor Detail

CalendarToDateConverter	back to summary
private CalendarToDateConverter()

Method Detail

convert back to summary

convert	back to summary
public Date convert(Calendar source) Implements org.springframework.core.convert.converter.Converter.convert. Doc from org.springframework.core.convert.converter.Converter.convert. Convert the source object of type `S` to target type `T`. Parameters source:Calendar the source object to convert, which must be an instance of `S` (never `null`) Returns:Date the converted object, which must be an instance of `T` (potentially `null`) Annotations @Override

public Date convert(Calendar source)

Implements org.springframework.core.convert.converter.Converter.convert.

Doc from org.springframework.core.convert.converter.Converter.convert.

Convert the source object of type S to target type T.

Parameters

source:Calendar: the source object to convert, which must be an instance of S (never null)

Returns:Date

the converted object, which must be an instance of T (potentially null)

Annotations

@Override

org.springframework.format.datetime back to summary

private Class DateFormatterRegistrar.CalendarToLongConverter

Class Inheritance

extends Object
implements Converter<Calendar, Long>

java.lang.Object
org.springframework.format.datetime.DateFormatterRegistrar.CalendarToLongConverter

All Implemented Interfaces

org.springframework.core.convert.converter.Converter

Constructor Summary

Access	Constructor and Description
private	CalendarToLongConverter()

Method Summary

Modifier and Type	Method and Description
public Long	convert(Calendar the source object to convert, which must be an instance of `S` (never `null`) source) Implements org.springframework.core.convert.converter.Converter.convert. Convert the source object of type `S` to target type `T`.

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

Constructor Detail

CalendarToLongConverter	back to summary
private CalendarToLongConverter()

Method Detail

convert back to summary

convert	back to summary
public Long convert(Calendar source) Implements org.springframework.core.convert.converter.Converter.convert. Doc from org.springframework.core.convert.converter.Converter.convert. Convert the source object of type `S` to target type `T`. Parameters source:Calendar the source object to convert, which must be an instance of `S` (never `null`) Returns:Long the converted object, which must be an instance of `T` (potentially `null`) Annotations @Override

public Long convert(Calendar source)

Implements org.springframework.core.convert.converter.Converter.convert.

Doc from org.springframework.core.convert.converter.Converter.convert.

Convert the source object of type S to target type T.

Parameters

source:Calendar: the source object to convert, which must be an instance of S (never null)

Returns:Long

the converted object, which must be an instance of T (potentially null)

Annotations

@Override

org.springframework.format.datetime back to summary

private Class DateFormatterRegistrar.DateToCalendarConverter

Class Inheritance

extends Object
implements Converter<Date, Calendar>

java.lang.Object
org.springframework.format.datetime.DateFormatterRegistrar.DateToCalendarConverter

All Implemented Interfaces

org.springframework.core.convert.converter.Converter

Constructor Summary

Access	Constructor and Description
private	DateToCalendarConverter()

Method Summary

Modifier and Type	Method and Description
public Calendar	convert(Date the source object to convert, which must be an instance of `S` (never `null`) source) Implements org.springframework.core.convert.converter.Converter.convert. Convert the source object of type `S` to target type `T`.

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

Constructor Detail

DateToCalendarConverter	back to summary
private DateToCalendarConverter()

Method Detail

convert back to summary

convert	back to summary
public Calendar convert(Date source) Implements org.springframework.core.convert.converter.Converter.convert. Doc from org.springframework.core.convert.converter.Converter.convert. Convert the source object of type `S` to target type `T`. Parameters source:Date the source object to convert, which must be an instance of `S` (never `null`) Returns:Calendar the converted object, which must be an instance of `T` (potentially `null`) Annotations @Override

public Calendar convert(Date source)

Implements org.springframework.core.convert.converter.Converter.convert.

Doc from org.springframework.core.convert.converter.Converter.convert.

Convert the source object of type S to target type T.

Parameters

source:Date: the source object to convert, which must be an instance of S (never null)

Returns:Calendar

the converted object, which must be an instance of T (potentially null)

Annotations

@Override

org.springframework.format.datetime back to summary

private Class DateFormatterRegistrar.DateToLongConverter

Class Inheritance

extends Object
implements Converter<Date, Long>

java.lang.Object
org.springframework.format.datetime.DateFormatterRegistrar.DateToLongConverter

All Implemented Interfaces

org.springframework.core.convert.converter.Converter

Constructor Summary

Access	Constructor and Description
private	DateToLongConverter()

Method Summary

Modifier and Type	Method and Description
public Long	convert(Date the source object to convert, which must be an instance of `S` (never `null`) source) Implements org.springframework.core.convert.converter.Converter.convert. Convert the source object of type `S` to target type `T`.

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

Constructor Detail

DateToLongConverter	back to summary
private DateToLongConverter()

Method Detail

convert back to summary

convert	back to summary
public Long convert(Date source) Implements org.springframework.core.convert.converter.Converter.convert. Doc from org.springframework.core.convert.converter.Converter.convert. Convert the source object of type `S` to target type `T`. Parameters source:Date the source object to convert, which must be an instance of `S` (never `null`) Returns:Long the converted object, which must be an instance of `T` (potentially `null`) Annotations @Override

public Long convert(Date source)

Implements org.springframework.core.convert.converter.Converter.convert.

Doc from org.springframework.core.convert.converter.Converter.convert.

Convert the source object of type S to target type T.

Parameters

source:Date: the source object to convert, which must be an instance of S (never null)

Returns:Long

the converted object, which must be an instance of T (potentially null)

Annotations

@Override

org.springframework.format.datetime back to summary

private Class DateFormatterRegistrar.LongToCalendarConverter

Class Inheritance

extends Object
implements Converter<Long, Calendar>

java.lang.Object
org.springframework.format.datetime.DateFormatterRegistrar.LongToCalendarConverter

All Implemented Interfaces

org.springframework.core.convert.converter.Converter

Constructor Summary

Access	Constructor and Description
private	LongToCalendarConverter()

Method Summary

Modifier and Type	Method and Description
public Calendar	convert(Long the source object to convert, which must be an instance of `S` (never `null`) source) Implements org.springframework.core.convert.converter.Converter.convert. Convert the source object of type `S` to target type `T`.

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

Constructor Detail

LongToCalendarConverter	back to summary
private LongToCalendarConverter()

Method Detail

convert back to summary

convert	back to summary
public Calendar convert(Long source) Implements org.springframework.core.convert.converter.Converter.convert. Doc from org.springframework.core.convert.converter.Converter.convert. Convert the source object of type `S` to target type `T`. Parameters source:Long the source object to convert, which must be an instance of `S` (never `null`) Returns:Calendar the converted object, which must be an instance of `T` (potentially `null`) Annotations @Override

public Calendar convert(Long source)

Implements org.springframework.core.convert.converter.Converter.convert.

Doc from org.springframework.core.convert.converter.Converter.convert.

Convert the source object of type S to target type T.

Parameters

source:Long: the source object to convert, which must be an instance of S (never null)

Returns:Calendar

the converted object, which must be an instance of T (potentially null)

Annotations

@Override

org.springframework.format.datetime back to summary

private Class DateFormatterRegistrar.LongToDateConverter

Class Inheritance

extends Object
implements Converter<Long, Date>

java.lang.Object
org.springframework.format.datetime.DateFormatterRegistrar.LongToDateConverter

All Implemented Interfaces

org.springframework.core.convert.converter.Converter

Constructor Summary

Access	Constructor and Description
private	LongToDateConverter()

Method Summary

Modifier and Type	Method and Description
public Date	convert(Long the source object to convert, which must be an instance of `S` (never `null`) source) Implements org.springframework.core.convert.converter.Converter.convert. Convert the source object of type `S` to target type `T`.

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

Constructor Detail

LongToDateConverter	back to summary
private LongToDateConverter()

Method Detail

convert back to summary

convert	back to summary
public Date convert(Long source) Implements org.springframework.core.convert.converter.Converter.convert. Doc from org.springframework.core.convert.converter.Converter.convert. Convert the source object of type `S` to target type `T`. Parameters source:Long the source object to convert, which must be an instance of `S` (never `null`) Returns:Date the converted object, which must be an instance of `T` (potentially `null`) Annotations @Override

public Date convert(Long source)

Implements org.springframework.core.convert.converter.Converter.convert.

Doc from org.springframework.core.convert.converter.Converter.convert.

Convert the source object of type S to target type T.

Parameters

source:Long: the source object to convert, which must be an instance of S (never null)

Returns:Date

the converted object, which must be an instance of T (potentially null)

Annotations

@Override

public Class DateFormatterRegistrar

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class DateFormatterRegistrar.CalendarToDateConverter

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class DateFormatterRegistrar.CalendarToLongConverter

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class DateFormatterRegistrar.DateToCalendarConverter

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class DateFormatterRegistrar.DateToLongConverter

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class DateFormatterRegistrar.LongToCalendarConverter

Constructor Summary

Method Summary

Constructor Detail

Method Detail

private Class DateFormatterRegistrar.LongToDateConverter

Constructor Summary

Method Summary

Constructor Detail

Method Detail