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

正規化されている日時の情報を格納した tm構造体へのポインタ。ヌルポインタであってはならない。

tm構造体の内容に応じて、それを文字列に整形する。フォーマットは、“Wed Apr 04 16:18:50 2018\n” のような形になり、文字数はつねに一定である。終端文字の手前には改行文字がある。

asctime関数の安全性を高めた関数である。asctime関数と違い、結果を静的なオブジェクトに生成してそのポインタを返すのではなく、呼び出し元が用意したバッファに受け取るかたちになっているため、ほかの関数との競合でデータが破損することがなくなっている。また、バッファの大きさを引数maxsize でチェックする。実行時に検出できる問題があれば実行時制約違反となる。

実行時制約違反があったとき、引数s がヌルポインタでなく、引数maxsize が 0 でなく RSIZE_MAX より大きくない場合には、s[0] にヌル文字がセットされる。

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <time.h>

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

    char buf[26];
    asctime_s(buf, sizeof(buf), utc);
    printf("%s", buf);
}

実行結果：

Sat Dec  7 07:42:19 2024

asctime関数はこの関数の元になった古い関数であるが、C23 からは非推奨となっている。