_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が指すバッファーにコピーします。 時刻は hh:mm:ssとして書式設定されます。ここで、 hh は 24 時間表記で時間を表す 2 桁の数字です。 mm は 1 時間を過ぎた分の場合は 2 桁で、 ss は秒の場合は 2 桁です。 たとえば、文字列 18:23:44 は、午後 6 時から 23 分 44 秒後を表します。バッファーの長さは 9 バイト以上である必要があります。

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

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

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

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

要件

互換性の詳細については、「 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