Sdílet prostřednictvím

ctime, _ctime32, _ctime64, _wctime, , _wctime32_wctime64

  • Článek

Převede časovou hodnotu na řetězec a upraví nastavení místního časového pásma. K dispozici jsou bezpečnější verze těchto funkcí; viz , , _ctime64_s_ctime32_s, _wctime_s, _wctime32_s, _wctime64_s.ctime_s

Syntaxe

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

Parametry

sourceTime
Ukazatel na uložený čas, který chcete převést.

Vrácená hodnota

Ukazatel na výsledek řetězce znaků. NULL vrátí, když:

  • sourceTime představuje datum před půlnocí, 1. ledna 1970, UTC.

  • Použijete _ctime32 nebo _wctime32a sourceTime představuje datum po 23:59:59 18, 2038, UTC.

  • Použijete _ctime64 nebo _wctime64představuje sourceTime datum po 23:59:59, 31. prosince 3000, UTC.

ctime je vložená funkce, která je vyhodnocena jako _ctime64, a time_t je ekvivalentní __time64_t. Pokud potřebujete vynutit, aby kompilátor interpretoval time_t jako starý 32bitový time_t, můžete definovat _USE_32BIT_TIME_T. Toto makro způsobí ctime , že se vyhodnotí jako _ctime32. Nedoporučujeme ho používat, protože vaše aplikace může po 18. lednu 2038 selhat a není povolená na 64bitových platformách.

Poznámky

Funkce ctime převede časovou hodnotu uloženou time_t jako hodnotu na řetězec znaků. Hodnota sourceTime se obvykle získá z volání time, který vrátí počet sekund uplynulých od půlnoci (00:00:00), 1. ledna 1970, koordinovaný univerzální čas (UTC). Vrácený řetězec hodnoty obsahuje přesně 26 znaků a má tvar:

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

Používá se 24hodinový formát. Všechna pole mají konstantní šířku. Znak nového řádku (\n) a znak null (\0) zabírají poslední dvě pozice řetězce.

Převedený řetězec znaků se také upraví podle nastavení místního časového pásma. Informace o konfiguraci místního času naleznete v tématu time, _ftimea localtime funkce. Podrobnosti o definování prostředí časového pásma a globálních proměnných najdete v _tzset této funkci.

Volání ctime pro úpravu jedné staticky přidělené vyrovnávací paměti používané funkcemi gmtime a localtime funkcemi. Každé volání jedné z těchto rutin zničí výsledek předchozího volání. ctime sdílí statickou vyrovnávací paměť s asctime funkcí. Proto volání zničit ctime výsledky jakéhokoli předchozího volání asctime, localtimenebo gmtime.

_wctime a _wctime64 jsou verzí širokého znaku ctime a _ctime64; vrací ukazatel na řetězec širokého znaku. Jinak , _ctime64, _wctimea _wctime64 chovat se stejně jako ctime.

Tyto funkce ověřují své parametry. Pokud sourceTime je ukazatel null nebo pokud sourceTime je hodnota záporná, tyto funkce vyvolat neplatnou obslužnou rutinu parametru, jak je popsáno v ověření parametru. Pokud je spuštění povoleno pokračovat, funkce se vrátí NULL a nastaví errno na EINVAL.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

Rutina TCHAR.H _UNICODE a _MBCS není definován _MBCS definovaný _UNICODE definovaný
_tctime ctime ctime _wctime
_tctime32 _ctime32 _ctime32 _wctime32
_tctime64 _ctime64 _ctime64 _wctime64

Požadavky

Rutina Požadovaný hlavičkový soubor
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ě najdete v tématu Kompatibilita.

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
}

The time is Wed Feb 13 16:04:43 2002

Viz také

Správa času
asctime, _wasctime
ctime_s, _ctime32_s, _ctime64_s, _wctime_s, , _wctime32_s_wctime64_s
_ftime, , _ftime32_ftime64
gmtime, , _gmtime32_gmtime64
localtime, , _localtime32_localtime64
time, , _time32_time64