asctime, _wasctime

Artykuł
03/26/2013

Konwertuj tm czasu strukturę, aby ciąg znaków.Bezpieczniejsze wersje te funkcje są dostępne; see asctime_s, _wasctime_s.

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

Parametry

timeptr
Data/Godzina struktury.

Wartość zwracana

asctimeZwraca wskaźnik w wyniku ciąg znaków; _wasctimeZwraca wskaźnik do wyniku łańcuch szerokich znaków.Istnieje nie zwraca wartości błędu.

Uwagi

Bezpieczniejsze wersje te funkcje są dostępne; zobacz asctime_s, _wasctime_s.

asctime Funkcja konwertuje czas przechowywane w postaci struktury do ciągu znaków.timeptr Wartość uzyskuje się zwykle z wywołania gmtime lub localtime, których obie zwracają wskaźnik do tm struktury zdefiniowane w czasie.H.

timeptr Członkowskich	Wartość
tm_hour	Godziny od północy (godziny)
tm_isdst	Dodatnie, jeśli zmiany czasu letniego obowiązujące; 0, jeśli zmiany czasu letniego, nie jest skuteczne; ujemne, jeśli stan czasu letniego jest nieznany.Biblioteka uruchomieniowa c przyjmuje zasady wykonywania obliczeń czasu letniego (DST) Stanów Zjednoczonych.
tm_mday	Dzień miesiąca (1-31)
tm_min	Minut po godzinie (00-59)
tm_mon	Miesiąc (0–11; Stycznia = 0)
tm_sec	Sekund po minuty (00-59)
tm_wday	Dzień tygodnia (0; Niedziela = 0)
tm_yday	Dzień roku (0–365; 1 Stycznia = 0)
tm_year	Rok (bieżącego roku minus 1900)

Ciąg znaków przekonwertowanych również jest korygowana według czasu lokalnego ustawienia strefy.Aby uzyskać informacje dotyczące konfigurowania czasu lokalnego, zobacz czasu, _ftime, i strtotime funkcje i _tzset funkcji, aby uzyskać informacje o definiowaniu środowiska strefę czasową i zmienne globalne.

String result produkowane przez asctime 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 i znak null zajmują ostatnie dwie pozycje w ciągu.asctimeużywa pojedynczej, statycznie przydzielonego buforu do przechowywania zwracanego ciągu.Każde wywołanie tej funkcji niszczy wynik poprzednie wywołanie.

_wasctimejest to wersja szerokich znaków asctime._wasctimei asctime zachowują się identycznie inaczej.

Te funkcje sprawdzania poprawności ich parametrów.Jeśli timeptr jest wskaźnik zerowy lub jeśli zawiera wartości spoza zakresu, nieprawidłowy parametr wywoływana jest funkcja obsługi, zgodnie z opisem w Sprawdzanie poprawności parametru.Jeśli wykonanie mogą w dalszym ciągu, funkcja zwraca NULL i ustawia errno do EINVAL.

Tekst rodzajowy rutynowych mapowania

TCHAR.Rutynowe H	_UNICODE & Nie zdefiniowano _MBCS	_MBCS, definicja	_UNICODE, definicja
_tasctime	asctime	asctime	_wasctime

Wymagania

Rozpoczęto wykonywanie procedury	Wymaganego nagłówka
asctime	<time.h>
_wasctime	<time.h> lub <wchar.h>

Przykład

Ten program umieszcza czas systemowy w long integer aclock, przekłada struktury newtime i konwertuje ją do postaci ciągu dla wyjściowych, przy użyciu asctime funkcji.

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