_strtime, _wstrtime

Článek
06/09/2015

Čas zkopírujte do vyrovnávací paměti.Bezpečnější verze těchto funkcí jsou k dispozici; viz _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

Parametry

timestr
Řetězec na čas.

Vrácená hodnota

Vrací ukazatel na výsledný řetězec znaků timestr.

Poznámky

_strtime Funkce zkopíruje do vyrovnávací paměti, na kterou odkazuje aktuální místní čas timestr*.* Čas je formátováno jako hh:mm:ss kde hh je dvě číslice představuje hodiny v 24hodinovém formátu, mm je dvě číslice představující minut po celé hodině, a ss je dvě číslice představující sekund.Například řetězec 18:23:44 představuje 23 minut a 44 sekund posledních 6 hodin Vyrovnávací paměti musí být nejméně 9 bajtů.

_wstrtimeje verze širokého znaku _strtime; hodnota argumentu a návrat _wstrtime jsou řetězci širokého znaku.Tyto funkce se chovají stejně jinak.Pokud timestr je NULL ukazatel nebo -li timestr je v nesprávném formátu, neplatné vyvolat parametr obslužné rutiny, jak je popsáno v Ověření parametru.Pokud výjimka je umožněno pokračovat, tyto funkce vrátit NULL a sada errno k EINVAL Pokud timestr byl NULL nebo nastavit errno k ERANGE -li timestr je v nesprávném formátu.

V jazyce C++ mají tyto funkce přetížení šablon, která vyvolávají novější, zabezpečené protějšky těchto funkcí.Další informace naleznete v tématu Přetížení zabezpečení šablony.

Rutinní mapování obecného textu

Rutina TCHAR.H	_UNICODE & _MBCS není definováno	_MBCS definováno	_UNICODE definováno
_tstrtime	_strtime	_strtime	_wstrtime

Požadavky

Rutina	Požadované záhlaví
_strtime	<time.h>
_wstrtime	<Time.h> nebo <wchar.h>

Další informace o kompatibilitě naleznete v úvodu tématu Kompatibilita.

Příklad

// 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 );
}