ran
Español

transformNumber

Convierte un número en una cadena con unidades, tanto chinas como inglesas.

API

transformNumber

Devuelve

Argumento Descripción Tipo
string La cadena con formato string

Parámetros

Parámetro Descripción Tipo Por defecto
value Número, como cadena, que se convierte string Obligatorio
locale Configuración regional string 'zh-CN'
precision Precisión del cálculo number 2
fixed Decimales que se muestran number 2

Ejemplo

Uso básico

import { transformNumber } from 'ranuts';

console.log(transformNumber('1000')); // '1.00 万' (diez mil, en chino)
console.log(transformNumber('1000000')); // '100.00 万' (un millón)
console.log(transformNumber('100000000')); // '1.00 亿' (cien millones)

Unidades inglesas

import { transformNumber } from 'ranuts';

console.log(transformNumber('1000', 'en')); // '1.00K'
console.log(transformNumber('1000000', 'en')); // '1.00M'
console.log(transformNumber('1000000000', 'en')); // '1.00B'

Ajustar la precisión

import { transformNumber } from 'ranuts';

console.log(transformNumber('1234', 'zh-CN', 2, 1)); // '0.1 万'
console.log(transformNumber('12345', 'zh-CN', 2, 0)); // '1 万'

Entradas no válidas

import { transformNumber } from 'ranuts';

console.log(transformNumber('abc')); // '--'
console.log(transformNumber('')); // '--'

Notas

  1. Sistema de unidades:

    • zh-CN: 万 (diez mil), 亿 (cien millones), 万亿 (billón), cada cuatro dígitos
    • zh-HK: 萬, 億, 萬億, también cada cuatro dígitos
    • en: K (mil), M (millón), B (mil millones), T (billón), cada tres dígitos

  2. Precisión: usa Mathjs para calcular sin arrastrar errores de coma flotante.

  3. Entrada no válida: si lo que llega no es un número, devuelve '--'.

  4. Cuándo usarlo: es habitual para mostrar cifras grandes: importes, visitas, seguidores y demás.