トップページ　→関数リファレンス　→日付および時刻関連　→Date/Time　→日付・時刻関数

関数・クラス解説

microtime

version:PHP 4, PHP 5, PHP 7 (公式)

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

公式リファレンス

書式

microtime ([ bool $getAsFloat = FALSE ] ) : mixed

説明

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

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

パラメータ

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

返値

デフォルトでは、microtime() は "msec sec" 形式の文字列を返します。ただし、sec は Unix エポック (1970 年 1 月 1 日 0:00:00 GMT) からの経過秒数、msec は sec から経過したマイクロ秒数を秒単位で表したものです。 getAsFloat を TRUE に設定すると、microtime() は Unixエポックからの経過秒数をマイクロ秒で正確になるように float で表したものを返します。

サンプル

例1 microtime() でタイマスクリプト実行 

/**
 * PHP 5の動作を模擬する簡単な関数
 */
function microtime_float()
{
    list($usec, $sec) = explode(" ", microtime());
    return ((float)$usec + (float)$sec);
}

$time_start = microtime_float();

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

$time_end = microtime_float();
$time = $time_end - $time_start;

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

 例2 PHP 5 におけるタイマスクリプト実行 

$time_start = microtime(true);

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

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

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

 例3 microtime() と REQUEST_TIME_FLOAT の例 (PHP 5.4.0 以降) 

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

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

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