asctime _wasctime

Článek
03/26/2013

Převést tm čas struktury řetězec znaků.Bezpečnější verze tyto funkce jsou k dispozici; see asctime_s _wasctime_s.

char *asctime( 
   const struct tm *timeptr 
);
wchar_t *_wasctime( 
   const struct tm *timeptr 
);

Parametry

timeptr
Čas a datum struktury.

Vrácená hodnota

asctimeVrací ukazatel na výsledek řetězec znaků; _wasctimeVrací ukazatel na řetězec znaků celý výsledek.Chyba vrácená hodnota neexistuje.

Poznámky

Bezpečnější verze tyto funkce jsou k dispozici; Viz asctime_s, _wasctime_s.

asctime Funkce převede čas uloženy jako struktura na řetězec znaků.timeptr Hodnota je obvykle získán z volání gmtime nebo localtime, které obě vrací ukazatel na tm struktury, které jsou definovány v čase.H.

člen timeptr	Value
tm_hour	Hodin od půlnoci (0–23)
tm_isdst	Pozitivní, jestliže letní čas je v platnosti; 0, pokud není letního času v účinku; negativní, jestliže stav letního času neznámý.C Runtime library předpokládá Spojené státy prováděcí pravidla k výpočtu letní čas (DST).
tm_mday	Den v měsíci (1–31)
tm_min	Minut po hodině (0–59)
tm_mon	Měsíc (0–11; Ledna = 0)
tm_sec	Sekund po minutě (0–59)
tm_wday	Den v týdnu týdnu (0–6; Neděle = 0)
tm_yday	Den roku (0–365; Ledna = 0)
tm_year	Rok (aktuální rok minus 1900)

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

Výsledek řetězce vyrobené asctime 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.Poslední dvě pozice řetězec obsadit, se znakem a znakem null.asctimejediné, staticky přidělené vyrovnávací paměti se používá k ukládání vráceného řetězce.Každé volání této funkce ničí výsledek předchozí volání.

_wasctimeje verze celého znaku asctime._wasctimea asctime chovají jinak shodně.

Tyto funkce ověřit jejich parametrů.Pokud timeptr je ukazatel hodnotu null nebo pokud obsahuje hodnoty mimo rozsah, je vyvolána neplatný parametr popisovače, popsaným 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
_tasctime	asctime	asctime	_wasctime

Požadavky

Rutina	Požadované záhlaví
asctime	<time.h>
_wasctime	<time.h> nebo <wchar.h>

Příklad

Tento program umístí systémový čas dlouhé celé číslo aclock, převede jej do struktury newtime a převádí je řetězec formulář pro výstup, použití asctime funkce.

// crt_asctime.c
// compile with: /W3

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

int main( void )
{
    struct tm   *newTime;
    time_t      szClock;

    // Get time in seconds
    time( &szClock );

    // Convert time to struct tm form 
    newTime = localtime( &szClock );

    // Print local time as a string.
    printf_s( "Current date and time: %s", asctime( newTime ) ); // C4996
    // Note: asctime is deprecated; consider using asctime_s instead
}