_strtime、_wstrtime_strtime, _wstrtime

時刻をバッファーにコピーします。Copy the time to a buffer. これらの関数のセキュリティを強化したバージョンを使用できます。「_strtime_s、_wstrtime_s (_strtime_s、_wstrtime_s)」を参照してください。More secure versions of these functions are available; see _strtime_s, _wstrtime_s.

構文Syntax

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

パラメーターParameters

timestrtimestr
時刻の文字列。Time string.

戻り値Return Value

結果の文字列へのポインターを返しますします。Returns a pointer to the resulting character string timestr.

RemarksRemarks

_Strtime関数が指すバッファーに現在の現地時刻をコピーします。The _strtime function copies the current local time into the buffer pointed to by timestr. 時間として書式設定hh:mm:ss場所hh 24 時間表記で時間を表す 2 桁の数字は、 mm 、時間、分を表す2桁の数字は、ss秒を表す 2 桁の数字です。The time is formatted as hh:mm:ss where hh is two digits representing the hour in 24-hour notation, mm is two digits representing the minutes past the hour, and ss is two digits representing seconds. たとえば、文字列18時 23分: 44 23 分 44 秒午後 6 時を表しますFor example, the string 18:23:44 represents 23 minutes and 44 seconds past 6 P.M. バッファーは 9 バイト以上の長さである必要があります。The buffer must be at least 9 bytes long.

_wstrtimeのワイド文字バージョンは、 _strtime; の引数と戻り値 _wstrtimeはワイド文字列です。_wstrtime is a wide-character version of _strtime; the argument and return value of _wstrtime are wide-character strings. それ以外では、これらの関数の動作は同じです。These functions behave identically otherwise. 場合は、 NULLポインターまたは形式が正しくない、無効なパラメーター ハンドラーが呼び出されます」の説明に従ってパラメーター検証です。If timestr is a NULL pointer or if timestr is formatted incorrectly, the invalid parameter handler is invoked, as described in Parameter Validation. これらの関数を返すかどうか、例外が許可された、引き続き、 NULL設定とerrnoEINVAL場合が、 NULL設定またはerrnoERANGE場合形式が正しくありません。If the exception is allowed to continue, these functions return a NULL and set errno to EINVAL if timestr was a NULL or set errno to ERANGE if timestr is formatted incorrectly.

C++ では、これらの関数にテンプレートのオーバーロードがあります。このオーバーロードは、これらの関数に対応するセキュリティで保護された新しい関数を呼び出します。In C++, these functions have template overloads that invoke the newer, secure counterparts of these functions. 詳細については、「 Secure Template Overloads」を参照してください。For more information, see Secure Template Overloads.

汎用テキスト ルーチンのマップGeneric-Text Routine Mappings

TCHAR.H のルーチンTCHAR.H routine _UNICODE および _MBCS が未定義の場合_UNICODE & _MBCS not defined _MBCS が定義されている場合_MBCS defined _UNICODE が定義されている場合_UNICODE defined
_tstrtime_tstrtime _strtime_strtime _strtime_strtime _wstrtime_wstrtime

必要条件Requirements

ルーチンによって返される値Routine 必須ヘッダーRequired header
_strtime_strtime <time.h><time.h>
_wstrtime_wstrtime <time.h> または <wchar.h><time.h> or <wchar.h>

互換性の詳細については、「 互換性」を参照してください。For additional compatibility information, see Compatibility.

Example

// 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

関連項目See also

時間管理Time Management
asctime、_wasctimeasctime, _wasctime
ctime、_ctime32、_ctime64、_wctime、_wctime32、_wctime64ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
gmtime、_gmtime32、_gmtime64gmtime, _gmtime32, _gmtime64
localtime、_localtime32、_localtime64localtime, _localtime32, _localtime64
mktime、_mktime32、_mktime64mktime, _mktime32, _mktime64
time、_time32、_time64time, _time32, _time64
_tzset_tzset