Sdílet prostřednictvím

_strtime, _wstrtime

  • Článek

Zkopírujte čas do vyrovnávací paměti. K dispozici jsou bezpečnější verze těchto funkcí; viz _strtime_s, _wstrtime_s.

Syntaxe

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
Časový řetězec.

Vrácená hodnota

Vrátí ukazatel na výsledný řetězec timestrznaku .

Poznámky

Funkce _strtime zkopíruje aktuální místní čas do vyrovnávací paměti, na kterou timestrodkazuje . Čas je formátován jako hh:mm:ss, kde hh jsou dvě číslice, které představují hodinu ve 24hodinovém zápisu. mm je dvě číslice pro minuty za hodinu a ss je dvě číslice pro sekundy. Například řetězec 18:23:44 představuje 23 minut a 44 sekund po 6:00. Vyrovnávací paměť musí mít délku nejméně 9 bajtů.

_wstrtime je verze širokého znaku _strtime; argument a návratová _wstrtime hodnota jsou řetězce širokých znaků. Tyto funkce se chovají stejně jinak. Pokud timestr je ukazatel nebo pokud timestr je NULL nesprávně naformátován, je vyvolána neplatná obslužná rutina parametru, jak je popsáno v ověření parametru. Pokud je výjimka povolena pokračovat, tyto funkce vrátí NULLhodnotu a nastaví errno , EINVAL zda timestr byla NULL nebo nastavena errno na ERANGE hodnotu, pokud timestr je nesprávně naformátována.

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í šablon zabezpečení.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Rutina TCHAR.H _UNICODE a _MBCS není definován _MBCS definovaný _UNICODE definovaný
_tstrtime _strtime _strtime _wstrtime

Požadavky

Rutina Požadovaný hlavičkový soubor
_strtime <time.h>
_wstrtime <time.h> nebo <wchar.h>

Další informace o kompatibilitě najdete v 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 );
}

The current time is 14:21:44

Viz také

Správa času
asctime, _wasctime
ctime, _ctime32, _ctime64, _wctime, , _wctime32_wctime64
gmtime, , _gmtime32_gmtime64
localtime, , _localtime32_localtime64
mktime, , _mktime32_mktime64
time, , _time32_time64
_tzset