Math

Math — це вбудований об'єкт із полями й методами для реалізації математичних сталих та функцій. Не є функцією.

Math працює з числами типу Number. Він не підходить для роботи з BigInt.

Опис

На відміну від багатьох інших глобальних об'єктів, Math не є конструктором. Всі властивості та методи об'єкта Math — статичні. Тобто до числа пі слід звертатись через запис Math.PI, а функція синуса викликається як Math.sin(x), де x — це аргумент функції. Всі сталі оголошені з максимально допустимою точністю для дійсних чисел у JavaScript.

Примітка: Чимало функцій Math мають точність обчислень, залежну від конкретної реалізації.

Це означає, що різні браузери можуть давати різні результати. Навіть один і той самий JavaScript-рушій на різних ОС чи архітектурах процесора може видавати різні результати!

Статичні властивості

Math[@@toStringTag]

Початкове значення властивості @@toStringTag – рядок "Math". Ця властивість використовується в Object.prototype.toString().

Math.E

Число Ейлера, основа натуральних логарифмів. Приблизно дорівнює 2.718.

Math.LN2

Натуральний логарифм числа 2. Приблизно дорівнює 0.693.

Math.LN10

Натуральний логарифм числа 10. Приблизно дорівнює 2.303.

Math.LOG2E

Логарифм числа e за основою 2. Приблизно дорівнює 1.443.

Math.LOG10E

Логарифм числа e за основою 10. Приблизно дорівнює 0.434.

Math.PI

Значення відношення довжини кола до його діаметра, наближено дорівнює 3.14159.

Math.SQRT1_2

Квадратний корінь з ½. Наближено дорівнює 0.707.

Math.SQRT2

Квадратний корінь з 2. Наближено дорівнює 1.414.

Статичні методи

Math.abs()

Повертає модуль числа x.

Math.acos()

Повертає арккосинус числа x.

Math.acosh()

Повертає гіперболічний арккосинус числа x.

Math.asin()

Повертає арксинус числа x.

Math.asinh()

Повертає гіперболічний арксинус числа.

Math.atan()

Повертає арктангенс числа x.

Math.atanh()

Повертає гіперболічний арктангенс числа x.

Math.atan2()

Повертає арктангенс частки переданих аргументів.

Math.cbrt()

Повертає кубічний корінь числа x.

Math.ceil()

Повертає найменше ціле число, яке дорівнює, або більше за x.

Math.clz32()

Повертає кількість старших нульових бітів 32-бітного цілого числа x.

Math.cos()

Повертає косинус числа x.

Math.cosh()

Повертає гіперболічний косинус числа x.

Math.exp()

Повертає результат обчислення виразу e^x, де x — це аргумент, а e — число Ейлера (2.718…, основа натурального логарифма).

Math.expm1()

Повертає результат віднімання 1 від значення exp(x).

Math.floor()

Повертає найбільше ціле число, яке дорівнює, або менше за x.

Math.fround()

Повертає найближчий відповідник x у форматі числа з рухомою комою одинарної точності.

Math.hypot()

Повертає квадратний корінь з суми квадратів переданих аргументів.

Math.imul()

Повертає результат 32-бітного цілочисельного множення аргументів x та y.

Math.log()

Повертає натуральний логарифм (㏒_e, або ln) числа x.

Math.log1p()

Повертає натуральний логарифм (㏒_e, або ln) значення виразу 1 + x, обчисленого для аргументу x.

Math.log10()

Повертає логарифм аргументу x за основою 10.

Math.log2()

Повертає логарифм аргументу x за основою 2.

Math.max()

Повертає найбільше значення з-поміж нуля чи більше аргументів.

Math.min()

Повертає найменше значення з-поміж нуля чи більше аргументів.

Math.pow()

Повертає результат піднесення x до степеня y (тобто xy).

Math.random()

Повертає псевдовипадкове число від 0 до 1.

Math.round()

Повертає значення аргументу x, округлене до найближчого цілого.

Math.sign()

Повертає знак переданого числа x. Позначає, чи x є додатним, від'ємним, або нулем.

Math.sin()

Повертає синус числа x.

Math.sinh()

Повертає гіперболічний синус числа x.

Math.sqrt()

Повертає додатний квадратний корінь з числа x.

Math.tan()

Повертає тангенс числа x.

Math.tanh()

Повертає гіперболічний тангенс числа x.

Math.trunc()

Повертає цілу частину числа x, відкидаючи всі цифри після коми.

Приклади

Перетворення між градусами і радіанами

Тригонометричні функції: sin(), cos(), tan(), asin(), acos(), atan(), та atan2() — приймають (і повертають) кути в радіанах.

Оскільки люди мають схильність оперувати кутами в градусах, та й деякі функції (наприклад, CSS-трансформації) можуть приймати градуси, корисно мати напохваті функції для переведення значень з градусів у радіани, і навпаки:

function degToRad(degrees) {
  return degrees * (Math.PI / 180);
}

function radToDeg(rad) {
  return rad / (Math.PI / 180);
}

Обчислення висоти рівностороннього трикутника

Якщо потрібно обчислити висоту рівностороннього трикутника, і відомо, що довжина його сторони — 100, — можна застосувати формулу довжина прилеглого катета, помножена на тангенс кута, дорівнює довжині протилежного катета.

В JavaScript можна виконати це обчислення наступним чином:

50 * Math.tan(degToRad(60));

Тут використана функція degToRad() для переведення 60 градусів у радіани, оскільки Math.tan() приймає вхідні значення саме в радіанах.

Повернення випадкового цілого числа між вказаними межами

Це можна зробити, взявши комбінацію з Math.random() і Math.floor():

function random(min, max) {
  const num = Math.floor(Math.random() * (max - min + 1)) + min;
  return num;
}

random(1, 10);

Специфікації

Сумісність із браузерами

Дивіться також

• Number