C++のlocaltime()関数とは？使い方と実行例をわかりやすく解説

この記事では、C++ STLにおけるlocaltime()関数の動作、構文、および具体的な使用例について詳しく解説します。

localtime()とは？

localtime()関数は、C++ STLに標準で組み込まれている関数の一つで、<ctime>ヘッダーファイル内で定義されています。この関数は、time_t型で表された時刻の値を、地域ごとのローカル時刻（現地時間）に変換するために使用されます。

具体的には、引数timerが参照する値をもとにtm構造体の各メンバーに値を設定し、その結果をシステムに設定されているローカルタイムゾーンに対応した時刻として取得します。

構文

localtime(time_t *timer);

パラメータ

この関数は、次のパラメータを受け取ります。

• timer − time_t型の時刻の値を保持するオブジェクトへのポインタです。

戻り値

ローカルタイムゾーンに変換された時刻情報を格納したtm構造体へのポインタを返します。変換に失敗した場合はnullptrが返されます。

tm構造体の主なメンバー

使用例

#include <bits/stdc++.h>
using namespace std;
int main(){
    time_t hold;
    hold = time(NULL);
    tm* hold_local = localtime(&hold);
    cout<<"現在のシステムのローカル時刻: "<< hold_local->tm_hour << ":"<<hold_local->tm_min << ":"<<hold_local->tm_sec;
    return 0;
}

出力

現在のシステムのローカル時刻: 8:28:57

注意点

localtime()は、内部で静的なバッファを共有して結果を返すため、マルチスレッド環境ではスレッドセーフではありません。マルチスレッドプログラムでは、POSIX規格のlocaltime_r()などの使用が推奨されます。また、tm構造体の月（tm_mon）は0から始まるため、実際の月を表示する際には1を加算する必要がある点にも注意しましょう。