Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Math.ceil: zaokrąglenie w górę

Math.ceil konwertuje argument na Number i zwraca najmniejszą całkowitą wartość numeryczną nie mniejszą od wejścia.

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

Składnia

Math.ceil(x)

Math.ceil(x) stosuje ToNumber, a następnie zaokrągla w kierunku +Infinity. Dlatego ceil(4.01) to 5, ale ceil(-4.99) to -4. Liczba już całkowita oraz ±Infinity pozostają bez zmian, NaN daje NaN. Dla wartości ujemnej pomiędzy -1 a 0 wynikiem jest -0, więc znak zera może mieć znaczenie w dalszych obliczeniach.

Konwersja oznacza, że łańcuch liczbowy działa, null staje się 0, a brak argumentu daje NaN. Symbol i BigInt powodują TypeError; obiekt może uruchomić valueOf lub toString. Wynik nadal jest Number: funkcja nie odzyskuje całkowitych cyfr utraconych wcześniej przez precyzję IEEE 754.

Funkcja nie jest konstruktorem i jest standardowa od ECMAScript 1. Przydaje się do liczby stron Math.ceil(total / pageSize) albo liczby potrzebnych pełnych jednostek. Różni się od floor dla liczb ujemnych, od trunc kierunkiem oraz od round regułą połówek. Przed dzieleniem sprawdź dodatni, niezerowy rozmiar jednostki.

Przykłady

const totalItems = 101;
const pageSize = 20;
console.log(Math.ceil(totalItems / pageSize));
console.log(Math.ceil(4.01), Math.ceil(-4.99));
console.log(Object.is(Math.ceil(-0.25), -0));
console.log(Math.ceil("3.2"), Math.ceil(null));
console.log(Number.isNaN(Math.ceil()), Math.ceil(Infinity));
try { Math.ceil(1n); } catch (error) { console.log(error instanceof TypeError); }

Wynik

6
5 -4
true
4 0
true Infinity
true

Źródła