【PHP8.x】gettimeofday()関数の使い方

Copy
1<?php
2
3/**
4 * 現在の時刻を高精度で取得し、その情報を表示する関数。
5 *
6 * gettimeofday() は、Unix エポックからの経過秒数とマイクロ秒を配列で返します。
7 * システムエンジニアを目指す初心者向けに、各要素の意味をコメントで説明します。
8 */
9function displayHighPrecisionTime(): void
10{
11    // gettimeofday() を引数なしで呼び出すと、現在の時刻情報を含む連想配列が返されます。
12    // この配列には、秒 ('sec') とマイクロ秒 ('usec') の情報が含まれます。
13    $timeInfo = gettimeofday();
14
15    echo "--- gettimeofday() の実行結果 ---" . PHP_EOL;
16    echo "返されたデータの型: " . gettype($timeInfo) . PHP_EOL; // 返されたデータの型を確認 (通常は array)
17    print_r($timeInfo); // 配列の内容を分かりやすく表示
18
19    // 配列の 'sec' キーは、Unix エポック (1970年1月1日 00:00:00 UTC) からの経過秒数です。
20    echo "経過秒数 (sec): " . $timeInfo['sec'] . PHP_EOL;
21
22    // 配列の 'usec' キーは、現在の秒内でのマイクロ秒数 (1秒 = 1,000,000マイクロ秒) です。
23    echo "マイクロ秒 (usec): " . $timeInfo['usec'] . PHP_EOL;
24
25    // 高精度な現在の時刻を浮動小数点数として取得する方法。
26    // 秒とマイクロ秒を合わせて、Unixエポックからの総秒数を小数で表現します。
27    // これは、PHPの microtime(true) 関数が返す形式と類似しており、
28    // 時間差の計算などでよく利用されます。
29    $totalSecondsPrecise = $timeInfo['sec'] + ($timeInfo['usec'] / 1_000_000);
30    echo "高精度な総秒数 (float): " . $totalSecondsPrecise . PHP_EOL;
31
32    echo PHP_EOL;
33    echo "gettimeofday() は、プログラムの実行時間計測など、高精度な時刻が必要な場合によく利用されます。" . PHP_EOL;
34}
35
36// 関数を実行して結果を表示します。
37displayHighPrecisionTime();
38
39?>

gettimeofday 関数は、現在の時刻を高精度で取得するために使用されます。この関数を引数なしで呼び出すと、現在の時刻情報を含む連想配列が戻り値として返されます。返される配列には、主に二つのキーが含まれます。「sec」は1970年1月1日00:00:00 UTC（Unixエポック）からの経過秒数を、「usec」は現在の秒内でのマイクロ秒数（1秒の100万分の1）を示します。

サンプルコードでは、まずgettimeofday()の戻り値である連想配列の内容を表示し、その後に「sec」と「usec」の値を個別に表示しています。さらに、これらの情報を使って、Unixエポックからの総秒数を浮動小数点数として計算する方法も示しています。これは、secにusecを100万で割った値を加えることで実現され、PHPのmicrotime(true)関数が返す形式に似ています。

gettimeofday関数は、プログラムの実行時間計測や、より正確な時刻情報が必要なシステム開発において役立つ機能です。

Copy
1<?php
2
3/**
4 * 現在の時刻を高精度なUNIXタイムスタンプとして取得します。
5 *
6 * gettimeofday() 関数は、現在の時刻に関する情報を配列で返します。
7 * この関数は、その配列に含まれる秒数とマイクロ秒の情報を組み合わせて、
8 * マイクロ秒まで含む浮動小数点数形式のUNIXタイムスタンプを生成します。
9 *
10 * システムエンジニアを目指す初心者の方へ:
11 * UNIXタイムスタンプは、1970年1月1日 00:00:00 UTC（協定世界時）からの経過秒数を表す数値です。
12 * 通常のタイムスタンプは秒単位ですが、gettimeofday() を利用することで、
13 * さらに細かいマイクロ秒（1秒の100万分の1）単位での時刻情報を取得できます。
14 * これは、処理時間の計測やイベントの正確な順序付けが必要な場合に役立ちます。
15 *
16 * @return float マイクロ秒精度まで含む現在のUNIXタイムスタンプ（例: 1678886400.123456）
17 */
18function getMicrosecondTimestamp(): float
19{
20    // gettimeofday() を引数なしで呼び出すと、以下のキーを持つ連想配列が返されます。
21    // 'sec': UNIXエポックからの秒数 (整数)
22    // 'usec': 現在の秒内のマイクロ秒 (整数)
23    // 'minuteswest': グリニッジ子午線からの分単位の西方向のオフセット
24    // 'dsttime': 夏時間補正のタイプ
25    $timeOfDayInfo = gettimeofday();
26
27    // 'sec' (秒数) と 'usec' (マイクロ秒) を組み合わせて、
28    // マイクロ秒精度まで含む浮動小数点数形式のタイムスタンプを生成します。
29    // マイクロ秒を1,000,000で割ることで、秒単位に変換し、秒数に加算します。
30    $microsecondTimestamp = $timeOfDayInfo['sec'] + $timeOfDayInfo['usec'] / 1_000_000;
31
32    return $microsecondTimestamp;
33}
34
35// 関数を実行し、現在のマイクロ秒精度UNIXタイムスタンプを取得して表示します。
36$currentMicroTimestamp = getMicrosecondTimestamp();
37echo "現在のマイクロ秒精度UNIXタイムスタンプ: " . $currentMicroTimestamp . PHP_EOL;
38
39// 注: このタイムスタンプは非常に正確な時刻情報を提供しますが、
40// 人間が読みやすい形式に変換するには、DateTimeオブジェクトなどの追加処理が必要になる場合があります。
41// 例: echo date('Y-m-d H:i:s.u', $currentMicroTimestamp); は直接動作しないため、
42// DateTime::createFromFormat('U.u', sprintf('%.6F', $currentMicroTimestamp))->format('Y-m-d H:i:s.u') のような変換が必要です。
43
44?>

このPHPのサンプルコードは、現在の時刻をマイクロ秒単位まで含んだUNIXタイムスタンプとして取得する方法を示しています。gettimeofday関数は、引数なしで呼び出すことで、現在の時刻に関する情報を配列で返します。この戻り値の配列には、1970年1月1日 00:00:00 UTCからの経過秒数を表すsecキーと、現在の秒内におけるマイクロ秒数を表すusecキーが含まれています。

UNIXタイムスタンプは、前述の基準時からの経過秒数を表す数値ですが、通常のタイムスタンプは秒単位です。gettimeofday関数を利用することで、さらに細かいマイクロ秒（1秒の100万分の1）単位での時刻情報を取得できます。

サンプルコードでは、getMicrosecondTimestampという独自の関数を定義し、その中でgettimeofday()を呼び出しています。そして、取得した配列のsec（秒数）とusec（マイクロ秒）を組み合わせて、マイクロ秒を1,000,000で割って秒に変換し、それをsecに加算することで、浮動小数点数形式のマイクロ秒精度UNIXタイムスタンプを生成しています。

したがって、このgetMicrosecondTimestamp関数は引数を必要とせず、現在の時刻をマイクロ秒精度で表す浮動小数点数（float）として返します。この高精度なタイムスタンプは、プログラムの処理時間の詳細な計測や、イベントの厳密な順序付けが必要な場面で非常に役立ちます。