number_format_i18n( float $number, int $decimals ): string

Converts float number to format based on the locale.

Parameters

$numberfloatrequired
The number to convert based on locale.
$decimalsintoptional
Precision of the number of decimal places. Default 0.

Return

string Converted number in string format.

More Information

i18n is an abbreviation for internationalization.

Source

function number_format_i18n( $number, $decimals = 0 ) {
	global $wp_locale;

	if ( isset( $wp_locale ) ) {
		$formatted = number_format( $number, absint( $decimals ), $wp_locale->number_format['decimal_point'], $wp_locale->number_format['thousands_sep'] );
	} else {
		$formatted = number_format( $number, absint( $decimals ) );
	}

	/**
	 * Filters the number formatted based on the locale.
	 *
	 * @since 2.8.0
	 * @since 4.9.0 The `$number` and `$decimals` parameters were added.
	 *
	 * @param string $formatted Converted number in string format.
	 * @param float  $number    The number to convert based on locale.
	 * @param int    $decimals  Precision of the number of decimal places.
	 */
	return apply_filters( 'number_format_i18n', $formatted, $number, $decimals );
}

Hooks

apply_filters( ‘number_format_i18n’, string $formatted, float $number, int $decimals )

Filters the number formatted based on the locale.

Changelog

VersionDescription
2.3.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.