Convert (hutool 2.16.0 API)

java.lang.Object
- com.xiaoleilu.hutool.convert.Convert

```
public class Convert
extends Object
```
类型转换器

作者:

xiaoleilu

方法概要

方法
限定符和类型	方法和说明
`static <T> T`	`convert(Class<T> type, Object value)` 转换值为指定类型
`static <T> T`	`convert(Class<T> type, Object value, T defaultValue)` 转换值为指定类型
`static String`	`convertCharset(String str, String sourceCharset, String destCharset)` 给定字符串转换字符编码如果参数为空，则返回原字符串，不报错。
`long`	`convertTime(long sourceDuration, TimeUnit sourceUnit, TimeUnit destUnit)` 转换时间单位
`static String`	`digitUppercase(double n)` 数字金额大写转换先写个完整的然后将如零拾替换成零
`static String`	`hexStrToStr(String hexStr, Charset charset)` 十六进制转换字符串
`static byte[]`	`hexToBytes(String src)` Hex字符串转换为Byte值
`static String`	`strToUnicode(String strText)` String的字符串转换成unicode的String
`static BigDecimal`	`toBigDecimal(Object value)` 转换为BigDecimal 如果给定的值为空，或者转换失败，返回默认值转换失败不会报错
`static BigDecimal`	`toBigDecimal(Object value, BigDecimal defaultValue)` 转换为BigDecimal 如果给定的值为空，或者转换失败，返回默认值转换失败不会报错
`static BigInteger`	`toBigInteger(Object value)` 转换为BigInteger 如果给定的值为空，或者转换失败，返回默认值`null` 转换失败不会报错
`static BigInteger`	`toBigInteger(Object value, BigInteger defaultValue)` 转换为BigInteger 如果给定的值为空，或者转换失败，返回默认值转换失败不会报错
`static Boolean`	`toBool(Object value)` 转换为boolean 如果给定的值为空，或者转换失败，返回默认值`null` 转换失败不会报错
`static Boolean`	`toBool(Object value, Boolean defaultValue)` 转换为boolean String支持的值为：true、false、yes、ok、no，1,0 如果给定的值为空，或者转换失败，返回默认值转换失败不会报错
`static Boolean[]`	`toBooleanArray(boolean isIgnoreConvertError, Object... values)` 转换为Boolean数组
`static Byte`	`toByte(Object value)` 转换为byte 如果给定的值为`null`，或者转换失败，返回默认值`null` 转换失败不会报错
`static Byte`	`toByte(Object value, Byte defaultValue)` 转换为byte 如果给定的值为`null`，或者转换失败，返回默认值转换失败不会报错
`static Character`	`toChar(Object value)` 转换为字符如果给定的值为`null`，或者转换失败，返回默认值`null` 转换失败不会报错
`static Character`	`toChar(Object value, Character defaultValue)` 转换为字符如果给定的值为null，或者转换失败，返回默认值转换失败不会报错
`static String`	`toDBC(String input)` 全角转半角
`static String`	`toDBC(String text, Set<Character> notConvertSet)` 替换全角为半角
`static Double`	`toDouble(Object value)` 转换为double 如果给定的值为空，或者转换失败，返回默认值`null` 转换失败不会报错
`static Double`	`toDouble(Object value, Double defaultValue)` 转换为double 如果给定的值为空，或者转换失败，返回默认值转换失败不会报错
`static Double[]`	`toDoubleArray(boolean isIgnoreConvertError, Object... values)` 转换为Double数组
`static <E extends Enum<E>> E`	`toEnum(Class<E> clazz, Object value)` 转换为Enum对象如果给定的值为空，或者转换失败，返回默认值`null`
`static <E extends Enum<E>> E`	`toEnum(Class<E> clazz, Object value, E defaultValue)` 转换为Enum对象如果给定的值为空，或者转换失败，返回默认值
`static Float`	`toFloat(Object value)` 转换为Float 如果给定的值为空，或者转换失败，返回默认值`null` 转换失败不会报错
`static Float`	`toFloat(Object value, Float defaultValue)` 转换为Float 如果给定的值为空，或者转换失败，返回默认值转换失败不会报错
`static <T> Float[]`	`toFloatArray(boolean isIgnoreConvertError, Object... values)` 转换为Float数组
`static String`	`toHex(byte[] bytes)` byte数组转16进制串
`static String`	`toHex(String str)` 字符串转换成十六进制字符串
`static Integer`	`toInt(Object value)` 转换为int 如果给定的值为`null`，或者转换失败，返回默认值`null` 转换失败不会报错
`static Integer`	`toInt(Object value, Integer defaultValue)` 转换为int 如果给定的值为空，或者转换失败，返回默认值转换失败不会报错
`static Integer[]`	`toIntArray(boolean isIgnoreConvertError, Object... values)` 转换为Integer数组
`static Long`	`toLong(Object value)` 转换为long 如果给定的值为`null`，或者转换失败，返回默认值`null` 转换失败不会报错
`static Long`	`toLong(Object value, Long defaultValue)` 转换为long 如果给定的值为空，或者转换失败，返回默认值转换失败不会报错
`static Long[]`	`toLongArray(boolean isIgnoreConvertError, Object... values)` 转换为Long数组
`static Number`	`toNumber(Object value)` 转换为Number 如果给定的值为空，或者转换失败，返回默认值`null` 转换失败不会报错
`static Number`	`toNumber(Object value, Number defaultValue)` 转换为Number 如果给定的值为空，或者转换失败，返回默认值转换失败不会报错
`static String`	`toSBC(String input)` 半角转全角
`static String`	`toSBC(String input, Set<Character> notConvertSet)` 半角转全角
`static Short`	`toShort(Object value)` 转换为Short 如果给定的值为`null`，或者转换失败，返回默认值`null` 转换失败不会报错
`static Short`	`toShort(Object value, Short defaultValue)` 转换为Short 如果给定的值为`null`，或者转换失败，返回默认值转换失败不会报错
`static String`	`toStr(Object value)` 转换为字符串如果给定的值为`null`，或者转换失败，返回默认值`null` 转换失败不会报错
`static String`	`toStr(Object value, String defaultValue)` 转换为字符串如果给定的值为null，或者转换失败，返回默认值转换失败不会报错
`static String`	`unicodeToStr(String hex)` unicode的String转换成String的字符串
`static Class<?>`	`unWrap(Class<?> clazz)` 包装类转为原始类，非包装类返回原类
`static Class<?>`	`wrap(Class<?> clazz)` 原始类转为包装类，非原始类返回原类

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - toStr
```
public static String toStr(Object value,
           String defaultValue)
```
    转换为字符串
    如果给定的值为null，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    defaultValue - 转换错误时的默认值
    
    返回:
    结果
  - toStr
```
public static String toStr(Object value)
```
    转换为字符串
    如果给定的值为null，或者转换失败，返回默认值null
    转换失败不会报错
    
    参数:
    value - 被转换的值
    
    返回:
    结果
  - toChar
```
public static Character toChar(Object value,
               Character defaultValue)
```
    转换为字符
    如果给定的值为null，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    defaultValue - 转换错误时的默认值
    
    返回:
    结果
  - toChar
```
public static Character toChar(Object value)
```
    转换为字符
    如果给定的值为null，或者转换失败，返回默认值null
    转换失败不会报错
    
    参数:
    value - 被转换的值
    
    返回:
    结果
  - toByte
```
public static Byte toByte(Object value,
          Byte defaultValue)
```
    转换为byte
    如果给定的值为null，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    defaultValue - 转换错误时的默认值
    
    返回:
    结果
  - toByte
```
public static Byte toByte(Object value)
```
    转换为byte
    如果给定的值为null，或者转换失败，返回默认值null
    转换失败不会报错
    
    参数:
    value - 被转换的值
    
    返回:
    结果
  - toShort
```
public static Short toShort(Object value,
            Short defaultValue)
```
    转换为Short
    如果给定的值为null，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    defaultValue - 转换错误时的默认值
    
    返回:
    结果
  - toShort
```
public static Short toShort(Object value)
```
    转换为Short
    如果给定的值为null，或者转换失败，返回默认值null
    转换失败不会报错
    
    参数:
    value - 被转换的值
    
    返回:
    结果
  - toNumber
```
public static Number toNumber(Object value,
              Number defaultValue)
```
    转换为Number
    如果给定的值为空，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    defaultValue - 转换错误时的默认值
    
    返回:
    结果
  - toNumber
```
public static Number toNumber(Object value)
```
    转换为Number
    如果给定的值为空，或者转换失败，返回默认值null
    转换失败不会报错
    
    参数:
    value - 被转换的值
    
    返回:
    结果
  - toInt
```
public static Integer toInt(Object value,
            Integer defaultValue)
```
    转换为int
    如果给定的值为空，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    defaultValue - 转换错误时的默认值
    
    返回:
    结果
  - toInt
```
public static Integer toInt(Object value)
```
    转换为int
    如果给定的值为null，或者转换失败，返回默认值null
    转换失败不会报错
    
    参数:
    value - 被转换的值
    
    返回:
    结果
  - toIntArray
```
public static Integer[] toIntArray(boolean isIgnoreConvertError,
                   Object... values)
```
    转换为Integer数组
    
    参数:
    isIgnoreConvertError - 是否忽略转换错误，忽略则给值null
    values - 被转换的值
    
    返回:
    结果
  - toLong
```
public static Long toLong(Object value,
          Long defaultValue)
```
    转换为long
    如果给定的值为空，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    defaultValue - 转换错误时的默认值
    
    返回:
    结果
  - toLong
```
public static Long toLong(Object value)
```
    转换为long
    如果给定的值为null，或者转换失败，返回默认值null
    转换失败不会报错
    
    参数:
    value - 被转换的值
    
    返回:
    结果
  - toLongArray
```
public static Long[] toLongArray(boolean isIgnoreConvertError,
                 Object... values)
```
    转换为Long数组
    
    参数:
    isIgnoreConvertError - 是否忽略转换错误，忽略则给值null
    values - 被转换的值
    
    返回:
    结果
  - toDouble
```
public static Double toDouble(Object value,
              Double defaultValue)
```
    转换为double
    如果给定的值为空，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    defaultValue - 转换错误时的默认值
    
    返回:
    结果
  - toDouble
```
public static Double toDouble(Object value)
```
    转换为double
    如果给定的值为空，或者转换失败，返回默认值null
    转换失败不会报错
    
    参数:
    value - 被转换的值
    
    返回:
    结果
  - toDoubleArray
```
public static Double[] toDoubleArray(boolean isIgnoreConvertError,
                     Object... values)
```
    转换为Double数组
    
    参数:
    isIgnoreConvertError - 是否忽略转换错误，忽略则给值null
    values - 被转换的值
    
    返回:
    结果
  - toFloat
```
public static Float toFloat(Object value,
            Float defaultValue)
```
    转换为Float
    如果给定的值为空，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    defaultValue - 转换错误时的默认值
    
    返回:
    结果
  - toFloat
```
public static Float toFloat(Object value)
```
    转换为Float
    如果给定的值为空，或者转换失败，返回默认值null
    转换失败不会报错
    
    参数:
    value - 被转换的值
    
    返回:
    结果
  - toFloatArray
```
public static <T> Float[] toFloatArray(boolean isIgnoreConvertError,
                       Object... values)
```
    转换为Float数组
    
    参数:
    isIgnoreConvertError - 是否忽略转换错误，忽略则给值null
    values - 被转换的值
    
    返回:
    结果
  - toBool
```
public static Boolean toBool(Object value,
             Boolean defaultValue)
```
    转换为boolean
    String支持的值为：true、false、yes、ok、no，1,0 如果给定的值为空，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    defaultValue - 转换错误时的默认值
    
    返回:
    结果
  - toBool
```
public static Boolean toBool(Object value)
```
    转换为boolean
    如果给定的值为空，或者转换失败，返回默认值null
    转换失败不会报错
    
    参数:
    value - 被转换的值
    
    返回:
    结果
  - toBooleanArray
```
public static Boolean[] toBooleanArray(boolean isIgnoreConvertError,
                       Object... values)
```
    转换为Boolean数组
    
    参数:
    isIgnoreConvertError - 是否忽略转换错误，忽略则给值null
    values - 被转换的值
    
    返回:
    结果
  - toBigInteger
```
public static BigInteger toBigInteger(Object value,
                      BigInteger defaultValue)
```
    转换为BigInteger
    如果给定的值为空，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    defaultValue - 转换错误时的默认值
    
    返回:
    结果
  - toBigInteger
```
public static BigInteger toBigInteger(Object value)
```
    转换为BigInteger
    如果给定的值为空，或者转换失败，返回默认值null
    转换失败不会报错
    
    参数:
    value - 被转换的值
    
    返回:
    结果
  - toBigDecimal
```
public static BigDecimal toBigDecimal(Object value,
                      BigDecimal defaultValue)
```
    转换为BigDecimal
    如果给定的值为空，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    defaultValue - 转换错误时的默认值
    
    返回:
    结果
  - toBigDecimal
```
public static BigDecimal toBigDecimal(Object value)
```
    转换为BigDecimal
    如果给定的值为空，或者转换失败，返回默认值
    转换失败不会报错
    
    参数:
    value - 被转换的值
    
    返回:
    结果
  - toEnum
```
public static <E extends Enum<E>> E toEnum(Class<E> clazz,
                           Object value,
                           E defaultValue)
```
    转换为Enum对象
    如果给定的值为空，或者转换失败，返回默认值
    
    参数:
    clazz - Enum的Class
    value - 值
    defaultValue - 默认值
    
    返回:
    Enum
  - toEnum
```
public static <E extends Enum<E>> E toEnum(Class<E> clazz,
                           Object value)
```
    转换为Enum对象
    如果给定的值为空，或者转换失败，返回默认值null
    
    参数:
    clazz - Enum的Class
    value - 值
    
    返回:
    Enum
  - convert
```
public static <T> T convert(Class<T> type,
            Object value)
```
    转换值为指定类型
    
    参数:
    type - 类型
    value - 值
    
    返回:
    转换后的值
  - convert
```
public static <T> T convert(Class<T> type,
            Object value,
            T defaultValue)
```
    转换值为指定类型
    
    参数:
    type - 类型
    value - 值
    defaultValue - 默认值
    
    返回:
    转换后的值
  - toSBC
```
public static String toSBC(String input)
```
    半角转全角
    
    参数:
    input - String.
    
    返回:
    全角字符串.
  - toSBC
```
public static String toSBC(String input,
           Set<Character> notConvertSet)
```
    半角转全角
    
    参数:
    input - String
    notConvertSet - 不替换的字符集合
    
    返回:
    全角字符串.
  - toDBC
```
public static String toDBC(String input)
```
    全角转半角
    
    参数:
    input - String.
    
    返回:
    半角字符串
  - toDBC
```
public static String toDBC(String text,
           Set<Character> notConvertSet)
```
    替换全角为半角
    
    参数:
    text - 文本
    notConvertSet - 不替换的字符集合
    
    返回:
    替换后的字符
  - toHex
```
public static String toHex(String str)
```
    字符串转换成十六进制字符串
    
    参数:
    str - 待转换的ASCII字符串
    
    返回:
    16进制字符串
  - toHex
```
public static String toHex(byte[] bytes)
```
    byte数组转16进制串
    
    参数:
    bytes - 被转换的byte数组
    
    返回:
    转换后的值
  - hexToBytes
```
public static byte[] hexToBytes(String src)
```
    Hex字符串转换为Byte值
    
    参数:
    src - Byte字符串，每个Byte之间没有分隔符
    
    返回:
    byte[]
  - hexStrToStr
```
public static String hexStrToStr(String hexStr,
                 Charset charset)
```
    十六进制转换字符串
    
    参数:
    hexStr - Byte字符串(Byte之间无分隔符如:[616C6B])
    charset - 编码 Charset
    
    返回:
    对应的字符串
  - strToUnicode
```
public static String strToUnicode(String strText)
                           throws Exception
```
    String的字符串转换成unicode的String
    
    参数:
    strText - 全角字符串
    
    返回:
    String 每个unicode之间无分隔符
    
    抛出:
    
    Exception
  - unicodeToStr
```
public static String unicodeToStr(String hex)
```
    unicode的String转换成String的字符串
    
    参数:
    hex - 16进制值字符串（一个unicode为2byte）
    
    返回:
    String 全角字符串
  - convertCharset
```
public static String convertCharset(String str,
                    String sourceCharset,
                    String destCharset)
```
    给定字符串转换字符编码
    如果参数为空，则返回原字符串，不报错。
    
    参数:
    str - 被转码的字符串
    sourceCharset - 原字符集
    destCharset - 目标字符集
    
    返回:
    转换后的字符串
  - convertTime
```
public long convertTime(long sourceDuration,
               TimeUnit sourceUnit,
               TimeUnit destUnit)
```
    转换时间单位
    
    参数:
    sourceDuration - 时长
    sourceUnit - 源单位
    destUnit - 目标单位
    
    返回:
    目标单位的时长
  - digitUppercase
```
public static String digitUppercase(double n)
```
    数字金额大写转换先写个完整的然后将如零拾替换成零
    
    参数:
    n - 数字
    
    返回:
    中文大写数字
  - wrap
```
public static Class<?> wrap(Class<?> clazz)
```
    原始类转为包装类，非原始类返回原类
    
    参数:
    clazz - 原始类
    
    返回:
    包装类
    另请参阅:
    BasicType.wrap(Class)
  - unWrap
```
public static Class<?> unWrap(Class<?> clazz)
```
    包装类转为原始类，非包装类返回原类
    
    参数:
    clazz - 包装类
    
    返回:
    原始类
    另请参阅:
    BasicType.unWrap(Class)

类 Convert

方法概要

从类继承的方法 java.lang.Object

方法详细资料

toStr

toStr

toChar

toChar

toByte

toByte

toShort

toShort

toNumber

toNumber

toInt

toInt

toIntArray

toLong

toLong

toLongArray

toDouble

toDouble

toDoubleArray

toFloat

toFloat

toFloatArray

toBool

toBool

toBooleanArray

toBigInteger

toBigInteger

toBigDecimal

toBigDecimal

toEnum

toEnum

convert

convert

toSBC

toSBC

toDBC

toDBC

toHex

toHex

hexToBytes

hexStrToStr

strToUnicode

unicodeToStr

convertCharset

convertTime

digitUppercase

wrap

unWrap