Package org.javalite.common

Class Convert

java.lang.Object
org.javalite.common.Convert
public final class Convert extends Object
Convenience class for type conversions.
Author:
Igor Polevoy, Eric Nielsen

  • Method Details

    • toString

      public static String toString​(Object value)
      Returns string representation of an object, including Clob. For large CLOBs, be careful because this will load an entire CLOB in memory as java.lang.String.
      Parameters:
      value - value to convert.
      Returns:
      string representation of an object, including Clob.

    • toBoolean

      public static Boolean toBoolean​(Object value)
      Returns true if the value is any numeric type and has a value of 1, or if string type has a value of '1', 't', 'y', 'true' or 'yes'. Otherwise, return false.
      Parameters:
      value - value to convert
      Returns:
      true if the value is any numeric type and has a value of 1, or if string type has a value of '1', 't', 'y', 'true' or 'yes'. Otherwise, return false.

    • toSqlDate

      public static Date toSqlDate​(Object value)
      Expects a java.sql.Date, java.sql.Timestamp, java.sql.Time, java.util.Date, Long or any object whose toString method has this format: yyyy-mm-dd.
      Parameters:
      value - argument that is possible to convert to java.sql.Date.
      Returns:
      java.sql.Date instance representing input value.

    • truncateToSqlDate

      public static Date truncateToSqlDate​(Object value)
      Expects a java.sql.Date, java.sql.Timestamp, java.sql.Time, java.util.Date, Long or string with format "yyyy-MM-dd". This method will truncate hours, minutes, seconds and milliseconds to zeros, to conform with JDBC spec: http://download.oracle.com/javase/6/docs/api/java/sql/Date.html.

      This method is tread-safe.

      Parameters:
      value - argument that is possible to convert to java.sql.Date: java.sql.Date, java.sql.Timestamp, java.sql.Time, java.util.Date, Long or any object with toString() == yyyy-mm-dd.
      Returns:
      java.sql.Date instance representing input value.

    • truncateToSqlDate

      public static Date truncateToSqlDate​(long time)
      This method will truncate hours, minutes, seconds and milliseconds to zeros, to conform with JDBC spec: http://download.oracle.com/javase/6/docs/api/java/sql/Date.html.
      Parameters:
      time - time in UTC milliseconds from the epoch
      Returns:
      java.sql.Date instance representing time value

    • toIsoString

      public static String toIsoString​(Date date)
      Converts a java.util.Date to a String in ISO 8601 format: "yyyy-MM-dd'T'HH:mm:ss'Z'" in UTC timezone for timestamps, and "yyyy-MM-dd" for instances of java.sql.Date.

      This method is tread-safe.

      Parameters:
      date - date to convert
      Returns:
      String in ISO 8601 format

    • toDouble

      public static Double toDouble​(Object value)
      Converts any value to Double.
      Parameters:
      value - value to convert.
      Returns:
      converted double.

    • toTime

      public static Time toTime​(Object value)
      If the value is instance of java.sql.Time, returns it, else tries to convert java.util.Date or Long to Time, else tries to convert using Time.valueOf(String). This method might trow IllegalArgumentException if fails at conversion.
      Parameters:
      value - value to convert
      Returns:
      instance of java.sql.Time
      See Also:
      Time.valueOf(String)

    • toLocalDate

      public static LocalDate toLocalDate​(Object value)
      Converts a value to LocalDate. Tries to convert to java.util.Date, then to LocalDate. If that does not work, tries to convert to String, then to Date, and so on.
      Parameters:
      value - value to convert
      Returns:
      converted LocalDate

    • toLocalDate

      public static LocalDate toLocalDate​(Date date)

    • toLocalDateTime

      public static LocalDateTime toLocalDateTime​(Object value)
      Converts a value to LocalDateTime. Tries to convert to java.util.Date, then to LocalDateTime. If that does not work, tries to convert to Long. If all fails, it tries to parse the value from the string representation of the argument.
      Parameters:
      value - value to convert
      Returns:
      converted LocalDateTime

    • toLocalDateTime

      public static LocalDateTime toLocalDateTime​(long millis, TimeZone timeZone)
      Parameters:
      millis - milliseconds to convert to LocalDateTime.
      timeZone - time zone.
      Returns:
      instance of LocalDateTime.

    • toLocalDateTime

      public static LocalDateTime toLocalDateTime​(long millis)
      Parameters:
      millis - milliseconds to convert to LocalDateTime. Uses a default time zone.
      Returns:
      instance of LocalDateTime.

    • toTimestamp

      public static Timestamp toTimestamp​(Object value)
      If the value is instance of java.sql.Timestamp, returns it, else tries to convert java.util.Date or Long to Timestamp, else tries to convert using Timestamp.valueOf(String). This method might trow IllegalArgumentException if fails at conversion.
      Parameters:
      value - value to convert.
      Returns:
      instance of Timestamp.
      See Also:
      Timestamp.valueOf(String)

    • toFloat

      public static Float toFloat​(Object value)
      Converts value to Float if it can. If value is a Float, it is returned, if it is a Number, it is promoted to Float and then returned, in all other cases, it converts the value to String, then tries to parse Float from it.
      Parameters:
      value - value to be converted to Float.
      Returns:
      value converted to Float.

    • toLong

      public static Long toLong​(Object value)
      Converts value to Long if it can. If value is a Long, it is returned, if it is a Number, it is promoted to Long and then returned, if it is a Date, returns its getTime() value, in all other cases, it converts the value to String, then tries to parse Long from it.
      Parameters:
      value - value to be converted to Long.
      Returns:
      value converted to Long.

    • toInteger

      public static Integer toInteger​(Object value)
      Converts value to Integer if it can. If value is a Integer, it is returned, if it is a Number, it is promoted to Integer and then returned, in all other cases, it converts the value to String, then tries to parse Integer from it.
      Parameters:
      value - value to be converted to Integer.
      Returns:
      value converted to Integer.

    • toBigDecimal

      public static BigDecimal toBigDecimal​(Object value)
      Converts value to BigDecimal if it can. If value is a BigDecimal, it is returned, if it is a BigDecimal, it is promoted to BigDecimal and then returned, in all other cases, it converts the value to String, then tries to parse BigDecimal from it.
      Parameters:
      value - value to be converted to Integer.
      Returns:
      value converted to Integer.

    • toBytes

      public static byte[] toBytes​(Object value)
      Converts value to bytes array if it can. If the value is byte array, it is simply returned, if it is a java.sql.Blob, then data is read from it as bytes. In all other cases the object is converted to String, then bytes are read from it.
      Parameters:
      value - value to be converted.
      Returns:
      value converted to byte array.

    • toBytes

      public static byte[] toBytes​(Blob blob)
      Converts java.sql.Blob to bytes array.
      Parameters:
      blob - Blob to be converted
      Returns:
      blob converted to byte array

    • toShort

      public static Short toShort​(Object value)
      Converts value to Short if it can. If value is a Short, it is returned, if it is a Number, it is promoted to Short and then returned, in all other cases, it converts the value to String, then tries to parse Short from it.
      Parameters:
      value - value to be converted to Integer.
      Returns:
      value converted to Integer.