localtime | Programming Place Plus C言語編 標準ライブラリのリファレンス

トップページC言語編標準ライブラリのリファレンス(名前順)

トップページC言語編標準ライブラリのリファレンス(ヘッダ別)


localtime関数

概要

カレンダー時間から、ローカル時間を得る。

ヘッダ

time.h

形式

struct tm* localtime(const time_t* t);

引数

t

カレンダー時間が格納された time_t型の値を指すポインタ。

戻り値

ローカル時間が格納された tm構造体を指すポインタが返される。失敗した場合は、ヌルポインタが返される。

詳細

注意

返されるポインタは、標準ライブラリ内のどこかにある静的記憶域期間を持った構造体変数を指している。この構造体変数の内容は、他の標準ライブラリ関数の呼び出しによって上書きされることがある。たとえば、次回の gmtime関数ctime関数の呼び出しで上書きされるかもしれない。そのため、あとで結果を使う場合は、コピーを取っておくべきである。

使用例

#include <stdio.h>
#include <time.h>

int main(void)
{
    time_t t = time(NULL);
    struct tm* lt = localtime(&t);

    puts(asctime(lt));
}

実行結果

Sun Apr 03 13:07:27 2011

関連

カレンダー時間から、協定世界時(UTC) を得るには gmtime関数を使う。

解説章

第51章


参考リンク


更新履歴

’2018/4/20 「NULL」という表記を「ヌルポインタ」に修正。

’2018/4/10 「注意」の文章を修正(内容的な変更はない)

’2018/1/22 新規作成。



標準ライブラリのリファレンス(名前順)のトップページへ

標準ライブラリのリファレンス(ヘッダ別)のトップページへ

C言語編のトップページへ

Programming Place Plus のトップページへ



はてなブックマーク に保存 Pocket に保存 Facebook でシェア
X で ポストフォロー LINE で送る noteで書く
rss1.0 取得ボタン RSS 管理者情報 プライバシーポリシー
先頭へ戻る