# Вычисления

* [Создание графиков](#sozdanie-grafikov)
* [Генератор случайных чисел](#generator-sluchainykh-chisel)
* [Случайный выбор варианта](#sluchainyi-vybor-varianta)
* [Получение текущего времени по часовому поясу](#poluchenie-tekushego-vremeni-po-chasovomu-poyasu)
* [Получить текущую дату в формате ДД.ММ.ГГ](#poluchit-tekushuyu-datu-v-formate-dd.mm.gg)
* [Получение текущего времени](#poluchenie-tekushego-vremeni)
* [Получить текущий день недели](#poluchit-tekushii-den-nedeli)

## Создание графиков

Создание графиков

```
{
    "name": "generate_google_chart",
    "description": "Генерация графика с использованием Google Chart",
    "parameters": {
        "type": "object",
        "properties": {
            "user_data": {
                "type": "string",
                "description": "Данные для графика",
            },
            "user_comments": {
                "type": "string",
                "description": "Любые пожелания пользователя к графику. Может быть пустым.",
            },
        },
        "required": ["user_data", "user_comments"]
    },
},
```

## Генератор случайных чисел

Функция get\_random\_numbers принимает аргументы в виде словаря arguments, в котором необходимо указать количество случайных чисел (quantity), минимальное значение (min) и максимальное значение (max) для генерации случайных чисел. Далее функция делает запрос к внешнему API по указанному URL, передавая параметры в запросе. Полученный ответ в виде случайных чисел в указанном диапазоне возвращается в виде текстового значения.

```
{
    "name": "get_random_numbers",
    "description": "Получение случайных чисел через внешнее API",
    "parameters": {
        "type": "object",
        "properties": {
            "quantity": {
                "type": "integer",
                "description": "Количество случайных чисел",
            },
            "min": {
                "type": "integer",
                "description": "Минимальное значение случайного числа",
            },
            "max": {
                "type": "integer",
                "description": "Максимальное значение случайного числа",
            }
        },
        "required": ["quantity", "min", "max"]
    },
},
```

## Случайный выбор варианта

Данная функция принимает список текстовых значений в качестве аргумента и возвращает случайное значение из этого списка, используя миллисекунды для увеличения случайности выбора. Функция использует модули random и time для генерации случайного индекса с учетом текущего времени в миллисекундах.

```
{  
    "name": "get_random_text",  
    "description": "Выбор случайного элемента из списка",  
    "parameters": {  
        "type": "object",  
        "properties": { 
            "texts": {  
                "type": "string",  
                "description": "List of text values separated with comma",  
            }
        }, 
        "required": ["texts"],  
    },  
},

```

## Получение текущего времени по часовому поясу

Код функции get\_almaty\_time использует библиотеку pytz для работы с часовыми поясами и datetime для работы с временем. Функция получает текущее время в часовом поясе Алматы, форматирует его в формате hh:mm:ss и возвращает это время в виде строки.

```
{  
    "name": "get_time_by_timezone",  
    "description": "Получить текущее время по заданному часовому поясу",  
    "parameters": {  
        "type": "object",  
        "properties": { 
            "timezone": {  
                "type": "string",  
                "description": "Часовой пояс в формате 'Region/City'",  
            }, 
        }, 
        "required": ["timezone"],  
    },  
},
```

## Получить текущую дату в формате ДД.ММ.ГГ

Функция get\_current\_date предназначена для получения текущей даты в формате "ДД.ММ.ГГ".

1. Внутри функции происходит импорт модуля datetime, который предоставляет классы для работы с датами и временем.
2. С помощью метода datetime.now() мы получаем текущую дату и время.
3. Метод strftime("%d.%m.%y") форматирует дату в нужный формат: "ДД" - день, "ММ" - месяц, "ГГ" - последние две цифры года.
4. Функция возвращает строку с текущей датой в указанном формате.

Таким образом, вызвав эту функцию, вы всегда получите актуальную дату.

```
{  
    "name": "get_current_date",  
    "description": "Получить текущую дату в формате ДД.ММ.ГГ",  
    "parameters": {  
        "type": "object",  
        "properties": {},  
        "required": [],  
    },  
},
```

## Получение текущего времени

Эта функция get\_current\_time принимает на вход словарь arguments с ключом "timezone", который указывает на необходимый часовой пояс. Функция возвращает текущее время в указанном формате hh.mm.ss в соответствии с выбранным часовым поясом. Внутри функции используется модуль datetime для работы с временем.

```
{  
    "name": "get_current_time",  
    "description": "Получить текущее время в формате hh.mm.ss",  
    "parameters": {  
        "type": "object",  
        "properties": { 
            "timezone": {  
                "type": "string",  
                "description": "Часовой пояс",  
                "enum": ["UTC", "GMT", "EST", "CET", "PST"], 
            }
        }, 
        "required": ["timezone"],  
    },  
},

```

## Получить текущий день недели

Функция get\_day\_of\_week принимает на вход словарь arguments, содержащий ключ "date" с датой в формате 'ГГГГ-ММ-ДД'. Далее функция извлекает год, месяц и день из входной даты, затем определяет день недели для этой даты с помощью модуля datetime. Наконец, функция возвращает текущий день недели в текстовом формате.

```
{  
    "name": "get_day_of_week",  
    "description": "Получить текущий день недели",  
    "parameters": {  
        "type": "object",  
        "properties": { 
            "date": {  
                "type": "string",  
                "description": "Дата в формате 'ГГГГ-ММ-ДД'",  
            }
        }, 
        "required": ["date"],  
    },  
},

```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.iiagent.pro/funkcii/vychisleniya.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.