Устанавливает значение для атрибута форматирования чисел

# NumberFormatter::setAttribute

# numfmt_set_attribute

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

NumberFormatter::setAttribute -- numfmt_set_attribute — Устанавливает значение для атрибута форматирования чисел

### Описание

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

public function NumberFormatter::setAttribute(int `$attribute`, int|float `$value`): bool

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

function numfmt_set_attribute(NumberFormatter `$formatter`, int `$attribute`, int|float `$value`): bool

Функция устанавливает значение для атрибута форматирования чисел. Пример атрибута числового формата — количество разрядов в целой части числа, которое выведет средство форматирования.

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

`formatter`

  Объект NumberFormatter.

`attribute`

  Спецификатор атрибута — константа атрибута форматирования чисел.

`value`

  Значение для атрибута.

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

Функция возвращает `true`, если выполнилась успешно, или `false`, если возникла ошибка.

### Примеры

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

    <?php

    $fmt = numfmt_create('de_DE', NumberFormatter::DECIMAL);
    echo "Количество разрядов в дробной части числа: " . numfmt_get_attribute($fmt, NumberFormatter::MAX_FRACTION_DIGITS) . "\n";
    echo numfmt_format($fmt, 1234567.891234567890000) . "\n";

    numfmt_set_attribute($fmt, NumberFormatter::MAX_FRACTION_DIGITS, 2);
    echo "Количество разрядов в дробной части числа: " . numfmt_get_attribute($fmt, NumberFormatter::MAX_FRACTION_DIGITS) . "\n";
    echo numfmt_format($fmt, 1234567.891234567890000) . "\n";

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

    <?php

    $fmt = new NumberFormatter('de_DE', NumberFormatter::DECIMAL);
    echo "Количество разрядов в дробной части числа: " . $fmt->getAttribute(NumberFormatter::MAX_FRACTION_DIGITS) . "\n";
    echo $fmt->format(1234567.891234567890000) . "\n";

    $fmt->setAttribute(NumberFormatter::MAX_FRACTION_DIGITS, 2);
    echo "Количество разрядов в дробной части числа: " . $fmt->getAttribute(NumberFormatter::MAX_FRACTION_DIGITS) . "\n";
    echo $fmt->format(1234567.891234567890000) . "\n";

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

    Количество разрядов в дробной части числа: 3
    1.234.567,891
    Количество разрядов в дробной части числа: 2
    1.234.567,89

Пример #3 Пример усечения значений атрибутом `NumberFormatter::ROUNDING_MODE`

По умолчанию объект NumberFormatter округляет значения. В режиме `NumberFormatter::ROUND_DOWN` для атрибута `NumberFormatter::ROUNDING_MODE` функция усекает значение до заданного количества дробных разрядов без округления.

    <?php

    $fmt = new NumberFormatter('en_US', NumberFormatter::DECIMAL);
    $fmt->setAttribute(NumberFormatter::FRACTION_DIGITS, 2);

    echo "Округление в режиме по умолчанию:\n";
    echo $fmt->format(3.789), "\n"; // 3.79 — результат округления вверх
    echo $fmt->format(3.781), "\n"; // 3.78 — результат округления вниз

    $fmt->setAttribute(NumberFormatter::ROUNDING_MODE, NumberFormatter::ROUND_DOWN);

    echo "\nУсечение в режиме ROUND_DOWN:\n";
    echo $fmt->format(3.789), "\n"; // 3.78 — результат усечения
    echo $fmt->format(3.781), "\n"; // 3.78 — результат усечения

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

    Округление в режиме по умолчанию:
    3.79
    3.78

    Усечение в режиме ROUND_DOWN:
    3.78
    3.78

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

- numfmt_get_error_code() - Получает последний код ошибки средства форматирования
- numfmt_get_attribute() - Получает атрибут
- numfmt_set_text_attribute() - Устанавливает текстовый атрибут

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open