_strtime, _wstrtime

Artykuł
03/26/2013

Kopia czas do bufora.Bezpieczniejsze wersje te funkcje są dostępne; see _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
Ciąg czasu.

Wartość zwracana

Zwraca wskaźnik do wynikowy ciąg znaków timestr.

Uwagi

_strtime Funkcja kopiuje bieżący czas lokalny do bufora wskazywanego przez timestr*.* Czas jest sformatowane jako hh:mm:ss gdzie hh jest dwie cyfry, reprezentującą godzinę w zapisie 24-godzinnym, mm jest dwóch cyfr reprezentujących minut po godzinie, i ss jest dwóch cyfr reprezentujących sekund.Na przykład ciąg 18:23:44 reprezentuje 23 minut i 44 sekund w przeszłości 6 P.M.Bufor musi być co najmniej 9 bajtów.

_wstrtimejest to wersja szerokich znaków _strtime; wartość argumentów i _wstrtime są ciągami szerokich znaków.Te funkcje działają identycznie inaczej.Jeśli timestr jest NULL wskaźnik lub jeśli timestr jest nieprawidłowo sformatowana nieprawidłowy parametr obsługi jest wywoływany, jak opisano w Sprawdzanie poprawności parametru.Jeśli wyjątek jest dozwolone, aby kontynuować, te funkcje powrót NULL i zestaw errno do EINVAL Jeśli timestr została wartość NULL lub ustawić errno do ERANGE Jeśli timestr jest niepoprawnie sformatowana.

W języku C++ funkcje te mają overloads szablonu, które wywołują nowsze, bezpieczne odpowiednikami tych funkcji.Aby uzyskać więcej informacji, zobacz Secure, szablon Overloads.

Tekst rodzajowy rutynowych mapowania

TCHAR.Rutynowe H	_UNICODE & Nie zdefiniowano _MBCS	_MBCS, definicja	_UNICODE, definicja
_tstrtime	_strtime	_strtime	_wstrtime

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
_strtime	<time.h>
_wstrtime	<time.h> lub <wchar.h>

Aby uzyskać dodatkowe informacje o zgodności, zobacz zgodności we wprowadzeniu.

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