C言語関数:mktime





C言語のページでは、次の内容を解説しております。
C言語の入門講座  C言語の文法を中心に、基本的な関数などの解説をしています。
C言語ケーススタディ  C言語での実践的なプログラミングについて解説をしています。
C言語の関数リファレンス  C言語で用意されている関数を解説しています。
C言語で3次元動画プログラム  C言語で3次元タートルグラフィックを使用した3次元の動画プログラムの作成例です。
C言語の検定試験  C言語の文法に関する検定試験を実施することができます。
C言語でゲーム作成  C言語を使用したゲームの作り方を解説したページも用意しております。



2014年10月より個人の方を対象に、Study C無料提供を開始しました。
C言語を勉強中の方は、学習・教育に最適なC言語インタープリタのStudy Cを使ってみてください(個人の方は無料です)。
大学・高専・高校などの教育機関での採用実績も多数あるロングセラー商品Study Cが、個人向けに無料提供を始めました。
インタープリタの手軽さに加え、ゲームや3Dタートルグラフィックで楽しく勉強したりと、C言語の学習を協力にサポートします。
ブロック崩しゲーム 3Dツリー クリスマスツリー
また、このようなボタンの用意されているページでは、掲載しているプログラムをStudy Cに直接ロードし実行したりすることができます。
Study Cにロードする Study Cにロードし編集する Study Cにロードし実行する
Study C無料利用についての詳細は、このページを参照してください。




■mktime
カレンダー時刻への変換

【分類】
時間関数

【書式】
long mktime(struct tm *tp);

【パラメータの型と説明】

パラメータ説明
struct tm *tp変換する日付/時刻

【機能説明】
tp(構造体tmへのポインタ)にセットしたローカル時間をカレンダー時刻に変換し、返り値として返します。
変換に失敗した場合は、-1を返します。

この関数は、localtime()関数の逆の働きをします。 まず、localtime()関数を参照してください。

localtime()関数の使用例です。

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

main()
{
        time_t mk;
        struct tm tm_mk;
        struct tm *tm_lt;

        tm_mk.tm_year = 2014 - 1900;
        tm_mk.tm_mon = 9 - 1;
        tm_mk.tm_mday = 28;
        tm_mk.tm_hour = 10;
        tm_mk.tm_min = 20;
        tm_mk.tm_sec = 30;
	mk = mktime(&tm_mk);
        printf("mktime:%d\n", mk);

        tm_lt = localtime(&mk);
        printf("日付 - %04d/%02d/%02d\n", tm_lt->tm_year + 1900, tm_lt->tm_mon + 1, tm_lt->tm_mday);
        printf("時刻 - %02d:%02d:%02d\n", tm_lt->tm_hour, tm_lt->tm_min, tm_lt->tm_sec);
}

実行結果は以下になります。

mktime:1411867230
日付 - 2014/09/28
時刻 - 10:20:30

1.構造体tmの変数「tm_mk」に2014/9/28 - 10:20:30に相当する値を代入していきます。
2.mktime()関数で変数「tm_mk」に代入した値をカレンダー時刻(1970年1月1日 00:00:00からグリニッジ標準時までの経過時間)を計算します。
3.printf()関数で計算したカレンダー時刻を表示します。
3.localtime()関数で計算したカレンダー時刻を地方標準時(この場合、日本時間)の利用しやすい形式に戻します。
3.printf()関数で「日付」を表示します。
4.printf()関数で「時刻」を表示します。

mktime()関数には、localtime()関数と同様に使うに当たっての注意点がいくつかあります。

・構造体「tm」の定義はインクルードファイル「time.h」内にあるので、必ずインクルードしておく必要があります。
・構造体「tm」は、localtime()とは異なり実態を宣言する必要があります。
・tm_yearにセットされる値(年)は、1900年からの経過年数なので1900を加える必要があります。
・tm_monにセットされる値(月)は、1月が0で12月が11になります。したがって1を加える必要があります。

【参照関数】
ctime
gmtime
localtime
time

【使用例】
C言語ケーススタディ 日時文字列からカレンダー時刻への変換
C言語ケーススタディ C言語に関係の深い2038年問題