microtime

現在の Unix タイムスタンプをマイクロ秒まで返す

説明

stringfloat microtime(bool $as_float = false)

microtime は、現在の Unix タイムスタンプをマイクロ秒単位で返します。この関数は、gettimeofday() システムコールをサポートするオペレーティングシステムでのみ使用できます。

パフォーマンスの計測には、hrtime を使うことをお勧めします。

パラメータ

as_float: true を指定すると、microtime は文字列ではなく float を返すようになります。詳細は、戻り値の説明を参照ください。

戻り値

デフォルトでは、microtime は "msec sec" 形式の文字列を返します。ただし、sec は Unix エポック (1970 年 1 月 1 日 0:00:00 GMT) からの経過秒数、msec は sec から経過したマイクロ秒数を秒単位、つまり小数で表したものです。

as_float を true に設定すると、microtime は Unixエポックからの経過秒数をマイクロ秒で正確になるように float で表したものを返します。

例

例1 タイマスクリプト実行

<?php
$time_start = microtime(true);

// しばらくスリープ
usleep(100);

$time_end = microtime(true);
$time = $time_end - $time_start;

echo "Did nothing in $time seconds\n";
?>

例2 microtime と REQUEST_TIME_FLOAT の例

<?php
// ランダムな時間のスリープ
usleep(mt_rand(100, 10000));

// REQUEST_TIME_FLOAT をスーパーグローバル $_SERVER から取得できます。
// ここにはリクエスト開始時のタイムスタンプがマイクロ秒の精度で記録されています。
$time = microtime(true) - $_SERVER["REQUEST_TIME_FLOAT"];

echo "Did nothing in $time seconds\n";
?>

参考

time
hrtime