Функция substr в Битрикс24 в 2025: инструкция по работе с текстом и числами

В процессе работы с Битрикс24 разработчики часто сталкиваются с необходимостью обработки текстовых данных и форматирования чисел. Функция substr и numberformat являются важными инструментами для решения подобных задач. В этой статье мы подробно рассмотрим возможности работы с данными функциями в среде Битрикс24, приведем практические примеры и дадим рекомендации по их эффективному использованию.

Что такое функция substr в Битрикс24

Функция substr в Битрикс24 представляет собой встроенный инструмент для извлечения подстроки из текстовой строки. Она позволяет разработчикам получить определенную часть текста, указав начальную позицию и длину извлекаемого фрагмента.

Основные возможности функции substr:

• Извлечение подстроки по заданным параметрам
• Работа с многобайтовыми кодировками
• Обрезка текста для отображения в интерфейсе
• Форматирование данных для вывода в отчетах

Синтаксис и параметры функции substr

Стандартный синтаксис функции substr в Битрикс24 выглядит следующим образом:

substr(string, start, length)

Где:

• string — исходная строка для обработки
• start — начальная позиция (отсчет с нуля)
• length — количество символов для извлечения (необязательный параметр)

Особенности работы с кодировками

При работе с кириллическими символами в Битрикс24 рекомендуется использовать функцию mb_substr, которая корректно обрабатывает многобайтовые кодировки:

mb_substr(string, start, length, 'UTF-8')

Практические примеры использования substr

Обрезка длинных названий

Часто в интерфейсе Битрикс24 необходимо отображать сокращенные версии длинных названий компаний или сделок:

$shortName = mb_substr($dealName, 0, 50, 'UTF-8');

Извлечение префикса номера телефона

Для анализа географического распределения клиентов можно извлекать коды городов:

$cityCode = substr($phoneNumber, 0, 3);

Форматирование артикулов товаров

При работе с каталогом товаров можно выделять определенные части артикула:

$categoryCode = substr($productCode, 0, 2);

Функция numberformat в Битрикс24

Функция numberformat предназначена для форматирования числовых значений в удобочитаемом виде. Она особенно полезна при работе с финансовыми данными, статистикой и отчетами.

Основные возможности numberformat

• Форматирование чисел с разделителями тысяч
• Установка количества знаков после запятой
• Настройка символов-разделителей
• Локализация числовых форматов

Синтаксис функции numberformat

Стандартный синтаксис функции:

number_format(number, decimals, decimal_separator, thousands_separator)

Параметры:

• number — число для форматирования
• decimals — количество знаков после запятой
• decimal_separator — символ-разделитель дробной части
• thousands_separator — символ-разделитель тысяч

Примеры использования numberformat в Битрикс24

Форматирование суммы сделки

Для отображения суммы сделки в удобном формате:

$formattedAmount = number_format($dealAmount, 2, ',', ' ');

Результат: 1 234 567,89

Отображение процентных значений

При работе с аналитикой и KPI:

$percentage = number_format($conversionRate * 100, 1, ',', '') . '%';

Форматирование количества товаров

Для отображения больших количеств в складских отчетах:

$quantity = number_format($productQuantity, 0, '', ' ');

Интеграция с API Битрикс24

При работе с REST API Битрикс24 функции substr и numberformat можно использовать для предобработки данных перед отправкой или после получения:

Обработка данных контактов

При получении списка контактов через API можно сразу форматировать отображаемые данные:


foreach ($contacts as &$contact) {
    $contact['SHORT_NAME'] = mb_substr($contact['NAME'], 0, 20, 'UTF-8');
    $contact['FORMATTED_REVENUE'] = number_format($contact['REVENUE'], 0, ',', ' ');
}


Работа с пользовательскими полями

В Битрикс24 часто требуется обрабатывать данные пользовательских полей. Функции substr и numberformat помогают привести эти данные к нужному формату:

Обработка текстовых полей

Для ограничения длины комментариев или описаний:

$shortDescription = mb_substr($customField['DESCRIPTION'], 0, 100, 'UTF-8') . '...';

Форматирование числовых пользовательских полей

При работе с финансовыми показателями:

$formattedBudget = number_format($customField['BUDGET'], 2, ',', ' ') . ' руб.';

Оптимизация производительности

При работе с большими объемами данных важно учитывать производительность:

Кеширование результатов

Для часто используемых операций стоит применять кеширование:


$cacheKey = 'formatted_' . md5($originalString);
if (!$cached = $cache->get($cacheKey)) {
    $cached = mb_substr($originalString, 0, 50, 'UTF-8');
    $cache->set($cacheKey, $cached, 3600);
}


Пакетная обработка

При обработке больших массивов данных рекомендуется группировать операции:


$batchSize = 100;
$batches = array_chunk($dataArray, $batchSize);
foreach ($batches as $batch) {
    // Обработка пакета данных
}


Обработка ошибок и валидация

При использовании функций substr и numberformat важно предусмотреть обработку возможных ошибок:

Валидация входных данных


function safeSubstr($string, $start, $length = null) {
    if (!is_string($string) || !is_numeric($start)) {
        return '';
    }
    return mb_substr($string, $start, $length, 'UTF-8');
}


Безопасное форматирование чисел


function safeNumberFormat($number, $decimals = 2) {
    if (!is_numeric($number)) {
        return '0';
    }
    return number_format($number, $decimals, ',', ' ');
}


Практические кейсы использования

Создание отчетов по продажам

При формировании отчетов часто требуется комбинировать обе функции:


$report[] = [
    'manager' => mb_substr($managerName, 0, 15, 'UTF-8'),
    'deals_count' => number_format($dealsCount, 0, '', ' '),
    'total_amount' => number_format($totalAmount, 2, ',', ' ') . ' руб.'
];


Оптимизация интерфейса

Для улучшения пользовательского опыта в веб-интерфейсе:


$displayData = [
    'title' => mb_substr($title, 0, 30, 'UTF-8') . (mb_strlen($title, 'UTF-8') > 30 ? '...' : ''),
    'price' => number_format($price, 0, '', ' ') . ' ₽'
];


Интеграция с другими системами

При интеграции Битрикс24 с внешними системами функции форматирования данных становятся особенно важными:

Подготовка данных для экспорта

Перед отправкой данных в учетные системы:


$exportData = [
    'product_code' => substr($fullProductCode, 0, 10),
    'amount' => number_format($amount, 2, '.', '')
];


Обработка импортированных данных

При получении данных из внешних источников:


$cleanedData = [
    'description' => mb_substr(trim($rawData['description']), 0, 255, 'UTF-8'),
    'price' => (float)str_replace([' ', ','], ['', '.'], $rawData['price'])
];


Автоматизация с помощью бизнес-процессов

В Битрикс24 можно создавать бизнес-процессы, которые автоматически применяют функции форматирования:

Автоматическое сокращение названий

Настройка бизнес-процесса для автоматического создания коротких названий сделок:


if (mb_strlen($dealTitle, 'UTF-8') > 50) {
    $shortTitle = mb_substr($dealTitle, 0, 47, 'UTF-8') . '...';
    // Обновление поля через API
}


Мобильная разработка

При разработке мобильных приложений для работы с Битрикс24 функции форматирования особенно важны из-за ограниченного пространства экрана:

Адаптация под мобильные устройства


$mobileData = [
    'client_name' => mb_substr($clientName, 0, 20, 'UTF-8'),
    'amount' => number_format($amount / 1000, 0, '', '') . 'K'
];


Локализация и многоязычность

При работе с многоязычными проектами важно учитывать особенности локализации:

Адаптация под разные локали


function formatCurrency($amount, $locale = 'ru_RU') {
    switch ($locale) {
        case 'ru_RU':
            return number_format($amount, 2, ',', ' ') . ' руб.';
        case 'en_US':
            return '$' . number_format($amount, 2, '.', ',');
        default:
            return number_format($amount, 2);
    }
}


Тестирование и отладка

При использовании функций substr и numberformat важно проводить тщательное тестирование:

Модульные тесты


function testSubstrFunction() {
    $testString = 'Тестовая строка';
    $result = mb_substr($testString, 0, 4, 'UTF-8');
    assert($result === 'Тест');
}


Граничные случаи

Особое внимание следует уделить тестированию граничных случаев:


// Тестирование пустых строк
assert(mb_substr('', 0, 5, 'UTF-8') === '');
// Тестирование больших чисел
assert(number_format(999999999, 0, '', ' ') === '999 999 999');


Заключение

Функции substr и numberformat являются мощными инструментами для работы с данными в Битрикс24. Правильное использование этих функций позволяет создавать удобные пользовательские интерфейсы, формировать качественные отчеты и обеспечивать корректную интеграцию с внешними системами.

Основные принципы эффективного использования:

• Всегда валидируйте входные данные
• Используйте многобайтовые функции для работы с кириллицей
• Предусматривайте обработку ошибок
• Оптимизируйте производительность при работе с большими объемами данных
• Тестируйте функции на граничных случаях

Наша команда специализируется на настройке и внедрении Битрикс24 для бизнеса любого масштаба. Мы поможем вам максимально эффективно использовать возможности платформы, включая программирование пользовательских решений с применением функций обработки данных. Обращайтесь к нам за профессиональной консультацией по оптимизации рабочих процессов в Битрикс24, созданию автоматизированных бизнес-процессов и интеграции с внешними системами.