Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Math.round: najbliższa liczba całkowita

Math.round konwertuje argument do Number i zwraca najbliższą całkowitą wartość Number, rozstrzygając remisy w stronę +Infinity.

Wersja: ECMAScript 1 onward; example target: Node.js 24.22.2

Składnia

Math.round(x)

Math.round(x) stosuje ToNumber. Jeśli dwie liczby całkowite są równie bliskie, wybiera tę bliższą +Infinity: 2.5 daje 3, ale -2.5 daje -2. Argument już całkowity, NaN, +Infinity, -Infinity, +0 lub -0 jest zwracany z zachowaniem szczególnej wartości.

W przedziale od -0.5 włącznie do 0 wyłącznie wynikiem jest -0; można go odróżnić przez Object.is lub odwrotność. Dlatego Math.round(x) nie zawsze jest równoważne Math.floor(x + 0.5), które może zgubić znak zera, a dodawanie może też zaokrąglić bardzo duże x.

Łańcuch liczbowy jest konwertowany, brak argumentu daje NaN, a Symbol lub BigInt powoduje TypeError. Funkcja istnieje od ECMAScript 1 i nie jest konstruktorem. Służy do wartości liczbowych, nie do formatowania tekstu; liczbę miejsc dziesiętnych formatuj oddzielnie, pamiętając o zaokrągleniach binary64.

Przykłady

console.log([2.3, 2.5, -2.5, -2.6].map(Math.round).join(","));
console.log(Object.is(Math.round(-0.5), -0), Object.is(Math.round(-0.1), -0));
console.log(Math.round("4.6"), Math.round(Infinity));
console.log(Number.isNaN(Math.round()), Object.is(Math.round(-0), -0));
try { Math.round(3n); } catch (error) { console.log(error instanceof TypeError); }

Wynik

2,3,-2,-3
true true
5 Infinity
true true
true

Math.round → ties toward +Infinity and preserved -0

Źródła