C言語/標準ライブラリ/time.h

このページ「C言語/標準ライブラリ/time.h」は、まだ書きかけです。加筆・訂正など、協力いただける皆様の編集を心からお待ちしております。また、ご意見などがありましたら、お気軽にトークページへどうぞ。

ヘッダー <time.h> では、いくつかのマクロが定義されており、時間を操作するための型や関数が宣言されています。

多くの関数は、（グレゴリオ暦に基づく）現在の日付と時刻を表すカレンダータイムを扱います。いくつかの関数は、特定のタイムゾーンで表現されるカレンダータイムであるローカルタイムや、ローカルタイムを決定するアルゴリズムの一時的な変更である夏時間を扱います。ローカルタイムゾーンと夏時間は実装で定義されます。

C2xでは、機能テストマクロ __STDC_VERSION_TIME_H__ は、 yyyymmL というトークンに展開されます。その他のマクロはNULLが定義されています（§7.19 Common definitions <stddef.h>に記載）。

ヘッダー <time.h> で定義されているマクロと型と、宣言されている関数。

マクロ

NULL

CLOCKS_PER_SEC

TIME_UTC

型

size_t

clock_t

time_t

struct timespec

struct tm

関数

必須

clock_t clock(void);
double difftime(time_t time1, time_t time0);
time_t mktime(struct tm *timeptr);
time_t time(time_t *timer);
int timespec_get(struct timespec *ts, int base); // struct が抜けている
char *asctime(const struct tm *timeptr);
char *ctime(const time_t *timer);
struct tm *gmtime(const time_t *timer);
struct tm *localtime(const time_t *timer);
size_t strftime(char * restrict s, size_t maxsize, const char * restrict format, const struct tm * restrict timeptr);

境界チェックインターフェース

処理系が __STDC_LIB_EXT1__ を定義し、ユーザが __STDC_WANT_LIB_EXT1__ を 1 に停止した場合、以下の境界チェックインターフェースが有効になります。

マクロ

__STDC_LIB_EXT1__

__STDC_WANT_LIB_EXT1__

型

errno_t

rsize_t

関数

境界チェックインターフェース

errno_t asctime_s(char *s, rsize_t maxsize, const struct tm *timeptr);
errno_t ctime_s(char *s, rsize_t maxsize, const time_t *timer);
struct tm *gmtime_s(const time_t * restrict timer, struct tm * restrict result);
struct tm *localtime_s(const time_t * restrict timer, struct tm * restrict result);

Unixの拡張機能

POSIX（IEEE Std 1003.1）では、time.hに2つの関数を追加しています。asctime_rとctime_rです。 これらはasctimeとctimeのリエントラント版( reentrant version )です。どちらの関数も、呼び出し側が、ある瞬間のテキスト表現を格納するバッファを提供することを必要とします。 以下のサンプルでは、リエントラント版のlocaltimeとasctimeの使用方法を示しています。

#define _POSIX_C_SOURCE 200112L
#include <stdio.h>
#include <stdlib.h>
#include <time.h>

int main(void) {
  time_t rawtime;
  struct tm *timeinfo;
  struct tm timeinfoBuffer;
  char *result;

  time(&rawtime);
  /* call localtime */
  timeinfo = localtime_r(&rawtime, &timeinfoBuffer);
  /* allocate memory for the result of asctime call*/
  result = malloc(26 * sizeof(char));
  /* call reentrant asctime function */
  result = asctime_r(timeinfo, result);
  printf("The current date/time is: %s", result);
  /* free allocated memory */
  free(result);

  return 0;
}

これらの関数はC++の標準にはないので、C++の名前空間stdには属していません。

参考文献

• 国際標準化機構/国際電気標準会議 ISO/IEC 9899:2018(en) Information technology — Programming languages — C(2018-07-05)