云策 WordPress 开发者社区

函数文档

timer_stop()

查看官方原文 ↗
💡 云策文档标注

概述

timer_stop() 函数用于计算并返回或显示从页面开始加载到函数调用时的执行时间，支持自定义精度和输出方式。

关键要点

  • 函数返回或显示页面加载时间，格式为“秒.微秒”，支持本地化和四舍五入。
  • 参数 $display 控制输出行为：0 或 false 返回结果，1 或 true 直接输出。
  • 参数 $precision 指定小数点后的位数，默认值为 3。
  • 内部使用 $timestart 和 $timeend 全局变量计算时间差，优先调用 number_format_i18n() 进行本地化格式化。

代码示例

// 示例1：返回时间并指定精度
echo( 'Seconds: ' . timer_stop( 0 ) . '' );
echo( 'Seconds: ' . timer_stop( 0, 5 ) . '' );
echo( 'Seconds: ' . timer_stop( 0, 10 ) . '' );

// 示例2：在页脚输出加载时间
add_action( 'wp_footer', function() {
    echo '' . 'The page is loaded in ' . timer_stop() . ' seconds ';
}, PHP_INT_MAX );
📄 原文内容

Retrieves or displays the time from the page start to when function is called.

Parameters

$displayint|boolrequired
Whether to echo or return the results. Accepts 0|false for return, 1|true for echo. Default 0|false.
$precisionintoptional
The number of digits from the right of the decimal to display.

Default:3

Return

string The “second.microsecond” finished time calculation. The number is formatted for human consumption, both localized and rounded.

Source

function timer_stop( $display = 0, $precision = 3 ) {
	global $timestart, $timeend;

	$timeend   = microtime( true );
	$timetotal = $timeend - $timestart;

	if ( function_exists( 'number_format_i18n' ) ) {
		$r = number_format_i18n( $timetotal, $precision );
	} else {
		$r = number_format( $timetotal, $precision );
	}

	if ( $display ) {
		echo $r;
	}

	return $r;
}

View all references View on Trac View on GitHub

Uses Description
number_format_i18n()wp-includes/functions.php

Converts float number to format based on the locale.

Changelog

Version Description
0.71 Introduced.

User Contributed Notes

  1. Skip to note 3 content


    Codex


    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

    Determine length of time to render page with a precision of 3, 5 and 10 digits.

    echo( 'Seconds: ' . timer_stop( 0 ) . '<br />' );
echo( 'Seconds: ' . timer_stop( 0, 5 ) . '<br />' );
echo( 'Seconds: ' . timer_stop( 0, 10 ) . '<br />' );

    Output:

    Seconds: 0.815
Seconds: 0.81551
Seconds: 0.8155429363