NumberFormatter::format

numfmt_format

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

NumberFormatter::format -- numfmt_format — Форматирует число

Описание

Объектно-ориентированный стиль

public function NumberFormatter::format(int|float $num, int $type = NumberFormatter::TYPE_DEFAULT): string|false

Процедурный стиль

function numfmt_format(NumberFormatter $formatter, int|float $num, int $type = NumberFormatter::TYPE_DEFAULT): string|false

Функция форматирует числовое значение по правилами средства форматирования.

Список параметров

formatter: Объект NumberFormatter.
num: Значение для форматирования. Параметр принимает значения int, float и другие типы, которые преобразовываются в числовое значение.
type: Тип форматирования. Параметр не поддерживает константу NumberFormatter::TYPE_CURRENCY; вместо вызова с этим флагом значение валюты форматируют методом NumberFormatter::formatCurrency().

Возвращаемые значения

Функция возвращает строку, которая содержит отформатированное значение, или false, если возникла ошибка.

Примеры

Пример #1 Пример форматирования числа функцией numfmt_format()

<?php

$fmt = numfmt_create('de_DE', NumberFormatter::DECIMAL);
$data = numfmt_format($fmt, 1234567.891234567890000);
var_dump($data);

?>

Пример #2 Пример форматирования числа в объектно-ориентированном стиле

<?php

$fmt = new NumberFormatter( 'de_DE', NumberFormatter::DECIMAL );
$data = $fmt->format(1234567.891234567890000);
var_dump($data);

?>

Результат выполнения приведённого примера:

string(13) "1.234.567,891"

Примечания

Замечание:
Этот метод форматирования поддерживает функции базовой библиотеки ICU не на 100 % и, например, не разрешает выбирать формат обозначения валюты: р. или ₽.

Полную поддержку функций библиотеки даёт функция msgfmt_format_message().

Смотрите также

numfmt_get_error_code() - Получает последний код ошибки средства форматирования
numfmt_format_currency() - Форматирует значение валюты
numfmt_parse() - Разбирает число
msgfmt_format_message() - Быстро форматирует сообщение

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 1 note

down

mrSplendid ¶

3 years ago

on Linux you may need to install icu-data-full package for NumberFormatter to work properly with non-english locales.

＋Добавить