NumberFormatter::setAttribute

numfmt_set_attribute

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

NumberFormatter::setAttribute -- numfmt_set_attributeSet an attribute

Beschreibung

Objektorientierter Stil

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

Prozeduraler Stil

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

Set a numeric attribute associated with the formatter. An example of a numeric attribute is the number of integer digits the formatter will produce.

Parameter-Liste

formatter

NumberFormatter object.

attribute

Attribute specifier - one of the numeric attribute constants.

value

The attribute value.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Beispiele

Beispiel #1 numfmt_set_attribute() example

<?php
$fmt
= numfmt_create( 'de_DE', NumberFormatter::DECIMAL );
echo
"Digits: ".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
"Digits: ".numfmt_get_attribute($fmt, NumberFormatter::MAX_FRACTION_DIGITS)."\n";
echo
numfmt_format($fmt, 1234567.891234567890000)."\n";
?>

Beispiel #2 OO example

<?php
$fmt
= new NumberFormatter( 'de_DE', NumberFormatter::DECIMAL );
echo
"Digits: ".$fmt->getAttribute(NumberFormatter::MAX_FRACTION_DIGITS)."\n";
echo
$fmt->format(1234567.891234567890000)."\n";
$fmt->setAttribute(NumberFormatter::MAX_FRACTION_DIGITS, 2);
echo
"Digits: ".$fmt->getAttribute(NumberFormatter::MAX_FRACTION_DIGITS)."\n";
echo
$fmt->format(1234567.891234567890000)."\n";
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Digits: 3
1.234.567,891
Digits: 2
1.234.567,89

Beispiel #3 Using NumberFormatter::ROUNDING_MODE to truncate values

By default, NumberFormatter rounds values. Using NumberFormatter::ROUND_DOWN as the NumberFormatter::ROUNDING_MODE truncates the value to the specified number of fraction digits without rounding.

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

echo
"Default rounding mode:\n";
echo
$fmt->format(3.789), "\n"; // 3.79 (rounded up)
echo $fmt->format(3.781), "\n"; // 3.78 (rounded down)

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

echo
"\nWith ROUND_DOWN (truncate):\n";
echo
$fmt->format(3.789), "\n"; // 3.78 (truncated)
echo $fmt->format(3.781), "\n"; // 3.78 (truncated)
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Default rounding mode:
3.79
3.78

With ROUND_DOWN (truncate):
3.78
3.78

Siehe auch

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top