ctime64() — 時間から文字ストリングへの変換

オンライン編集

形式

#include <time.h>
char *ctime64(const time64_t *time);

言語レベル

ILE C Extension

スレッド・セーフ

いいえ

代わりに ctime64_r() を使用します。

ロケール依存

この関数の振る舞いは、現行ロケールの LC_TOD カテゴリーの影響を受ける可能性があります。 詳しくは、 CCSID とロケールについてを参照してください。

説明

ctime64() 関数は、 time が指す時間の値を文字ストリング形式の現地時間に変換します。 時間の値は通常、time64() 関数を呼び出して取得します。

ctime64() 関数が作成するストリングの結果にはちょうど 26 文字が含まれ、以下の形式となっています。
   "%.3s %.3s%3d %.2d:%.2d:%.2d %d\n"
次に例を示します。
   Mon Jul 16 02:03:55 1987\n\0

ctime64() 関数は 24 時間クロック形式を使用します。 使用される月と日の省略形は、ロケールから取り出します。 すべてのフィールドには定数幅があります。 1 桁しかない日付は、ゼロがその前に置かれます。 改行文字 (\n) および NULL 文字 (\0) がストリングの最後の位置を占めます。

戻り値

ctime64() 関数は文字ストリングの結果を指すポインターを戻します。 関数が正常に実行されなかった場合、NULL を戻します。 ctime64() 関数の呼び出しは、以下と同等です。
   asctime(localtime64(&anytime))
注: asctime() 関数と ctime64() 関数、およびその他の時間関数は、静的に割り振られた共通のバッファーを使用して、戻りストリングを保持することができます。 これらの関数の 1 つを呼び出すごとに、以前の呼び出しの結果が破棄される可能性があります。 asctime_r()、 ctime64_r()、 gmtime64_r()、および localtime64_r() 関数は、戻りストリングを保持するために静的に割り振られた共通のバッファーを使用しません。 再入可能性が必要な場合は、 asctime()、 ctime64()、 gmtime64()、および localtime64()の代わりにこれらの関数を使用できます。

例

次の例では、time64() を使用してシステム・クロックをポーリングします。 ポーリングの次に、現在の日時を示すメッセージを出力します。
#include <time.h>
#include <stdio.h>
 
int main(void)
{
   time64_t ltime;

   time64(&ltime); 

   printf("the time is %s", ctime64(&ltime));
}

関連情報