_strtime, _wstrtime

Artykuł
06/09/2015

Czas kopiowania do buforu.Bardziej bezpieczne wersje tych funkcji są dostępne w _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*.* Godzina jest formatowana jako hh:mm:ss gdzie hh to dwie cyfry, reprezentującą godzinę w zapisie 24-godzinnym, mm to dwie cyfry, reprezentujących minut po pełnej godzinie, i ss to dwie cyfry, reprezentującą sekundy.Na przykład ciąg 18:23:44 reprezentuje 23 minuty i 44 sekundy ostatnich 6 P.M. Bufor musi być co najmniej 9 bajtów.

_wstrtimejest to wersja szeroko charakter _strtime; wartość argumentów i _wstrtime są ciągi znaków wide.Funkcje te zachowują się identycznie inaczej.Jeśli timestr jest NULL wskaźnik lub jeśli timestr jest sformatowany niepoprawnie, nieprawidłowy parametr obsługi jest wywoływany, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wyjątek będzie mógł kontynuować, te funkcje powrotu wartość NULL i set errno do EINVAL Jeśli timestr została wartość NULL lub ustaw errno do ERANGE Jeśli timestr jest niepoprawnie sformatowany.

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

Rutynowe mapowania zwykłego tekstu

Procedura Tchar.h	_UNICODE & _MBCS nie zdefiniowano	_MBCS zdefiniowano	_UNICODE zdefiniowany
_tstrtime	_strtime	_strtime	_wstrtime

Wymagania

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

Dodatkowe informacje o zgodności – zobacz: Zgodność 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 );
}