transformNumber

Converte um número em uma string com unidades, tanto chinesas quanto inglesas.

API

transformNumber

Retorna

Argumento	Descrição	Tipo
string	A string formatada	string

Parâmetros

Parâmetro	Descrição	Tipo	Padrão
value	Número, como string, que será convertido	string	Obrigatório
locale	Configuração regional	string	'zh-CN'
precision	Precisão do cálculo	number	2
fixed	Casas decimais exibidas	number	2

Exemplo

Uso básico

import { transformNumber } from 'ranuts';

console.log(transformNumber('1000')); // '1.00 万' (dez mil, em chinês)
console.log(transformNumber('1000000')); // '100.00 万' (um milhão)
console.log(transformNumber('100000000')); // '1.00 亿' (cem milhões)

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 a precisão

import { transformNumber } from 'ranuts';

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

Entradas inválidas

import { transformNumber } from 'ranuts';

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

Notas

1. Sistema de unidades:

   • zh-CN: 万 (dez mil), 亿 (cem milhões), 万亿 (trilhão), a cada quatro dígitos
   • zh-HK: 萬, 億, 萬億, também a cada quatro dígitos
   • en: K (mil), M (milhão), B (bilhão), T (trilhão), a cada três dígitos

2. Precisão: usa o Mathjs para calcular sem arrastar erros de vírgula flutuante.

3. Entrada inválida: se o que chega não é um número, devolve '--'.

4. Quando usar: é comum para exibir números grandes: valores, visualizações, seguidores e afins.