---
title: number - Числа
summary: Числовые значения Lua обычно представлены double. Целые идентификаторы шире 53 бит нельзя безусловно преобразовывать в number: потеряется точность. tonumber возвращает nil при неудачном преобразовании.
section: reference
kind: guide
status: reference
updated: 2026-10-26
tags: ["API","X4"]
sources: ["https://wiki.egosoft.com/X4%20Foundations%20Wiki/Modding%20Support/","https://www.lua.org/manual/5.1/manual.html","https://luajit.org/ext_ffi_api.html"]
---
## Значение

Числовые значения Lua обычно представлены double. Целые идентификаторы шире 53 бит нельзя безусловно преобразовывать в number: потеряется точность. tonumber возвращает nil при неудачном преобразовании.

## Пример

```lua
local amount = tonumber("12")
if amount ~= nil then
  amount = math.max(0, amount)
end
```

**Что произойдёт:** amount = 12; math.max не меняет его, поскольку 12 больше 0.

Этот фрагмент не печатает сообщение и не пишет его в журнал. Здесь указаны ожидаемые значения примера.

## Методы и связанные вызовы


| Функция | Возвращает | Назначение |
| --- | --- | --- |
| [math.abs](wiki:api-standard-math-abs-e3c883a9) | [`number`](wiki:type-number) | Возвращает абсолютную величину числа. |
| [math.asin](wiki:api-standard-math-asin-0ff09b19) | [`number`](wiki:type-number) | Возвращает арксинус в радианах. |
| [math.atan2](wiki:api-standard-math-atan2-b4fe910e) | [`number`](wiki:type-number) | Возвращает угол по координатам y и x в радианах с учётом четверти. |
| [math.ceil](wiki:api-standard-math-ceil-bb032e94) | [`number`](wiki:type-number) | Округляет число к ближайшему большему целому. |
| [math.cos](wiki:api-standard-math-cos-4a293dba) | [`number`](wiki:type-number) | Возвращает косинус угла, заданного в радианах. |
| [math.deg](wiki:api-standard-math-deg-6ef5ae35) | [`number`](wiki:type-number) | Переводит радианы в градусы. |
| [math.floor](wiki:api-standard-math-floor-5776363e) | [`number`](wiki:type-number) | Округляет число к ближайшему меньшему целому. |
| [math.max](wiki:api-standard-math-max-4dc62550) | [`number`](wiki:type-number) | Возвращает наибольший из числовых аргументов. |
| [math.min](wiki:api-standard-math-min-9b2931d6) | [`number`](wiki:type-number) | Возвращает наименьший из числовых аргументов. |
| [math.rad](wiki:api-standard-math-rad-1bbc48b1) | [`number`](wiki:type-number) | Переводит градусы в радианы. |
| [math.random](wiki:api-standard-math-random-d0204929) | [`number`](wiki:type-number) | Даёт псевдослучайное число: без границ в [0,1), с одной границей целое от 1, с двумя целое в заданном диапазоне. |
| [math.sin](wiki:api-standard-math-sin-cd360f65) | [`number`](wiki:type-number) | Возвращает синус угла, заданного в радианах. |
| [math.sqrt](wiki:api-standard-math-sqrt-b3c6fba6) | [`number`](wiki:type-number) | Возвращает квадратный корень числа. |