number_format_i18n()

💡 云策文档标注

概述

number_format_i18n() 是一个 WordPress 函数，用于根据当前区域设置（locale）格式化浮点数。它基于 PHP 的 number_format() 函数，但自动应用本地化的千位分隔符和小数点符号。

关键要点

函数签名：number_format_i18n( $number, $decimals = 0 )，其中 $number 为要格式化的浮点数（必需），$decimals 为小数位数（可选，默认 0）。
返回值：格式化后的字符串，使用 $wp_locale 中的 number_format 设置（如 decimal_point 和 thousands_sep），若未设置则回退到默认格式。
提供过滤器：apply_filters( 'number_format_i18n', $formatted, $number, $decimals )，允许开发者自定义格式化输出。
相关函数：依赖 absint() 确保 $decimals 为非负整数，并常用于 WordPress 核心的多个场景，如显示评论数、分页链接等。

代码示例

$number = 3948;
$formatted = number_format_i18n( $number ); // 输出类似 "3,948"

$formatted = number_format_i18n( $number, 2 ); // 输出类似 "3,948.00"

📄 原文内容

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 );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘number_format_i18n’, string $formatted, float $number, int $decimals ): Filters the number formatted based on the locale.

Uses	Description
absint()`wp-includes/load.php`	Converts a value to non-negative integer.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.

Used by	Description
WP_Site_Health::get_test_page_cache()`wp-admin/includes/class-wp-site-health.php`	Tests if a full page cache is available.
rest_validate_object_value_from_schema()`wp-includes/rest-api.php`	Validates an object value based on a schema.
rest_validate_array_value_from_schema()`wp-includes/rest-api.php`	Validates an array value based on a schema.
rest_validate_string_value_from_schema()`wp-includes/rest-api.php`	Validates a string value based on a schema.
WP_MS_Sites_List_Table::get_views()`wp-admin/includes/class-wp-ms-sites-list-table.php`	Gets links to filter sites by status.
WP_Privacy_Requests_Table::get_views()`wp-admin/includes/class-wp-privacy-requests-table.php`	Gets an associative array ( id => link ) with the list of views available on this table.
WP_Customize_Manager::handle_load_themes_request()`wp-includes/class-wp-customize-manager.php`	Loads themes into the theme browsing/installation UI.
WP_Widget_Media::display_media_state()`wp-includes/widgets/class-wp-widget-media.php`	Filters the default media display states for items in the Media list table.
WP_Customize_Manager::save_changeset_post()`wp-includes/class-wp-customize-manager.php`	Saves the post for the loaded changeset.
print_embed_comments_button()`wp-includes/embed.php`	Prints the necessary markup for the embed comments button.
WP_Customize_Nav_Menus::enqueue_scripts()`wp-includes/class-wp-customize-nav-menus.php`	Enqueues scripts and styles for Customizer pane.
WP_Customize_Nav_Menus::customize_register()`wp-includes/class-wp-customize-nav-menus.php`	Adds the customizer settings and controls.
WP_MS_Sites_List_Table::column_users()`wp-admin/includes/class-wp-ms-sites-list-table.php`	Handles the users column output.
get_comments_number_text()`wp-includes/comment-template.php`	Displays the language string for the number of comments the current post has.
WP_MS_Users_List_Table::get_views()`wp-admin/includes/class-wp-ms-users-list-table.php`
WP_Screen::render_screen_layout()`wp-admin/includes/class-wp-screen.php`	Renders the option for number of columns on the page.
WP_Plugins_List_Table::get_views()`wp-admin/includes/class-wp-plugins-list-table.php`
WP_User_Search::do_paging()`wp-admin/includes/deprecated.php`	Handles paging for the user search query.
WP_List_Table::ajax_response()`wp-admin/includes/class-wp-list-table.php`	Handles an incoming ajax request (called from admin-ajax.php)
WP_List_Table::comments_bubble()`wp-admin/includes/class-wp-list-table.php`	Displays a comment count bubble.
WP_List_Table::pagination()`wp-admin/includes/class-wp-list-table.php`	Displays the pagination.
WP_MS_Themes_List_Table::get_views()`wp-admin/includes/class-wp-ms-themes-list-table.php`
install_plugin_information()`wp-admin/includes/plugin-install.php`	Displays plugin information in dialog box form.
wp_dashboard_quota()`wp-admin/includes/dashboard.php`	Displays file upload quota on dashboard.
wp_dashboard_right_now()`wp-admin/includes/dashboard.php`	Dashboard widget that displays some basic stats about the site.
wp_network_dashboard_right_now()`wp-admin/includes/dashboard.php`
WP_Plugin_Install_List_Table::display_rows()`wp-admin/includes/class-wp-plugin-install-list-table.php`	Generates the list table rows.
wp_star_rating()`wp-admin/includes/template.php`	Outputs a HTML element with a star rating for a given rating.
WP_Users_List_Table::single_row()`wp-admin/includes/class-wp-users-list-table.php`	Generates HTML for a single row on the users.php admin panel.
WP_Users_List_Table::get_views()`wp-admin/includes/class-wp-users-list-table.php`	Returns an associative array listing all the views that can be used with this table.
media_upload_library_form()`wp-admin/includes/media.php`	Outputs the legacy media upload form for the media library.
media_handle_upload()`wp-admin/includes/media.php`	Saves a file submitted from a POST request and create an attachment post for it.
wp_ajax_query_themes()`wp-admin/includes/ajax-actions.php`	Handles getting themes from themes_api() via AJAX.
_wp_ajax_delete_comment_response()`wp-admin/includes/ajax-actions.php`	Sends back current comment total and new page links if they need to be updated.
wp_ajax_replyto_comment()`wp-admin/includes/ajax-actions.php`	Handles replying to a comment via AJAX.
post_submit_meta_box()`wp-admin/includes/meta-boxes.php`	Displays post submit form fields.
WP_Comments_List_Table::get_views()`wp-admin/includes/class-wp-comments-list-table.php`
WP_Terms_List_Table::column_posts()`wp-admin/includes/class-wp-terms-list-table.php`
WP_Terms_List_Table::column_links()`wp-admin/includes/class-wp-terms-list-table.php`
WP_Posts_List_Table::get_views()`wp-admin/includes/class-wp-posts-list-table.php`
list_plugin_updates()`wp-admin/update-core.php`	Display the upgrade plugins form.
list_theme_updates()`wp-admin/update-core.php`	Display the upgrade themes form.
Walker_Category::start_el()`wp-includes/class-walker-category.php`	Starts the element output.
Walker_CategoryDropdown::start_el()`wp-includes/class-walker-category-dropdown.php`	Starts the element output.
wp_generate_tag_cloud()`wp-includes/category-template.php`	Generates a tag cloud (heatmap) from provided data.
wp_notify_moderator()`wp-includes/pluggable.php`	Notifies the moderator of the site about a new comment that is awaiting approval.
paginate_links()`wp-includes/general-template.php`	Retrieves paginated links for archive post pages.
timer_stop()`wp-includes/load.php`	Retrieves or displays the time from the page start to when function is called.
size_format()`wp-includes/functions.php`	Converts a number of bytes to the largest unit the bytes will fit into.
wp_admin_bar_comments_menu()`wp-includes/admin-bar.php`	Adds edit comments link with awaiting moderation count bubble.
wp_admin_bar_updates_menu()`wp-includes/admin-bar.php`	Provides an update link if theme/plugin/core updates are available.
wpmu_validate_blog_signup()`wp-includes/ms-functions.php`	Processes new site registrations.
comments_popup_link()`wp-includes/comment-template.php`	Displays the link to the comments for the current post ID.
WP_Customize_Widgets::enqueue_scripts()`wp-includes/class-wp-customize-widgets.php`	Enqueues scripts and styles for Customizer panel and export data to JavaScript.

Show 49 more Show less

Changelog

Version	Description
2.3.0	Introduced.

User Contributed Notes

Skip to note 3 content

Codex

10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Basic Example
```
$number = 3948;

$formatted = number_format_i18n( $number );
```
$formatted will now be something like “3,948”.
Log in to add feedback
Skip to note 4 content

Codex

10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Using the $decimal Parameter
```
$number = 3948;

$formatted = number_format_i18n( $number, 2 );
```
$formatted will now be something like “3,948.00”.
Log in to add feedback

云策 WordPress 开发者社区

函数文档