Conversions (univocity-parsers 2.9.1 API)

java.lang.Object
- com.univocity.parsers.conversions.Conversions

```
public class Conversions
extends Object
```
This class provides default instances of common implementations if com.univocity.parsers.conversions.Conversion, as well as useful methods for obtaining new instances of these.

Author:

Univocity Software Pty Ltd - parsers@univocity.com

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static FormattedBigDecimalConversion`	`formatToBigDecimal(BigDecimal defaultValueForNullString, String... numberFormats)` Returns a new instance of `FormattedBigDecimalConversion`
`static FormattedBigDecimalConversion`	`formatToBigDecimal(BigDecimal defaultValueForNullString, String stringIfNull, String... numberFormats)` Returns a new instance of `FormattedBigDecimalConversion`
`static FormattedBigDecimalConversion`	`formatToBigDecimal(String... numberFormats)` Returns a new instance of `FormattedBigDecimalConversion`
`static <T extends Number> NumericConversion<T>`	`formatToNumber(Class<T> numberType, String... numberFormats)` Returns a new instance of `NumericConversion`
`static NumericConversion<Number>`	`formatToNumber(String... numberFormats)` Returns a new instance of `NumericConversion`
`static ValidatedConversion`	`noneOf(String... noneOf)` Returns a new instance of `ValidatedConversion` to validate values of a record Nulls and blanks are not be allowed by default.
`static ValidatedConversion`	`notBlank()` Returns a `ValidatedConversion` that doesn't allow null or blank values
`static ValidatedConversion`	`notBlank(String regexToMatch)` Returns a `ValidatedConversion` that verifies the format of a given value
`static ValidatedConversion`	`notNull()` Returns a `ValidatedConversion` that doesn't allow null values
`static ValidatedConversion`	`oneOf(String... oneOf)` Returns a new instance of `ValidatedConversion` to validate values of a record Nulls and blanks are not be allowed by default.
`static RegexConversion`	`replace(String replaceRegex, String replacement)` Returns a new instance of `RegexConversion`
`static ToStringConversion`	`string()` Returns a singleton instance of `ToStringConversion`
`static BigDecimalConversion`	`toBigDecimal()` Returns a new instance of `BigDecimalConversion`
`static BigIntegerConversion`	`toBigInteger()` Returns a new instance of `BigIntegerConversion`
`static BooleanConversion`	`toBoolean()` Returns a new instance of `BooleanConversion` that converts the string "true" to true, and the String "false" to false.
`static BooleanConversion`	`toBoolean(Boolean defaultValueForNullString, String defaultValueForNullBoolean, String[] valuesForTrue, String[] valuesForFalse)` Returns a new instance of `BooleanConversion`
`static BooleanConversion`	`toBoolean(Boolean defaultValueForNullString, String defaultValueForNullBoolean, String valueForTrue, String valueForFalse)` Returns a new instance of `BooleanConversion`
`static BooleanConversion`	`toBoolean(String[] valuesForTrue, String[] valuesForFalse)` Returns a new instance of `BooleanConversion`
`static BooleanConversion`	`toBoolean(String valueForTrue, String valueForFalse)` Returns a new instance of `BooleanConversion`
`static ByteConversion`	`toByte()` Returns a new instance of `ByteConversion`
`static CalendarConversion`	`toCalendar(Calendar dateIfNull, String... dateFormats)` Returns a new instance of `CalendarConversion`
`static CalendarConversion`	`toCalendar(Calendar dateIfNull, String stringIfNull, String... dateFormats)` Returns a new instance of `CalendarConversion`
`static CalendarConversion`	`toCalendar(Locale locale, Calendar dateIfNull, String... dateFormats)` Returns a new instance of `CalendarConversion`
`static CalendarConversion`	`toCalendar(Locale locale, Calendar dateIfNull, String stringIfNull, String... dateFormats)` Returns a new instance of `CalendarConversion`
`static CalendarConversion`	`toCalendar(Locale locale, String... dateFormats)` Returns a new instance of `CalendarConversion`
`static CalendarConversion`	`toCalendar(String... dateFormats)` Returns a new instance of `CalendarConversion`
`static CalendarConversion`	`toCalendar(TimeZone timeZone, Locale locale, Calendar dateIfNull, String stringIfNull, String... dateFormats)` Returns a new instance of `CalendarConversion`
`static CharacterConversion`	`toChar()` Returns a new instance of `CharacterConversion`
`static CharacterConversion`	`toChar(Character defaultValueForNullString)` Returns a new instance of `CharacterConversion`
`static CharacterConversion`	`toChar(Character defaultValueForNullString, String defaultValueForNullChar)` Returns a new instance of `CharacterConversion`
`static DateConversion`	`toDate(Date dateIfNull, String... dateFormats)` Returns a new instance of `DateConversion`
`static DateConversion`	`toDate(Date dateIfNull, String stringIfNull, String... dateFormats)` Returns a new instance of `DateConversion`
`static DateConversion`	`toDate(Locale locale, Date dateIfNull, String... dateFormats)` Returns a new instance of `DateConversion`
`static DateConversion`	`toDate(Locale locale, Date dateIfNull, String stringIfNull, String... dateFormats)` Returns a new instance of `DateConversion`
`static DateConversion`	`toDate(Locale locale, String... dateFormats)` Returns a new instance of `DateConversion`
`static DateConversion`	`toDate(String... dateFormats)` Returns a new instance of `DateConversion`
`static DateConversion`	`toDate(TimeZone timeZone, Locale locale, Date dateIfNull, String stringIfNull, String... dateFormats)` Returns a new instance of `DateConversion`
`static DoubleConversion`	`toDouble()` Returns a new instance of `DoubleConversion`
`static <T extends Enum<T>> EnumConversion<T>`	`toEnum(Class<T> enumType)` Returns a new instance of `EnumConversion`
`static <T extends Enum<T>> EnumConversion<T>`	`toEnum(Class<T> enumType, EnumSelector... selectors)` Returns a new instance of `EnumConversion`
`static <T extends Enum<T>> EnumConversion<T>`	`toEnum(Class<T> enumType, String customEnumElement, EnumSelector... selectors)` Returns a new instance of `EnumConversion`
`static <T extends Enum<T>> EnumConversion<T>`	`toEnum(Class<T> enumType, T valueIfStringIsNull, String valueIfEnumIsNull, String customEnumElement, EnumSelector... selectors)` Returns a new instance of `EnumConversion`
`static FloatConversion`	`toFloat()` Returns a new instance of `FloatConversion`
`static FormattedDateConversion`	`toFormattedDate(String pattern)` Returns a new instance of `FormattedDateConversion`
`static FormattedDateConversion`	`toFormattedDate(String pattern, Locale locale)` Returns a new instance of `FormattedDateConversion`
`static FormattedDateConversion`	`toFormattedDate(String pattern, Locale locale, String valueIfObjectIsNull)` Returns a new instance of `FormattedDateConversion`
`static FormattedDateConversion`	`toFormattedDate(String pattern, String valueIfObjectIsNull)` Returns a new instance of `FormattedDateConversion`
`static IntegerConversion`	`toInteger()` Returns a new instance of `IntegerConversion`
`static LongConversion`	`toLong()` Returns a new instance of `LongConversion`
`static LowerCaseConversion`	`toLowerCase()` Returns a singleton instance of `LowerCaseConversion`
`static NullStringConversion`	`toNull(String... nullRepresentations)` Returns a new instance of `NullStringConversion`
`static ShortConversion`	`toShort()` Returns a new instance of `ShortConversion`
`static UpperCaseConversion`	`toUpperCase()` Returns a singleton instance of `UpperCaseConversion`
`static TrimConversion`	`trim()` Returns a singleton instance of `TrimConversion`
`static TrimConversion`	`trim(int length)` Returns a `TrimConversion` that limits the output to a fixed length
`static ValidatedConversion`	`validate(boolean nullable, boolean allowBlanks)` Returns a `ValidatedConversion` that checks for nulls or blank values.
`static ValidatedConversion`	`validate(boolean nullable, boolean allowBlanks, String regexToMatch)` Returns a `ValidatedConversion` that checks for nulls or blank values.
`static ValidatedConversion`	`validate(boolean nullable, boolean allowBlanks, String[] oneOf, String[] noneOf)` Returns a new instance of `ValidatedConversion` to validate values of a record
`static ValidatedConversion`	`validate(boolean nullable, boolean allowBlanks, String[] oneOf, String[] noneOf, String regexToMatch)` Returns a new instance of `ValidatedConversion` to validate values of a record

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - string
```
public static ToStringConversion string()
```
    Returns a singleton instance of ToStringConversion
    
    Returns:
    
    a singleton instance of ToStringConversion
  - toUpperCase
```
public static UpperCaseConversion toUpperCase()
```
    Returns a singleton instance of UpperCaseConversion
    
    Returns:
    
    a singleton instance of UpperCaseConversion
  - toLowerCase
```
public static LowerCaseConversion toLowerCase()
```
    Returns a singleton instance of LowerCaseConversion
    
    Returns:
    
    a singleton instance of LowerCaseConversion
  - trim
```
public static TrimConversion trim()
```
    Returns a singleton instance of TrimConversion
    
    Returns:
    
    a singleton instance of TrimConversion
  - trim
```
public static TrimConversion trim(int length)
```
    Returns a TrimConversion that limits the output to a fixed length
    
    Parameters:
    
    length - the maximum length a value can contain. Characters after this limit will be discarded.
    
    Returns:
    
    a trim-to-length conversion
  - replace
```
public static RegexConversion replace(String replaceRegex,
                                      String replacement)
```
    Returns a new instance of RegexConversion
    
    Parameters:
    
    replaceRegex - the regular expression used to match contents of a given input String
    
    replacement - the replacement content to replace any contents matched by the given regular expression
    
    Returns:
    
    the new instance of RegexConversion created with the given parameters.
  - toNull
```
public static NullStringConversion toNull(String... nullRepresentations)
```
    Returns a new instance of NullStringConversion
    
    Parameters:
    
    nullRepresentations - the sequence of Strings that represent a null value.
    
    Returns:
    
    the new instance of NullStringConversion created with the given parameters.
  - toDate
```
public static DateConversion toDate(Locale locale,
                                    String... dateFormats)
```
    Returns a new instance of DateConversion
    
    Parameters:
    
    locale - the Locale that determines how the date mask should be formatted.
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).
    
    Returns:
    
    the new instance of DateConversion created with the given parameters.
  - toDate
```
public static DateConversion toDate(String... dateFormats)
```
    Returns a new instance of DateConversion
    
    Parameters:
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).
    
    Returns:
    
    the new instance of DateConversion created with the given parameters.
  - toDate
```
public static DateConversion toDate(Locale locale,
                                    Date dateIfNull,
                                    String... dateFormats)
```
    Returns a new instance of DateConversion
    
    Parameters:
    
    locale - the Locale that determines how the date mask should be formatted.
    
    dateIfNull - default Date value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).
    
    Returns:
    
    the new instance of DateConversion created with the given parameters.
  - toDate
```
public static DateConversion toDate(Date dateIfNull,
                                    String... dateFormats)
```
    Returns a new instance of DateConversion
    
    Parameters:
    
    dateIfNull - default Date value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).
    
    Returns:
    
    the new instance of DateConversion created with the given parameters.
  - toDate
```
public static DateConversion toDate(TimeZone timeZone,
                                    Locale locale,
                                    Date dateIfNull,
                                    String stringIfNull,
                                    String... dateFormats)
```
    Returns a new instance of DateConversion
    
    Parameters:
    
    timeZone - the TimeZone of the date to be formatted
    
    locale - the Locale that determines how the date mask should be formatted.
    
    dateIfNull - default Date value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    stringIfNull - default String value to be returned when a Date input is null. Used when DateConversion.revert(Date) is invoked.
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).
    
    Returns:
    
    the new instance of DateConversion created with the given parameters.
  - toDate
```
public static DateConversion toDate(Locale locale,
                                    Date dateIfNull,
                                    String stringIfNull,
                                    String... dateFormats)
```
    Returns a new instance of DateConversion
    
    Parameters:
    
    locale - the Locale that determines how the date mask should be formatted.
    
    dateIfNull - default Date value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    stringIfNull - default String value to be returned when a Date input is null. Used when DateConversion.revert(Date) is invoked.
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).
    
    Returns:
    
    the new instance of DateConversion created with the given parameters.
  - toDate
```
public static DateConversion toDate(Date dateIfNull,
                                    String stringIfNull,
                                    String... dateFormats)
```
    Returns a new instance of DateConversion
    
    Parameters:
    
    dateIfNull - default Date value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    stringIfNull - default String value to be returned when a Date input is null. Used when DateConversion.revert(Date) is invoked.
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Date into a String in DateConversion.revert(Date).
    
    Returns:
    
    the new instance of DateConversion created with the given parameters.
  - toCalendar
```
public static CalendarConversion toCalendar(Locale locale,
                                            String... dateFormats)
```
    Returns a new instance of CalendarConversion
    
    Parameters:
    
    locale - the Locale that determines how the date mask should be formatted.
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).
    
    Returns:
    
    the new instance of CalendarConversion created with the given parameters.
  - toCalendar
```
public static CalendarConversion toCalendar(String... dateFormats)
```
    Returns a new instance of CalendarConversion
    
    Parameters:
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).
    
    Returns:
    
    the new instance of CalendarConversion created with the given parameters.
  - toCalendar
```
public static CalendarConversion toCalendar(Locale locale,
                                            Calendar dateIfNull,
                                            String... dateFormats)
```
    Returns a new instance of CalendarConversion
    
    Parameters:
    
    locale - the Locale that determines how the date mask should be formatted.
    
    dateIfNull - default Calendar value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).
    
    Returns:
    
    the new instance of CalendarConversion created with the given parameters.
  - toCalendar
```
public static CalendarConversion toCalendar(Calendar dateIfNull,
                                            String... dateFormats)
```
    Returns a new instance of CalendarConversion
    
    Parameters:
    
    dateIfNull - default Calendar value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).
    
    Returns:
    
    the new instance of CalendarConversion created with the given parameters.
  - toCalendar
```
public static CalendarConversion toCalendar(Locale locale,
                                            Calendar dateIfNull,
                                            String stringIfNull,
                                            String... dateFormats)
```
    Returns a new instance of CalendarConversion
    
    Parameters:
    
    locale - the Locale that determines how the date mask should be formatted.
    
    dateIfNull - default Calendar value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    stringIfNull - default String value to be returned when a Date input is null. Used when CalendarConversion.revert(Calendar) is invoked.
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).
    
    Returns:
    
    the new instance of CalendarConversion created with the given parameters.
  - toCalendar
```
public static CalendarConversion toCalendar(TimeZone timeZone,
                                            Locale locale,
                                            Calendar dateIfNull,
                                            String stringIfNull,
                                            String... dateFormats)
```
    Returns a new instance of CalendarConversion
    
    Parameters:
    
    timeZone - the TimeZone to be considered
    
    locale - the Locale that determines how the date mask should be formatted.
    
    dateIfNull - default Calendar value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    stringIfNull - default String value to be returned when a Date input is null. Used when CalendarConversion.revert(Calendar) is invoked.
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).
    
    Returns:
    
    the new instance of CalendarConversion created with the given parameters.
  - toCalendar
```
public static CalendarConversion toCalendar(Calendar dateIfNull,
                                            String stringIfNull,
                                            String... dateFormats)
```
    Returns a new instance of CalendarConversion
    
    Parameters:
    
    dateIfNull - default Calendar value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    stringIfNull - default String value to be returned when a Date input is null. Used when CalendarConversion.revert(Calendar) is invoked.
    
    dateFormats - list of acceptable date patterns. The first pattern in this sequence will be used to convert a Calendar into a String in CalendarConversion.revert(Calendar).
    
    Returns:
    
    the new instance of CalendarConversion created with the given parameters.
  - toByte
```
public static ByteConversion toByte()
```
    Returns a new instance of ByteConversion
    
    Returns:
    
    a new instance of ByteConversion
  - toShort
```
public static ShortConversion toShort()
```
    Returns a new instance of ShortConversion
    
    Returns:
    
    a new instance of ShortConversion
  - toInteger
```
public static IntegerConversion toInteger()
```
    Returns a new instance of IntegerConversion
    
    Returns:
    
    a new instance of IntegerConversion
  - toLong
```
public static LongConversion toLong()
```
    Returns a new instance of LongConversion
    
    Returns:
    
    a new instance of LongConversion
  - toBigInteger
```
public static BigIntegerConversion toBigInteger()
```
    Returns a new instance of BigIntegerConversion
    
    Returns:
    
    a new instance of BigIntegerConversion
  - toFloat
```
public static FloatConversion toFloat()
```
    Returns a new instance of FloatConversion
    
    Returns:
    
    a new instance of FloatConversion
  - toDouble
```
public static DoubleConversion toDouble()
```
    Returns a new instance of DoubleConversion
    
    Returns:
    
    a new instance of DoubleConversion
  - toBigDecimal
```
public static BigDecimalConversion toBigDecimal()
```
    Returns a new instance of BigDecimalConversion
    
    Returns:
    
    a new instance of BigDecimalConversion
  - formatToNumber
```
public static NumericConversion<Number> formatToNumber(String... numberFormats)
```
    Returns a new instance of NumericConversion
    
    Parameters:
    
    numberFormats - list of acceptable numeric patterns. The first pattern in this sequence will be used to convert a Number into a String in NumericConversion.revert(Number).
    
    Returns:
    
    a new instance of NumericConversion that supports the given number formats
  - formatToNumber
```
public static <T extends Number> NumericConversion<T> formatToNumber(Class<T> numberType,
                                                                     String... numberFormats)
```
    Returns a new instance of NumericConversion
    
    Type Parameters:
    
    T - type of number
    
    Parameters:
    
    numberType - type of number to be returned. The resulting instance of Number will be cast to the expected type.
    
    numberFormats - list of acceptable numeric patterns. The first pattern in this sequence will be used to convert a Number into a String in NumericConversion.revert(Number).
    
    Returns:
    
    a new instance of NumericConversion that supports the given number formats
  - formatToBigDecimal
```
public static FormattedBigDecimalConversion formatToBigDecimal(String... numberFormats)
```
    Returns a new instance of FormattedBigDecimalConversion
    
    Parameters:
    
    numberFormats - list of acceptable numeric patterns. The first pattern in this sequence will be used to convert a BigDecimal into a String in NumericConversion.revert(Number).
    
    Returns:
    
    a new instance of FormattedBigDecimalConversion that supports the given number formats
  - formatToBigDecimal
```
public static FormattedBigDecimalConversion formatToBigDecimal(BigDecimal defaultValueForNullString,
                                                               String... numberFormats)
```
    Returns a new instance of FormattedBigDecimalConversion
    
    Parameters:
    
    defaultValueForNullString - default BigDecimal to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    numberFormats - list of acceptable numeric patterns. The first pattern in this sequence will be used to convert a BigDecimal into a String in NumericConversion.revert(Number).
    
    Returns:
    
    a new instance of FormattedBigDecimalConversion that supports the given number formats
  - formatToBigDecimal
```
public static FormattedBigDecimalConversion formatToBigDecimal(BigDecimal defaultValueForNullString,
                                                               String stringIfNull,
                                                               String... numberFormats)
```
    Returns a new instance of FormattedBigDecimalConversion
    
    Parameters:
    
    defaultValueForNullString - default BigDecimal to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    stringIfNull - default String value to be returned when a BigDecimal input is null. Used when FormattedBigDecimalConversion#revert(BigDecimal) is invoked.
    
    numberFormats - list of acceptable numeric patterns. The first pattern in this sequence will be used to convert a BigDecimal into a String in NumericConversion.revert(Number).
    
    Returns:
    
    a new instance of FormattedBigDecimalConversion that supports the given number formats
  - toBoolean
```
public static BooleanConversion toBoolean(Boolean defaultValueForNullString,
                                          String defaultValueForNullBoolean,
                                          String[] valuesForTrue,
                                          String[] valuesForFalse)
```
    Returns a new instance of BooleanConversion
    
    Parameters:
    
    defaultValueForNullString - default Boolean value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    defaultValueForNullBoolean - default String value to be returned when a Boolean input is null. Used when BooleanConversion.revert(Boolean) is invoked.
    
    valuesForTrue - Strings that identify the boolean value true. The first element will be returned when executing BooleanConversion.revert(true)
    
    valuesForFalse - Strings that identify the boolean value false. The first element will be returned when executing BooleanConversion.revert(false)
    
    Returns:
    
    a new instance of BooleanConversion with support for multiple representations of true and false
  - toBoolean
```
public static BooleanConversion toBoolean(Boolean defaultValueForNullString,
                                          String defaultValueForNullBoolean,
                                          String valueForTrue,
                                          String valueForFalse)
```
    Returns a new instance of BooleanConversion
    
    Parameters:
    
    defaultValueForNullString - default Boolean value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    defaultValueForNullBoolean - default String value to be returned when a Boolean input is null. Used when BooleanConversion.revert(Boolean) is invoked.
    
    valueForTrue - String that identify the boolean value true.
    
    valueForFalse - String that identify the boolean value false.
    
    Returns:
    
    a new instance of BooleanConversion with support for multiple representations of true and false
  - toBoolean
```
public static BooleanConversion toBoolean(String[] valuesForTrue,
                                          String[] valuesForFalse)
```
    Returns a new instance of BooleanConversion
    
    Parameters:
    
    valuesForTrue - Strings that identify the boolean value true. The first element will be returned when executing BooleanConversion.revert(true)
    
    valuesForFalse - Strings that identify the boolean value false. The first element will be returned when executing BooleanConversion.revert(false)
    
    Returns:
    
    a new instance of BooleanConversion with support for multiple representations of true and false
  - toBoolean
```
public static BooleanConversion toBoolean()
```
    Returns a new instance of BooleanConversion that converts the string "true" to true, and the String "false" to false.
    
    Returns:
    
    a new instance of BooleanConversion with support for multiple representations of true and false
  - toBoolean
```
public static BooleanConversion toBoolean(String valueForTrue,
                                          String valueForFalse)
```
    Returns a new instance of BooleanConversion
    
    Parameters:
    
    valueForTrue - String that identifies the boolean value true.
    
    valueForFalse - String that identifies the boolean value false.
    
    Returns:
    
    a new instance of BooleanConversion with support for multiple representations of true and false
  - toChar
```
public static CharacterConversion toChar()
```
    Returns a new instance of CharacterConversion
    
    Returns:
    
    a new instance of CharacterConversion
  - toChar
```
public static CharacterConversion toChar(Character defaultValueForNullString,
                                         String defaultValueForNullChar)
```
    Returns a new instance of CharacterConversion
    
    Parameters:
    
    defaultValueForNullString - default Character value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    defaultValueForNullChar - default String value to be returned when a Character input is null. Used when CharacterConversion#revert(Character) is invoked.
    
    Returns:
    
    a new instance of CharacterConversion
  - toChar
```
public static CharacterConversion toChar(Character defaultValueForNullString)
```
    Returns a new instance of CharacterConversion
    
    Parameters:
    
    defaultValueForNullString - default Character value to be returned when the input String is null. Used when ObjectConversion.execute(String) is invoked.
    
    Returns:
    
    a new instance of CharacterConversion
  - toEnum
```
public static <T extends Enum<T>> EnumConversion<T> toEnum(Class<T> enumType)
```
    Returns a new instance of EnumConversion
    
    Type Parameters:
    
    T - the enum type
    
    Parameters:
    
    enumType - the enumeration type to be converted from/to String
    
    Returns:
    
    new instance of EnumConversion
  - toEnum
```
public static <T extends Enum<T>> EnumConversion<T> toEnum(Class<T> enumType,
                                                           EnumSelector... selectors)
```
    Returns a new instance of EnumConversion
    
    Type Parameters:
    
    T - the enum type
    
    Parameters:
    
    enumType - the enumeration type to be converted from/to String
    
    selectors - the selection elements of the enumeration to use for matching Strings.
    
    Returns:
    
    new instance of EnumConversion
  - toEnum
```
public static <T extends Enum<T>> EnumConversion<T> toEnum(Class<T> enumType,
                                                           String customEnumElement,
                                                           EnumSelector... selectors)
```
    Returns a new instance of EnumConversion
    
    Type Parameters:
    
    T - the enum type
    
    Parameters:
    
    enumType - the enumeration type to be converted from/to String
    
    customEnumElement - name of custom element of the enumeration (attribute or method) whose values should be used to match equivalent Strings.
    
    selectors - the selection elements of the enumeration to use for matching Strings.
    
    Returns:
    
    new instance of EnumConversion
  - toEnum
```
public static <T extends Enum<T>> EnumConversion<T> toEnum(Class<T> enumType,
                                                           T valueIfStringIsNull,
                                                           String valueIfEnumIsNull,
                                                           String customEnumElement,
                                                           EnumSelector... selectors)
```
    Returns a new instance of EnumConversion
    
    Type Parameters:
    
    T - the enum type
    
    Parameters:
    
    enumType - the enumeration type to be converted from/to String
    
    valueIfStringIsNull - the default enumeration constant to use if the input String is null
    
    valueIfEnumIsNull - the default String value to use if the input enum constant is null
    
    customEnumElement - name of custom element of the enumeration (attribute or method) whose values should be used to match equivalent Strings.
    
    selectors - the selection elements of the enumeration to use for matching Strings.
    
    Returns:
    
    new instance of EnumConversion
  - toFormattedDate
```
public static FormattedDateConversion toFormattedDate(String pattern)
```
    Returns a new instance of FormattedDateConversion
    
    Parameters:
    
    pattern - Date mask to be be used to convert a date object (i.e. Date or Calendar) into a String.
    
    Returns:
    
    new instance of FormattedDateConversion configured with the given parameters
  - toFormattedDate
```
public static FormattedDateConversion toFormattedDate(String pattern,
                                                      String valueIfObjectIsNull)
```
    Returns a new instance of FormattedDateConversion
    
    Parameters:
    
    pattern - Date mask to be be used to convert a date object (i.e. Date or Calendar) into a String.
    
    valueIfObjectIsNull - Default string value to be returned when the input object is null.
    
    Returns:
    
    new instance of FormattedDateConversion configured with the given parameters
  - toFormattedDate
```
public static FormattedDateConversion toFormattedDate(String pattern,
                                                      Locale locale)
```
    Returns a new instance of FormattedDateConversion
    
    Parameters:
    
    pattern - Date mask to be be used to convert a date object (i.e. Date or Calendar) into a String.
    
    locale - The Locale that determines how the date pattern should be formatted.
    
    Returns:
    
    new instance of FormattedDateConversion configured with the given parameters
  - toFormattedDate
```
public static FormattedDateConversion toFormattedDate(String pattern,
                                                      Locale locale,
                                                      String valueIfObjectIsNull)
```
    Returns a new instance of FormattedDateConversion
    
    Parameters:
    
    pattern - Date mask to be be used to convert a date object (i.e. Date or Calendar) into a String.
    
    locale - The Locale that determines how the date pattern should be formatted.
    
    valueIfObjectIsNull - Default string value to be returned when the input object is null.
    
    Returns:
    
    new instance of FormattedDateConversion configured with the given parameters
  - notNull
```
public static ValidatedConversion notNull()
```
    Returns a ValidatedConversion that doesn't allow null values
    
    Returns:
    
    a not-null validator
  - notBlank
```
public static ValidatedConversion notBlank()
```
    Returns a ValidatedConversion that doesn't allow null or blank values
    
    Returns:
    
    a not-blank validator
  - notBlank
```
public static ValidatedConversion notBlank(String regexToMatch)
```
    Returns a ValidatedConversion that verifies the format of a given value
    
    Parameters:
    
    regexToMatch - regular expression to match and ensure the value has a given format
    
    Returns:
    
    a value format validator
  - validate
```
public static ValidatedConversion validate(boolean nullable,
                                           boolean allowBlanks)
```
    Returns a ValidatedConversion that checks for nulls or blank values.
    
    Parameters:
    
    nullable - flag to indicate whether values can be null
    
    allowBlanks - flag to indicate whether values can be blank
    
    Returns:
    
    new instance of ValidatedConversion configured with the given parameters
  - validate
```
public static ValidatedConversion validate(boolean nullable,
                                           boolean allowBlanks,
                                           String[] oneOf,
                                           String[] noneOf)
```
    Returns a new instance of ValidatedConversion to validate values of a record
    
    Parameters:
    
    nullable - flag to indicate whether values can be null
    
    allowBlanks - flag to indicate whether values can be blank
    
    oneOf - list of accepted values.
    
    noneOf - list of unacceptable values
    
    Returns:
    
    new instance of ValidatedConversion configured with the given parameters
  - validate
```
public static ValidatedConversion validate(boolean nullable,
                                           boolean allowBlanks,
                                           String regexToMatch)
```
    Returns a ValidatedConversion that checks for nulls or blank values.
    
    Parameters:
    
    nullable - flag to indicate whether values can be null
    
    allowBlanks - flag to indicate whether values can be blank
    
    regexToMatch - regular expression to match and ensure the value has a given format
    
    Returns:
    
    new instance of ValidatedConversion configured with the given parameters
  - validate
```
public static ValidatedConversion validate(boolean nullable,
                                           boolean allowBlanks,
                                           String[] oneOf,
                                           String[] noneOf,
                                           String regexToMatch)
```
    Returns a new instance of ValidatedConversion to validate values of a record
    
    Parameters:
    
    nullable - flag to indicate whether values can be null
    
    allowBlanks - flag to indicate whether values can be blank
    
    oneOf - list of accepted values.
    
    noneOf - list of unacceptable values
    
    regexToMatch - regular expression to match and ensure the value has a given format
    
    Returns:
    
    new instance of ValidatedConversion configured with the given parameters
  - oneOf
```
public static ValidatedConversion oneOf(String... oneOf)
```
    Returns a new instance of ValidatedConversion to validate values of a record Nulls and blanks are not be allowed by default.
    
    Parameters:
    
    oneOf - list of accepted values.
    
    Returns:
    
    new instance of ValidatedConversion configured with the given parameters
  - noneOf
```
public static ValidatedConversion noneOf(String... noneOf)
```
    Returns a new instance of ValidatedConversion to validate values of a record Nulls and blanks are not be allowed by default.
    
    Parameters:
    
    noneOf - list of values that are not allowed.
    
    Returns:
    
    new instance of ValidatedConversion configured with the given parameters

Class Conversions

Method Summary

Methods inherited from class java.lang.Object

Method Detail

string

toUpperCase

toLowerCase

trim

trim

replace

toNull

toDate

toDate

toDate

toDate

toDate

toDate

toDate

toCalendar

toCalendar

toCalendar

toCalendar

toCalendar

toCalendar

toCalendar

toByte

toShort

toInteger

toLong

toBigInteger

toFloat

toDouble

toBigDecimal

formatToNumber

formatToNumber

formatToBigDecimal

formatToBigDecimal

formatToBigDecimal

toBoolean

toBoolean

toBoolean

toBoolean

toBoolean

toChar

toChar

toChar

toEnum

toEnum

toEnum

toEnum

toFormattedDate

toFormattedDate

toFormattedDate

toFormattedDate

notNull

notBlank

notBlank

validate

validate

validate

validate

oneOf

noneOf