_strtime, _wstrtime

Skopiuj czas do buforu. Dostępne są bezpieczniejsze wersje tych funkcji; zobacz _strtime_s, _wstrtime_s.

Składnia

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
Ciąg czasu.

Wartość zwracana

Zwraca wskaźnik do wynikowego ciągu timestrznaku .

Uwagi

Funkcja _strtime kopiuje bieżący czas lokalny do buforu wskazywane przez timestr. Czas jest sformatowany jako hh:mm:ss, gdzie hh to dwie cyfry reprezentujące godzinę w notacji 24-godzinnej. mm jest dwiema cyframi w minutach ostatnich godziny i ss jest dwiema cyframi w sekundach. Na przykład ciąg 18:23:44 reprezentuje 23 minuty i 44 sekundy po godzinie 18:00. Bufor musi mieć długość co najmniej 9 bajtów.

_wstrtime jest wersją szerokoznakową ; _strtimeargument i wartość zwracana _wstrtime są ciągami o szerokim znaku. Te funkcje zachowują się identycznie inaczej. Jeśli timestr jest wskaźnikiem NULL lub jeśli timestr jest niepoprawnie sformatowany, wywoływana jest nieprawidłowa procedura obsługi parametrów, zgodnie z opisem w temacie Weryfikacja parametrów. Jeśli wyjątek może być kontynuowany, te funkcje zwracają wartość i ustawioną na wartość , jeśli timestr element był NULL ustawiony errnoERANGE na wartość lub , jeśli timestr jest niepoprawnie sformatowany.EINVALNULLerrno

W języku C++te funkcje mają przeciążenia szablonu, które wywołują nowsze, bezpieczne odpowiedniki tych funkcji. Aby uzyskać więcej informacji, zobacz Bezpieczne przeciążenia szablonów.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

Procedura TCHAR.H	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_tstrtime	_strtime	_strtime	_wstrtime

Wymagania

Procedura	Wymagany nagłówek
_strtime	<time.h>
_wstrtime	<time.h> lub <wchar.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

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

Zobacz też

Zarządzanie czasem
asctime, _wasctime
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
mktime, _mktime32, _mktime64
time, _time32, _time64
_tzset