# utils-number

## Оглавление <a href="#table-of-contents" id="table-of-contents"></a>

* [Функции](#features)
* [Установка](#installing)
* [Пример](#example)
* [Ресурсы](#resources)
* [Лицензия](#license)
* [Список изменений](#changelog)

## Функции <a href="#features" id="features"></a>

* [Сделайте числа читабельными](#ispolzovanie-funkcii-sp-and-rn)
* [Получить случайное число в выбранном диапазоне](#ispolzovanie-funkcii-random-and-pick)
* [Получить случайное сообщение из вашего списка](#ispolzovanie-funkcii-random-and-pick)
* [Узнать точную дату и время](#ispolzovanie-funkcii-data-and-time)
* [Получать эмоцию на успех и неудачу](#ispolzovanie-funkcii-smyle)
* [Перевод времени в миллисекунды](#ispolzovanie-funkcii-inmls)
* [Рассчитать прирост процентов](#ispolzovanie-funkcii-growth)
* [Расставить пробелы после каждой буквы в тексте](#ispolzovanie-funkcii-spacetext)

## Установка <a href="#installing" id="installing"></a>

#### Использование npm:

```bash
$ npm install utils-number
```

## Пример <a href="#example" id="example"></a>

#### Для подключения utils-number библиотеки введите следующий текст:

```javascript
const utils = require('utils-number');
```

#### Использование функции `sp` & `rn`:

```javascript
const utils = require('utils-number');

var number = 1000; //Choose a number

console.log(utils.sp(number, "."));
console.log(utils.rn(number));
```

#### Использование функции `random` & `pick`:

```javascript
const utils = require('utils-number');

var number = utils.random(1, 1000); //Set the number generation range
var word = utils.pick(['Apple', 'Node.JS', 'Table']); //We make a list of phrases.

console.log(number);
console.log(word);
```

{% hint style="info" %}
**Заметка**. Указывать диапазон необязательно, можно просто ввести максимальное число в аргумент
{% endhint %}

#### Использование функции `data` & `time`:

```javascript
const utils = require('utils-number');

var data = utils.data(); //Date display
var time = utils.time(); //Time display

console.log(data);
console.log(time);
```

#### Использование функции `smyle`:

```javascript
const utils = require('utils-number');

var success = utils.smile('sucs'); //Display success emoticon
var failure = utils.smile('fail'); //Show failure emoticon

console.log(success);
console.log(failure);
```

#### Использование функции `inmls`:

```javascript
const utils = require('utils-number');

var number = 100; //Choose a number

var sec = utils.inmls(number, 's'); //seconds
var min = utils.inmls(number, 'm'); //minute
var hour = utils.inmls(number, 'h'); //hours
var day = utils.inmls(number, 'd'); //days

console.log(day, hour, min, sec);
```

{% hint style="info" %}
**Заметка.** d - день; h - час; m - минута; s - секунда
{% endhint %}

#### **Использование функции `growth`**:

```javascript
const utils = require('utils-number');

var number1 = Number(x);
var number2 = Number(y);

var res = utils.growth(number1, number2);

console.log(res);
```

{% hint style="info" %}
**Заметка.** x - исходящее значение; x - конечное значение.
{% endhint %}

#### **Использование функции `spacetext`**:

```javascript
const utils = require("utils-number");

var text = `Test`;

var res = utils.spacetext(text);

console.log(res);
```

## Ресурсы <a href="#resources" id="resources"></a>

{% embed url="<https://npmjs.org/utils-number>" %}
**Переход на официальную страницу npmjs utils-number**
{% endembed %}

## Лицензия <a href="#license" id="license"></a>

#### MIT

## Список изменений <a href="#changelog" id="changelog"></a>

{% tabs %}
{% tab title="v. 1.0.26" %}

## Добавлена новая функция - **`spacetext`**.

#### Функция позволяет расставить пробелы после каждой буквы в тексте.

Исходные данные - `Test`.

Результат - `T e s t`.
{% endtab %}

{% tab title="v. 1.0.25" %}

## Добавлена новая функция - **`growth`**.

**Функция позволят рассчитать прирост процентов.**

**Аргументы:** x - исходящее значение; x - конечное значение.

**Пример результата:** 50%
{% endtab %}

{% tab title="v. 1.0.23" %}

## Добавлена новая функция - `inmls`.

#### Функция позволяет из любого времени сосчитать миллисекунды:

* day
* hour
* minute
* seconds
  {% endtab %}

{% tab title="v. 1.0.20" %}

## Добавлена новая функция - `smile`.

#### Функция позволяет выдать реакцию на определённую ситуацию:

* sucs - успех, реакции с галочками и символами **OK**.
* fail - неудача, реакции с **STOP** знаками.
*

{% endtab %}
{% endtabs %}
