Field Detail

• INSTANCE

  static final DataHelper INSTANCE

  The default DataHelper.

Method Detail

• toDate

  java.util.Date toDate(java.lang.String dateString)

  Convert from a String representation of an SDO date type to a Date.

  Parameters:

  dateString - the String representation of an SDO date type

  Returns:

  a Date representation of an SDO date type.

  Throws:

  java.lang.IllegalArgumentException - for invalid formats.

• toCalendar

  java.util.Calendar toCalendar(java.lang.String dateString)

  Convert from a String representation of an SDO date type to a Calendar using the default locale. Same as toCalendar(dateString, null).

  Parameters:

  dateString - the String representation of an SDO date type

  Returns:

  a Calendar representation of an SDO date type.

  Throws:

  java.lang.IllegalArgumentException - for invalid formats.

• toCalendar

  java.util.Calendar toCalendar(java.lang.String dateString,
                              java.util.Locale locale)

  Convert from a String representation of an SDO date type to a Calendar using the specified locale, or the default locale if the locale is null.

  Parameters:

  dateString - the String representation of an SDO date type

  locale - the locale or null for default locale.

  Returns:

  a Calendar representation of an SDO date type.

  Throws:

  java.lang.IllegalArgumentException - for invalid formats.

• toDateTime

  java.lang.String toDateTime(java.util.Date date)

  Convert from a Date to a String representation of the DateTime type.

  Parameters:

  date - the date

  Returns:

  a Date to a String representation of the DateTime type.

• toDuration

  java.lang.String toDuration(java.util.Date date)

  Deprecated. There is no accepted algorithm to convert a date into a Duration so use of this method is discouraged. Convert from a Date to a String representation of the Duration type.

  Parameters:

  date - the date

  Returns:

  a Date to a String representation of the Duration type.

• toTime

  java.lang.String toTime(java.util.Date date)

  Convert from a Date to a String representation of the Time type.

  Parameters:

  date - the date

  Returns:

  a Date to a String representation of the Time type.

• toDay

  java.lang.String toDay(java.util.Date date)

  Convert from a Date to a String representation of the Day type.

  Parameters:

  date - the date

  Returns:

  a Date to a String representation of the Day type.

• toMonth

  java.lang.String toMonth(java.util.Date date)

  Convert from a Date to a String representation of the Month type.

  Parameters:

  date - the date

  Returns:

  a Date to a String representation of the Month type.

• toMonthDay

  java.lang.String toMonthDay(java.util.Date date)

  Convert from a Date to a String representation of the MonthDay type.

  Parameters:

  date - the date

  Returns:

  a Date to a String representation of the MonthDay type.

• toYear

  java.lang.String toYear(java.util.Date date)

  Convert from a Date to a String representation of the Year type.

  Parameters:

  date - the date

  Returns:

  a Date to a String representation of the Year type.

• toYearMonth

  java.lang.String toYearMonth(java.util.Date date)

  Convert from a Date to a String representation of the YearMonth type.

  Parameters:

  date - the date

  Returns:

  a Date to a String representation of the YearMonth type.

• toYearMonthDay

  java.lang.String toYearMonthDay(java.util.Date date)

  Convert from a Date to a String representation of the YearMonthDay type.

  Parameters:

  date - the date

  Returns:

  a Date to a String representation of the YearMonthDay type.

• toDateTime

  java.lang.String toDateTime(java.util.Calendar calendar)

  Convert from a Calendar to a String representation of the DateTime type.

  Parameters:

  calendar - the calendar to convert

  Returns:

  a Calendar to a String representation of the DateTime type.

• toDuration

  java.lang.String toDuration(java.util.Calendar calendar)

  Deprecated. There is no accepted algorithm to convert a date into a Duration so use of this method is discouraged. Convert from a Calendar to a String representation of the Duration type.

  Parameters:

  calendar - the calendar to convert

  Returns:

  a Calendar to a String representation of the Duration type.

• toTime

  java.lang.String toTime(java.util.Calendar calendar)

  Convert from a Calendar to a String representation of the Time type.

  Parameters:

  calendar - the calendar to convert

  Returns:

  a Calendar to a String representation of the Time type.

• toDay

  java.lang.String toDay(java.util.Calendar calendar)

  Convert from a Calendar to a String representation of the Day type.

  Parameters:

  calendar - the calendar to convert

  Returns:

  a Calendar to a String representation of the Day type.

• toMonth

  java.lang.String toMonth(java.util.Calendar calendar)

  Convert from a Calendar to a String representation of the Month type.

  Parameters:

  calendar - the calendar to convert

  Returns:

  a Calendar to a String representation of the Month type.

• toMonthDay

  java.lang.String toMonthDay(java.util.Calendar calendar)

  Convert from a Calendar to a String representation of the MonthDay type.

  Parameters:

  calendar - the calendar to convert

  Returns:

  a Calendar to a String representation of the MonthDay type.

• toYear

  java.lang.String toYear(java.util.Calendar calendar)

  Convert from a Calendar to a String representation of the Year type.

  Parameters:

  calendar - the calendar to convert

  Returns:

  a Calendar to a String representation of the Year type.

• toYearMonth

  java.lang.String toYearMonth(java.util.Calendar calendar)

  Convert from a Calendar to a String representation of the YearMonth type.

  Parameters:

  calendar - the calendar to convert

  Returns:

  a Calendar to a String representation of the YearMonth type.

• toYearMonthDay

  java.lang.String toYearMonthDay(java.util.Calendar calendar)

  Convert from a Calendar to a String representation of the YearMonthDay type.

  Parameters:

  calendar - the calendar to convert

  Returns:

  a Calendar to a String representation of the YearMonthDay type.

• convert

  java.lang.Object convert(Type type,
                         java.lang.Object value)

  Convert the specified value to an instance of the specified type. Supported conversions are listed in Section 16 of the SDO specification.

  Parameters:

  type - the target data type.

  value - the value to convert

  Returns:

  a value of the specified type's instance class

  Throws:

  java.lang.IllegalArgumentException - if the value could not be converted

  See Also:

  convert(Property, Object)

• convert

  java.lang.Object convert(Property property,
                         java.lang.Object value)

  Convert the specified value to an instance of the specified property's type. The specified value must be a List if the property is many valued. In this case, all the values in the List are converted.

  Parameters:

  property - the target data type property.

  value - the value or List of values to convert

  Returns:

  a converted value or list of converted values

  Throws:

  java.lang.IllegalArgumentException - if the value could not be converted

  See Also:

  convert(Type, Object)