Функция zeroise() в WordPress автоматически добавляет нули перед числом, если его количество символов меньше указанного порога. Это полезно, например, при форматировании чисел для визуальной согласованности, как в случае с номерами страниц или форматами дат.
zeroise( int $number, int $threshold ): string
Параметры
$number(обязательный): Число, к которому нужно добавить ведущие нули, если оно короче указанного порога.$threshold(обязательный): Целое число, определяющее минимальную длину итоговой строки. Если длина$numberменьше этого значения, к числу будут добавлены нули.
Возвращаемое значение
Возвращает строку с добавленными нулями (если это необходимо).
Как работает zeroise()
Функция zeroise() использует sprintf() для добавления нулей в начале числа. Если число превышает или равно заданному $threshold, нули не добавляются.
Пример 1: Форматирование однозначного числа с порогом в 2
Используем функцию zeroise() для числа комментариев. Если комментариев меньше 10, функция добавит ноль в начале.
$comments_number = get_comments_number(); // Допустим, число комментариев = 3
echo zeroise($comments_number, 2);
Результат:
03Здесь zeroise() добавляет один ноль перед 3, чтобы привести длину строки к значению 2.
Пример 2: Форматирование двухзначного числа с порогом в 4
Форматируем число просмотров, чтобы отображать его как четырёхзначное значение.
$views_count = 47;
echo zeroise($views_count, 4);
Результат:
0047
Так как длина числа 47 меньше 4, перед числом добавляется два нуля, чтобы оно выглядело как 0047.
Пример 3: Без добавления нулей для чисел, превышающих порог
Если число символов в $number уже равно или больше $threshold, zeroise() не добавляет нули.
$post_views = 1025;
echo zeroise($post_views, 4);
Результат:
1025
Число 1025 уже соответствует порогу в 4 символа, поэтому ведущие нули не добавляются.
Пример 4: Использование zeroise() для форматирования даты
Форматируем номер месяца в дате, добавляя ведущий ноль, если месяц однозначный.
$month = 5;
echo zeroise($month, 2); // Добавит ноль к однозначному числуРезультат:
05Здесь zeroise() позволяет сохранить формат даты в виде MM-DD-YYYY, добавив ноль перед 5.
Пример 5: Применение к пользовательскому порядковому номеру
Рассмотрим использование zeroise() для создания порядкового номера в формате 001, 002, и т.д., при пороге в 3 символа.
$order_number = 8;
echo zeroise($order_number, 3);
Результат:
008Для order_number = 8 функция добавит два нуля, создавая строку с длиной в 3 символа.
Заключение
Функция zeroise() в WordPress — это удобный способ форматирования чисел с добавлением ведущих нулей. Она позволяет соблюдать согласованность формата, что может улучшить визуальное восприятие чисел в интерфейсе.