支持任意 JavaScript 环境或框架

转换金额

centsToDollars

分转元

基础用法

分转元: 1.00

查看代码

<script setup lang="ts">
import { centsToDollars } from "@pureadmin/utils";
</script>

<template>
  <naive-theme>
    <n-space className="flex items-center mt-2">
      <n-gradient-text type="info">
        分转元: {{ centsToDollars(100) }}
      </n-gradient-text>
    </n-space>
  </naive-theme>
</template>

参数

接收两个参数，第一个参数 val，第二个参数 format，返回值类型 number

参数属性	说明	类型
val	分	number
format	转元后像 10 、20、 100 、1000 这种整金额默认会在末尾加 .00 ，如果不想要设置成 fasle 即可	number

dollarsToCents

元转分

基础用法

元转分: 100

查看代码

<script setup lang="ts">
import { dollarsToCents } from "@pureadmin/utils";
</script>

<template>
  <naive-theme>
    <n-space className="flex items-center mt-2">
      <n-gradient-text type="info">
        元转分: {{ dollarsToCents(1) }}
      </n-gradient-text>
    </n-space>
  </naive-theme>
</template>

参数

接收两个参数，第一个参数 val，第二个参数 digit，返回值类型 number

参数属性	说明	类型
val	元	number
digit	转换倍数，默认 100	number

priceUppercase

金额转大写汉字（支持小数位）

基础用法

整数金额转大写汉字: 壹佰贰拾叁万肆仟伍佰陆拾柒元整

非整数金额转大写汉字: 壹佰贰拾叁万肆仟伍佰陆拾柒元壹角贰分叁毫

查看代码

<script setup lang="ts">
import { priceUppercase } from "@pureadmin/utils";
</script>

<template>
  <naive-theme>
    <n-space className="flex items-center mt-2">
      <n-gradient-text type="info">
        整数金额转大写汉字: {{ priceUppercase(1234567) }}
      </n-gradient-text>
      <n-gradient-text type="info">
        非整数金额转大写汉字: {{ priceUppercase(1234567.123) }}
      </n-gradient-text>
    </n-space>
  </naive-theme>
</template>

参数

接收两个参数，第一个参数 val，第二个参数 format，返回值类型 string

参数属性	说明	类型
val	金额	number
format	整 （如果是整数金额最后面会默认加个 整，不想要的话给空字符串 ""）	string

priceToThousands

格式化金额，三位加一个逗号

基础用法

123456789 格式化 123,456,789

123456789 格式化并保留两位小数 123,456,789.00

123456789.567 格式化并保留两位小数 123,456,789.56

123456789.567 格式化并保留两位小数且小数位进行四舍五入 123,456,789.57

123456789.567 格式化并保留五位小数 123,456,789.56700

查看代码

<script setup lang="ts">
import { priceToThousands } from "@pureadmin/utils";
</script>

<template>
  <naive-theme>
    <n-space vertical className="mt-2">
      <n-gradient-text type="info">
        123456789 格式化
        <span className="text-red">
          {{ priceToThousands(123456789) }}
        </span>
      </n-gradient-text>
      <n-gradient-text type="info">
        123456789 格式化并保留两位小数
        <span className="text-red">
          {{ priceToThousands(123456789, { digit: 2 }) }}
        </span>
      </n-gradient-text>
      <n-gradient-text type="info">
        123456789.567 格式化并保留两位小数
        <span className="text-red">
          {{ priceToThousands(123456789.567, { digit: 2 }) }}
        </span>
      </n-gradient-text>
      <n-gradient-text type="info">
        123456789.567 格式化并保留两位小数且小数位进行四舍五入
        <span className="text-red">
          {{ priceToThousands(123456789.567, { digit: 2, round: true }) }}
        </span>
      </n-gradient-text>
      <n-gradient-text type="info">
        123456789.567 格式化并保留五位小数
        <span className="text-red">
          {{ priceToThousands(123456789.567, { digit: 5 }) }}
        </span>
      </n-gradient-text>
    </n-space>
  </naive-theme>
</template>

参数

接收两个参数，第一个参数 amount ，第二个参数 options ，返回格式化后的金额

参数属性	说明	类型
amount	金额	number
options	拥有两个属性，具体看下面的 options 详情	AmountOpt

options 详情

参数属性	说明	类型	默认值
digit	保留几位小数	number	0
round	小数位是否四舍五入	boolean	false

类型声明

export interface AmountOpt {
  /** 保留几位小数，默认 `0` */
  digit?: number;
  /** 小数位是否四舍五入，默认 `false` 不进行四舍五入 */
  round?: boolean;
}

getDecimalPlaces

获取数值的小数位数

基础用法

获取数值的小数位数: 4

查看代码

<script setup lang="ts">
import { getDecimalPlaces } from "@pureadmin/utils";
</script>

<template>
  <naive-theme>
    <n-space className="flex items-center mt-2">
      <n-gradient-text type="info">
        获取数值的小数位数: {{ getDecimalPlaces(100.2394) }}
      </n-gradient-text>
    </n-space>
  </naive-theme>
</template>

参数

接收一个参数 val，返回小数位数

参数属性	说明	类型
val	金额	number/string

addZero

在数值后加 .00

基础用法

加 .00 后的数值 123.00

查看代码

<script setup lang="ts">
import { addZero } from "@pureadmin/utils";
</script>

<template>
  <naive-theme>
    <n-space className="flex items-center mt-2">
      <n-gradient-text type="info">
        加 .00 后的数值 {{ addZero(123) }}
      </n-gradient-text>
    </n-space>
  </naive-theme>
</template>

参数

接收一个参数 val，返回加完 .00 后的值

参数属性	说明	类型
val	数值	number/string