ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Artykuł
03/26/2013

Konwertowanie wartości czasu na ciąg znaków oraz dostosować ustawienia strefy czasu lokalnego.Bezpieczniejsze wersje te funkcje są dostępne; see ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s.

char *ctime( 
   const time_t *timer 
);
char *_ctime32( 
   const __time32_t *timer )
;
char *_ctime64( 
   const __time64_t *timer )
;
wchar_t *_wctime( 
   const time_t *timer 
);
wchar_t *_wctime32( 
   const __time32_t *timer
);
wchar_t *_wctime64( 
   const __time64_t *timer 
);

Parametry

timer
Wskaźnik, aby czas przechowywane.

Wartość zwracana

Wskaźnik w wyniku ciąg znaków.NULLzostanie zwrócony, jeżeli:

timereprezentuje daty wcześniejszej od północy 1 stycznia 1970 roku UTC.
Jeśli korzystasz z _ctime32 lub _wctime32 i time reprezentuje datę po 03: 14: 07 19 stycznia 2038.
Jeśli korzystasz z _ctime64 lub _wctime64 i time reprezentuje datę po 23: 59: 59, 31 grudnia, 3000, UTC.

ctimefunkcji śródwierszowej, której wynikiem jest _ctime64 i time_t jest równoważne z __time64_t.Jeśli trzeba wymusić na kompilatorze interpretowania time_t jako stary 32-bitowe time_t, można zdefiniować _USE_32BIT_TIME_T.Spowoduje to zaawansowana ctime do oceny do _ctime32.Nie jest to zalecane, ponieważ aplikacja może zakończyć się niepowodzeniem po 18 stycznia 2038, i nie jest dozwolone na platformach 64-bitowych.

Uwagi

ctime Funkcja konwertuje wartość czas przechowywane jako time_t wartość na ciąg znaków.timer Wartość uzyskuje się zwykle z wywołania czasu, która oblicza liczbę sekund, jaka upłynęła od północy (00: 00), 1 stycznia 1970 roku skoordynowanego czasu uniwersalnego (UTC).Zwracana wartość ciąg zawiera dokładnie 26 znaków i ma postać:

Wed Jan 02 02:03:55 1980\n\0

24-Godzinnym jest używany.Wszystkie pola mają stałą szerokość.Znak nowego wiersza (\n) i znak null (\0) zajmują ostatnie dwie pozycje w ciągu.

Ciąg znaków przekonwertowanych również jest korygowana według czasu lokalnego ustawienia strefy.Zobacz time, _ftime, i strtotime funkcje informacji na temat konfigurowania czasu lokalnego oraz _tzset funkcji, aby uzyskać szczegółowe informacje o definiowaniu środowiska strefę czasową i zmienne globalne.

Wywołanie ctime modyfikuje pojedynczy statycznie przydzielonego buforu używane przez gmtime i localtime funkcji.Każde wywołanie do jednej z tych procedur niszczy wynik poprzednie wywołanie.ctimeudziały statyczne buforu z asctime funkcji.Tak więc wywołanie do ctime niszczy wyniki wszelkie poprzednie wywołanie asctime, localtime, lub gmtime.

_wctimei _wctime64 wersji szerokich znaków są ctime i _ctime64; zwracanie wskaźnik do łańcuch szerokich znaków.Otherwise, _ctime64, _wctime, and _wctime64 behave identically to ctime.

Te funkcje sprawdzania poprawności ich parametrów.Jeśli timer jest wskaźnik zerowy lub jeśli wartość czasomierza jest ujemna, te funkcje wywołania obsługi nieprawidłowy parametr, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie może kontynuować, funkcje zwracają wartość NULL i errno do EINVAL.

Tekst rodzajowy rutynowych mapowania

TCHAR.Rutynowe H	_UNICODE & Nie zdefiniowano _MBCS	_MBCS, definicja	_UNICODE, definicja
_tctime	ctime	ctime	_wctime
_tctime32	_ctime32	_ctime32	_wctime32
_tctime64	_ctime64	_ctime64	_wctime64

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
ctime	<time.h>
_ctime32	<time.h>
_ctime64	<time.h>
_wctime	<time.h> lub <wchar.h>
_wctime32	<time.h> lub <wchar.h>
_wctime64	<time.h> lub <wchar.h>

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

Przykład

// crt_ctime64.c
// compile with: /W3
/* This program gets the current
 * time in _time64_t form, then uses ctime to
 * display the time in string form.
 */

#include <time.h>
#include <stdio.h>

int main( void )
{
   __time64_t ltime;

   _time64( &ltime );
   printf( "The time is %s\n", _ctime64( &ltime ) ); // C4996
   // Note: _ctime64 is deprecated; consider using _ctime64_s
}