Udostępnij za pośrednictwem

_strtime, _wstrtime

  • Artykuł

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 errno ERANGE na wartość lub , jeśli timestr jest niepoprawnie sformatowany.EINVAL NULLerrno

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 zdefiniowany _UNICODE zdefiniowany
_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