TypeScript String to Number: String'i Sayıya Çevirme (ve Tersi)

TypeScript'te bir string'i sayıya çevirmek için Number(text) çağırın. Sonuç number tipindedir ve metin geçerli bir sayı değilse NaN olur. Sonunda karakterler bulunan metinler için, örneğin "42px", parseInt(text, 10) veya parseFloat(text) kullanın.

const input: string = "42";

const a = Number(input);       // 42
const b = parseInt(input, 10); // 42 (whole numbers)
const c = parseFloat("3.75");  // 3.75
const d = +input;              // 42 (unary plus, same as Number)

console.log(a + 1, b + 1, c + 1, d + 1); // 43 43 4.75 43

// And back: number to string
const text: string = String(a);
console.log(text, text.length); // 42 2

Dört dönüşümün hepsi number tipini döndürür. TypeScript metnin geçerli olup olmadığını bilmez; geçersiz bir string yine bir number verir ve değeri NaN olur.

Neden Dönüştürmeniz Gerekir

Form alanları, URL parametreleri, ortam değişkenleri ve dosya içerikleri string olarak gelir. TypeScript bunlardan birini sayı beklenen bir yerde kullanmanıza izin vermez:

// This does not compile: a string is not a number.
const quantity: string = "3";
const total: number = quantity * 10;
console.log(total);

index.ts(3,23): error TS2362: The left-hand side of an arithmetic operation must be of type 'any', 'number', 'bigint' or an enum type.

Bir string üzerinde -, * ve / ile aritmetik bir hatadır. + işlemine izin verilir ama birleştirme yapar, yani "3" + 10 sonucu "310" string'idir; dönüşümün önce gelmesi gerekmesinin nedeni budur: Number(quantity) * 10.

Bir type assertion da işe yaramaz. quantity as number reddedilir (TS2352) ve onu as unknown as number ile zorlamak yalnızca derleyiciyi susturur: değer çalışma zamanında string olarak kalır.

Number, parseInt, parseFloat ve Tekli Artı

Dört fonksiyon temiz girdide aynı sonucu verir, geri kalan her şeyde ayrışır. Bu tablo her birinin Node üzerindeki gerçek çıktısıdır:

Tablonun arkasındaki kurallar:

• Number ve tekli + aynıdır. Boşlukları kırptıktan sonra string'in tamamını dönüştürür, 1e3 ve 0x hex yazımını anlar ve geriye bir şey kalırsa NaN döndürür. Boş ya da yalnızca boşluk içeren bir string 0 olur.
• parseInt ve parseFloat baştan okur ve kullanamadıkları ilk karakterde durur, bu yüzden "42px" ve "1,000" kısmi sayılar verir. Boş bir string NaN olur.
• parseInt kesirli kısmı atar ve üsleri anlamaz: "1e3" girdisinde e karakterinde durur.
• Sayısal ayırıcılar (12_000) kaynak kodda geçerlidir, string'lerde değil.

Girdiyi doğrulamak için daha katı seçenek Number fonksiyonudur. parseInt ve parseFloat, CSS boyutları gibi gerçekten bir birim veya ek taşıyan metinlere uygundur.

Geçersiz Girdiyi Ele Almak: NaN

NaN değerinin tipi number olduğu için derleyici onun hakkında asla uyarmaz. Sonucu kendiniz Number.isNaN veya Number.isFinite ile kontrol edin:

function toNumber(text: string): number | undefined {
    if (text.trim() === "") return undefined; // Number("") would be 0
    const n = Number(text);
    return Number.isFinite(n) ? n : undefined;
}

for (const s of ["12.5", "", "abc", "7 ", "Infinity"]) {
    console.log(JSON.stringify(s), toNumber(s));
}

const age = toNumber("30");
if (age !== undefined) {
    console.log(age + 1); // age is number here
}

number | undefined döndürmek, başarısızlığı tipin bir parçası yapar; böylece her çağıran aritmetik yapmadan önce onu ele almak zorundadır. Number.isFinite, Number("Infinity") fonksiyonunun seve seve döndürdüğü Infinity değerini de reddeder.

Global isNaN(x) fonksiyonundan kaçının: argümanını önce dönüştürür, bu yüzden JavaScript'te isNaN("abc") sonucu true olur. TypeScript'in bildirimi yalnızca bir number kabul eder, bu yüzden bir string vermek TS2345 hatasıdır; bu da zaten dönüştürülmüş bir değer üzerinde Number.isNaN kullanmanız gerektiğine dair bir ipucudur.

String'i Tam Sayıya Çevirmek

parseInt fonksiyonuna her zaman ikinci argümanını, tabanı (radix) verin: ondalık metin için 10. İsteğe bağlıdır ama niyeti belgeler ve başka tabanlar için önemlidir. Ondalıklı bir string'den tam sayı almak için önce dönüştürün, sonra açıkça yuvarlayın.

console.log(parseInt("0042", 10)); // 42
console.log(parseInt("ff", 16));   // 255
console.log(parseInt("1010", 2));  // 10

const price = Number("19.99");
console.log(Math.trunc(price), Math.round(price), Math.floor(price)); // 19 20 19

console.log(Number.isInteger(Number("7")));   // true
console.log(Number.isInteger(Number("7.5"))); // false

console.log(BigInt("9007199254740993")); // 9007199254740993n

parseInt bir string bekler: parseInt(12.7) bir derleme hatasıdır (TS2345). Bu işe yarar, çünkü JavaScript'te bir sayı üzerinde çağrılan parseInt onu önce metne çevirir ve 0.0000005 gibi değerlerde yanlış sonuç verir (5 döndürür). Sayılar için Math.trunc kullanın. Number.MAX_SAFE_INTEGER ötesindeki tam sayılar için BigInt(text) tam değeri ayrıştırır (geçersiz metinde NaN döndürmek yerine bir SyntaxError fırlatır).

Sayıyı String'e Çevirmek

String(n), n.toString() ve `${n}` ifadelerinin her biri bir sayıyı en kısa string biçimine çevirir. Biçimlendirme metotları daha fazla kontrol sağlar:

const n = 1234.5678;

console.log(String(n));            // 1234.5678
console.log(n.toString());         // 1234.5678
console.log(`${n}`);               // 1234.5678
console.log(n.toFixed(2));         // 1234.57
console.log(n.toPrecision(3));     // 1.23e+3
console.log(n.toLocaleString("en-US")); // 1,234.568
console.log((255).toString(16));   // ff
console.log((5).toString().padStart(3, "0")); // 005

const label: string = n.toFixed(1); // every method here returns string
console.log(label);                 // 1234.6

toFixed sizin yazdığınız ondalık sayıyı değil, ikili (binary) değeri yuvarlar; bu yüzden (1.005).toFixed(2) sonucu "1.00" olur: 1.005 aslında 1.005'ten biraz küçük olarak saklanır. Para için tutarları tam sayı kuruş olarak tutun ya da Intl.NumberFormat ile biçimlendirin.

String(n) ayrıca null ve undefined üzerinde de çalışır ("null" ve "undefined" verir); n.toString() ise değer eksik olabileceği için strict altında bir derleme hatası olurdu.

Hızlı Başvuru