gx-instant

# 格式化

# 说明

格式化包含了一些常用的格式化方法，导出模块名为format

# 方法

# toRMB

说明：数字转人民币字符串

  • 参数
    • val: number | string 要格式化的值
    • precision：number 精度，可选，默认为2
    • separator：string 整数位部分分隔符，可选，默认为','
    • decimal：string 小数点格式化分隔符，可选，默认为'.'
  • 返回：string | false 格式化结果(四舍五入)，失败返回false

# toUSD

说明：数字转美元字符串

  • 参数
    • val: number | string 要格式化的值
    • precision：number 精度，可选，默认为2
    • separator：string 整数位部分分隔符，可选，默认为','
    • decimal：string 小数点格式化分隔符，可选，默认为'.'
  • 返回：string | false 格式化结果(四舍五入)，失败返回false

# moneyToNumber

说明：金额转数字

  • 参数
    • val: number | string 格式化字符串
    • precision：number 精度，可选，默认为2
    • separator：string 整数位部分分隔符，可选，默认为','
    • decimal：string 小数点格式化分隔符，可选，默认为'.'
  • 返回：number 数字结果

# strikeToLowerCamelCase

说明：中划线转小驼峰

  • 参数
    • str: string 中划线形式字符串
  • 返回：string 转换结果

# strikeToUpperCamelCase

说明：中划线转大驼峰

  • 参数
    • str: string 中划线形式字符串
  • 返回：string 转换结果

# underlineToLowerCamelCase

说明：下划线转小驼峰

  • 参数
    • str: string 下划线形式字符串
  • 返回：string 转换结果

# underlineToUpperCamelCase

说明：下划线转大驼峰

  • 参数
    • str: string 下划线形式字符串
  • 返回：string 转换结果

# lowerCamelCaseToStrike

说明：小驼峰转中划线

  • 参数
    • str: string 小驼峰形式字符串
  • 返回：string 转换结果

# lowerCamelCaseToUnderline

说明：小驼峰转下划线

  • 参数
    • str: string 小驼峰形式字符串
  • 返回：string 转换结果

# lowerCamelCaseToConst

说明：小驼峰转常量（下划线连接，字母大写）

  • 参数
    • str: string 小驼峰形式字符串
  • 返回：string 转换结果

# nameCovert

说明：常用命名字符串转换

  • 参数
    • str: string 小驼峰形式字符串
    • source：string 字符串原形式，默认strike（中划线），可取值：strike（中划线）、underline（下划线）、lowerCamelCase（小驼峰）
    • target：string 字符串转换形式，默认lowerCamelCase，可取值：strike（中划线）、underline（下划线）、lowerCamelCase（小驼峰）,upperCamelCase（大驼峰）,const（常量）
  • 返回：string 转换结果

提示

  • 该方法相当于对其他具体命名函数的抽象封装
  • 该方法支持中划线转：小驼峰、转大驼峰；下划线转：小驼峰、转大驼峰；小驼峰转：中划线、下划线、常量

# toDMS

说明：十进制数据转经纬度度分秒对象

  • 参数
    • val: number | string 要转换的数据，十进制，string时为十进制字符串
    • precision：number 精确精度，可选，默认为2
  • 返回：object 包含度分秒的对象，形式为{s: number, d: number,m: number}

# toDMSStr

说明：十进制转经纬度度分秒字符串

  • 参数
    • val: number | string 要转换的数据，十进制，string时为十进制字符串
    • split：array | object array | object 度分秒后缀，默认['°', '′', '″']，也可以传入{d:'',m:'',s:''}，数组形式时，度分秒和后缀顺序一一对应
  • 返回：string 度分秒拼接后的字符串形式

示例

toDMSStr('-17.496939') //输出：-17°29′48.98″

//添加自定义分隔符
toDMSStr('-17.496939',['度','分','秒']) //输出：-17度29分48.98秒
//也可以
toDMSStr('-17.496939',{d:'度',m:'分',s:'秒'}) //输出：-17度29分48.98秒

# toDMSDecimal

说明：度分秒字符串转十进制

  • 参数
    • val: string 度分秒字符串
    • split：array 度分后缀符列表，可选参数，默认['°', '′']，顺序分别对应度、分
  • 返回：number 度分秒十进制

示例

toDMSDecimal('-17°29′48.98″') //输出： -16.503062

# addDMSUnit

说明：经纬度字符串添加方向符号

  • 参数
    • val: string 经纬度度分秒字符串
    • type：string 经纬度类型，可选，可选值为（lon为经度，lat为纬度），默认lon
    • unit：array | object 方向符号，可选，type为lon时，必传经度方向，lat时需要必传纬度方向；有两种格式，数组和对象，数组格式为['E','W','S','N'](和东西南北一一对应)，对象格式为{e:'E',w:'W',s:'S',n:'N'} 默认 {e: 'E', w: 'W', s: 'S', n: 'N'}
    • loc：string 符号出现位置，默认是pre(字符串前缀)，取值post为后缀
  • 返回：string 转换结果

提示

  • addDMSUnit 通常和toDMSStr 一起使用 示例
addDMSUnit(toDMSStr('-17.496939'), 'lon', null, 'post') //输出-17°29′48.98″ W

← 正则匹配 →