_strtime, _wstrtime

時刻をバッファーにコピーします。 これらの関数のセキュリティを強化したバージョンを使用できます。「_strtime_s、_wstrtime_s」を参照してください。

構文

char *_strtime(
   char *timestr
);
wchar_t *_wstrtime(
   wchar_t *timestr
);
template <size_t size>
char *_strtime(
   char (&timestr)[size]
); // C++ only
template <size_t size>
wchar_t *_wstrtime(
   wchar_t (&timestr)[size]
); // C++ only

パラメーター

timestr
時刻の文字列。

戻り値

結果の文字列 timestr へのポインターを返します。

解説

この関数は _strtime 、現在のローカル時刻を指すバッファーにコピーします timestr。 時刻は、hh24 時間表記で時間を表す 2 桁の数字で書式設定hh:mm:ssされます。 mm は 1 時間を過ぎた分の場合は 2 桁で ss 、秒の場合は 2 桁です。 たとえば、文字列 18:23:44 は午後 6 時から 23 分 44 秒後を表します。バッファーの長さは 9 バイト以上である必要があります。

ワイド文字を扱う場合は、_wstrtime ではなく _strtime を使用します。_wstrtime の場合、引数にはワイド文字列を指定します。また戻り値もワイド文字列です。 それ以外では、これらの関数の動作は同じです。 ポインターのNULL場合timestr、または正しく書式設定されていない場合timestrは、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 例外の続行が許可されている場合、これらの関数は 、を返NULLしerrnoEINVAL、if が正NULLしく書式設定されていない場合timestrtimestrに設定errnoERANGEされます。

C++ では、これらの関数にテンプレートのオーバーロードがあります。このオーバーロードは、これらの関数に対応するセキュリティで保護された新しい関数を呼び出します。 詳細については、「セキュリティで保護されたテンプレート オーバーロード」を参照してください。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

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

TCHAR.H のルーチン	_UNICODE と _MBCS が定義されていない	_MBCS が定義されている	_UNICODE が定義されている
_tstrtime	_strtime	_strtime	_wstrtime

必要条件

ルーチンによって返される値	必須ヘッダー
_strtime	<time.h>
_wstrtime	<time.h> または <wchar.h>

互換性の詳細については、「 Compatibility」を参照してください。

例

// crt_strtime.c
// compile with: /W3

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

int main( void )
{
   char tbuffer [9];
   _strtime( tbuffer ); // C4996
   // Note: _strtime is deprecated; consider using _strtime_s instead
   printf( "The current time is %s \n", tbuffer );
}

The current time is 14:21:44

関連項目

時間管理
asctime, _wasctime
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
mktime, _mktime32, _mktime64
time, _time32, _time64
_tzset