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