strtime-wstrtime.md

description	title	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords	ms.assetid
Learn more about: _strtime, _wstrtime	_strtime, _wstrtime	4/2/2020	_wstrtime _strtime _o__strtime _o__wstrtime	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-time-l1-1-0.dll	DLLExport	apiref	_wstrtime _strtime wstrtime strtime _tstrtime	strtime function _strtime function _wstrtime function copying time to buffers wstrtime function tstrtime function _tstrtime function time, copying	9e538161-cf49-44ec-bca5-c0ab0b9e4ca3

_strtime, _wstrtime

Copy the time to a buffer. 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

timestr
Time string.

Return value

Returns a pointer to the resulting character string timestr.

Remarks

The _strtime function copies the current local time into the buffer pointed to by timestr. The time is formatted as hh:mm:ss, where hh is two digits that represent the hour in 24-hour notation. mm is two digits for the minutes past the hour, and ss is two digits for seconds. For example, the string 18:23:44 represents 23 minutes and 44 seconds after 6 P.M. The buffer must be at least 9 bytes long.

_wstrtime is a wide-character version of _strtime; the argument and return value of _wstrtime are wide-character strings. These functions behave identically otherwise. If timestr is a NULL pointer or if timestr is formatted incorrectly, the invalid parameter handler is invoked, as described in Parameter validation. 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.

In C++, these functions have template overloads that invoke the newer, secure counterparts of these functions. For more information, see Secure template overloads.

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Generic-text routine mappings

TCHAR.H routine	_UNICODE and _MBCS not defined	_MBCS defined	_UNICODE defined
_tstrtime	_strtime	_strtime	_wstrtime

Requirements

Routine	Required header
_strtime	<time.h>
_wstrtime	<time.h> or <wchar.h>

For more 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, _wasctime
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
mktime, _mktime32, _mktime64
time, _time32, _time64
_tzset