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