ctime、_ctime32、_ctime64、_wctime、_wctime32、_wctime64

[アーティクル]
02/21/2013

時間値を文字列に変換し、現地のタイムゾーンの設定に調整します。これらの関数のセキュリティを強化したバージョンについては、「ctime_s、_ctime32_s、_ctime64_s、_wctime_s、_wctime32_s、_wctime64_s」を参照してください。

char *ctime( 
   const time_t *timer 
);
char *_ctime32( 
   const __time32_t *timer )
;
char *_ctime64( 
   const __time64_t *timer )
;
wchar_t *_wctime( 
   const time_t *timer 
);
wchar_t *_wctime32( 
   const __time32_t *timer
);
wchar_t *_wctime64( 
   const __time64_t *timer 
);

パラメーター

timer
格納されている時刻へのポインター。

戻り値

結果の文字列へのポインター。NULL が返されます :

time が 1970 年 1 月 1 日の世界協定時刻 (UTC: Coordinated Universal Time) の深夜午前 0 時よりも前の日付を示している場合
使用して _ctime32 または _wctime32 と time は 03:14 後の日付を示している場合 : 1 年 1 月 07 日 19 時 2038。
使用して _ctime64 または _wctime64 と time は 23:59 後の日付を示している場合 : 593000 12 年 1 月 31 日のUTC。

ctime は _ctime64 になりtime_t が __time64_t と等価のインライン関数です。コンパイラに time_t 従来の 32 ビットとして time_t を解釈する必要がある場合 _USE_32BIT_TIME_T を定義できます。これを行うには ctime は _ctime32 になります。この方法はお勧めしません。2038 年 1 月 18 日以降にアプリケーションでエラーが発生する可能性があり、64 ビットプラットフォームでは使用できないためです。

解説

ctime の関数は文字列に格納される time_t の値と時刻値に変換します。timer の値は通常深夜 00:00 から経過した秒数を返す時間への呼び出しから派生します : 00) の 1970 年 1 月 1 日 1 の世界協定 (UTC) 時刻。戻り値は、26 文字からなる、次のような書式の文字列です。

Wed Jan 02 02:03:55 1980\n\0

時刻は 24 時間制です。すべてのフィールドは固定幅です。改行文字 (" \ n ") および null 文字 (「 \ 0 ") は文字列の最後の 2 か所に格納されます。

変換された文字列は、現地のタイムゾーンの設定に合わせて調整されます。タイムゾーンの環境変数とグローバル変数の定義方法の詳細については現地時刻と _tzset の関数の設定の詳細についてはtime_ftime と localtime の関数を参照してください。

ctime の呼び出しは gmtime と localtime の関数によって使用される単一の静的に割り当てられたバッファーを変更します。これらのルーチンを呼び出すたびに、前の呼び出しの結果は破棄されます。ctime は asctime の関数と静的バッファーを共有します。したがってctime の呼び出しは asctimelocaltimeまたは gmtime に前の呼び出しの結果を破棄します。

ワイド文字を扱う場合は、ctime および _ctime64 ではなく、_wctime および _wctime64 を使用します。この場合、ワイド文字列へのポインターを返します。それ以外の場合、_ctime64、_wctime、および _wctime64 の動作は ctime と同じです。

これらの関数では、パラメーターの検証が行われます。timer が null ポインターの場合またはタイマー値が負の場合これらの関数はパラメーターの検証に説明されているように無効なパラメーターハンドラーを呼び出します。実行の継続が許可された場合、関数は NULL を返し、errno を EINVAL に設定します。

汎用テキストルーチンのマップ

TCHAR.H のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_tctime	ctime	ctime	_wctime
_tctime32	_ctime32	_ctime32	_wctime32
_tctime64	_ctime64	_ctime64	_wctime64

必要条件

ルーチン	必須ヘッダー
ctime	<time.h>
_ctime32	<time.h>
_ctime64	<time.h>
_wctime	<time.h> または <wchar.h>
_wctime32	<time.h> または <wchar.h>
_wctime64	<time.h> または <wchar.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

// crt_ctime64.c
// compile with: /W3
/* This program gets the current
 * time in _time64_t form, then uses ctime to
 * display the time in string form.
 */

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

int main( void )
{
   __time64_t ltime;

   _time64( &ltime );
   printf( "The time is %s\n", _ctime64( &ltime ) ); // C4996
   // Note: _ctime64 is deprecated; consider using _ctime64_s
}

次の方法で共有

ctime、_ctime32、_ctime64、_wctime、_wctime32、_wctime64

パラメーター

戻り値

解説

必要条件

使用例

同等の .NET Framework 関数

参照

関連項目

その他のリソース