ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

Článek
03/26/2013

Časové hodnoty převést na řetězec a upravit nastavení zóny Místní čas.Bezpečnější verze tyto funkce jsou k dispozici; 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
Ukazatel času uložené.

Vrácená hodnota

Ukazatel na výsledek řetězec znaků.NULLbude vrácena, pokud:

timepředstavuje datum před ČASEM půlnoc 1. ledna 1970.
Používáte-li _ctime32 nebo _wctime32 a time představuje datum po 03: 14: 07 01.01.08 19.
Používáte-li _ctime64 nebo _wctime64 a time představuje datum po 23: 59: 59, do 31. prosince 3000 UTC.

ctimevložené funkce, jehož výsledkem je _ctime64 a time_t je ekvivalentní __time64_t.Chcete-li vynutit kompilátor interpretace time_t jako staré 32-bit time_t, můžete definovat _USE_32BIT_TIME_T.Tím dojde k ctime k vyhodnocení _ctime32.Nedoporučuje se, protože aplikace může selhat po 18 01.01.08, a není povoleno na 64bitových platformách.

Poznámky

ctime Funkce převede hodnotu času uloženy jako time_t hodnoty do řetězce znaků.timer Hodnota je obvykle získán z volání čas, která vrátí počet sekund uplynulých od půlnoci (00: 00), 1. ledna 1970, koordinovaný světový čas (UTC).Vrácená hodnota řetězce obsahuje přesně 26 znaků a má tvar:

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

Používá se 24 hodin.Všechna pole mají konstantní šířce.Znak nového řádku (\n) a znakem null (\0) zaujímají dvě poslední pozice řetězce.

Řetězec znaků převedeného také upravena podle nastavení zóny Místní čas.Najdete time, _ftime, a localtime funkce informace o konfiguraci místního času a _tzset funkce podrobné informace o definování časové pásmo prostředí a globální proměnné.

Volání ctime upravuje jedné staticky přidělené vyrovnávací paměti používané gmtime a localtime funkcí.Každé volání jedné tyto rutiny ničí výsledek předchozí volání.ctimestatické vyrovnávací paměti s podíly asctime funkce.Proto volání ctime ničí výsledky jakékoli předchozí volání k asctime, localtime, nebo gmtime.

_wctimea _wctime64 verzi celého znaků jsou ctime a _ctime64; ukazatel vrácení celého znakový řetězec.Otherwise, _ctime64, _wctime, and _wctime64 behave identically to ctime.

Tyto funkce ověřit jejich parametrů.Pokud timer je ukazatel s hodnotou null nebo pokud je záporná hodnota časovače, tyto funkce vyvolat popisovač neplatný parametr, jak je popsáno v Ověření parametrů.Pokud je povoleno spuštění pokračovat, vrátí funkce NULL a errno na EINVAL.

Obecný Text rutinní mapování

TCHAR.Rutina H	_UNICODE & _MBCS není definován	_MBCS, definice	_UNICODE, definice
_tctime	ctime	ctime	_wctime
_tctime32	_ctime32	_ctime32	_wctime32
_tctime64	_ctime64	_ctime64	_wctime64

Požadavky

Rutina	Požadované záhlaví
ctime	<time.h>
_ctime32	<time.h>
_ctime64	<time.h>
_wctime	<time.h> nebo <wchar.h>
_wctime32	<time.h> nebo <wchar.h>
_wctime64	<time.h> nebo <wchar.h>

Další informace o kompatibilitě, viz Compatibility v úvodu.

Příklad

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