transformNumber

Wandelt eine Zahl in eine Zeichenkette mit Einheiten um — chinesische wie englische.

API

transformNumber

Rückgabe

Argument	Beschreibung	Typ
string	Die formatierte Zeichenkette	string

Parameter

Parameter	Beschreibung	Typ	Standard
value	Umzuwandelnde Zahl als Zeichenkette	string	Erforderlich
locale	Gebietsschema	string	'zh-CN'
precision	Genauigkeit der Rechnung	number	2
fixed	Angezeigte Nachkommastellen	number	2

Beispiel

Grundlegende Verwendung

import { transformNumber } from 'ranuts';

console.log(transformNumber('1000')); // '1.00 万' (zehntausend, chinesisch)
console.log(transformNumber('1000000')); // '100.00 万' (eine Million)
console.log(transformNumber('100000000')); // '1.00 亿' (hundert Millionen)

Englische Einheiten

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'

Die Genauigkeit einstellen

import { transformNumber } from 'ranuts';

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

Ungültige Eingaben

import { transformNumber } from 'ranuts';

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

Hinweise

1. Einheitensystem:

   • zh-CN: 万 (zehntausend), 亿 (hundert Millionen), 万亿 (Billion) — alle vier Stellen
   • zh-HK: 萬, 億, 萬億 — ebenfalls alle vier Stellen
   • en: K (Tausend), M (Million), B (Milliarde), T (Billion) — alle drei Stellen

2. Genauigkeit: rechnet mit Mathjs, um Gleitkommafehler zu vermeiden.

3. Ungültige Eingabe: Ist die Eingabe keine gültige Zahl, kommt '--' zurück.

4. Einsatz: üblich für große Zahlen wie Beträge, Aufrufe oder Followerzahlen.