asctime, _wasctime

tm Zaman yapısını karakter dizesine dönüştürme. Bu işlevlerin daha güvenli sürümleri mevcuttur; bkz. asctime_s, _wasctime_s.

Sözdizimi

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

Parametreler

timeptr
Saat/tarih yapısı.

Dönüş değeri

asctime karakter dizesi sonucuna bir işaretçi döndürür; _wasctime geniş karakterli dize sonucuna bir işaretçi döndürür. Hata dönüş değeri yok.

Açıklamalar

Bu işlevlerin daha güvenli sürümleri mevcuttur; bkz. asctime_s, _wasctime_s.

işlevi, asctime yapı olarak depolanan zamanı bir karakter dizesine dönüştürür. Değer timeptr genellikle TIME.H içinde tanımlanan bir yapıya gmtimetm işaretçi döndüren veya localtimeçağrısından elde edilir.

timeptr Üye	Değer
tm_hour	Gece yarısından bu yana saatler (0-23)
tm_isdst	Gün ışığından yararlanma saati etkinse pozitif; Gün ışığından yararlanma saati etkin değilse 0; gün ışığından yararlanma saatinin durumu bilinmiyorsa negatif. C çalışma zamanı kitaplığı, Yaz Saati (DST) hesaplamasını uygulamak için Birleşik Devletler kurallarını varsayar.
tm_mday	Ayın günü (1-31)
tm_min	Saatten dakika (0-59)
tm_mon	Ay (0-11; Ocak = 0)
tm_sec	Dakika sonra saniye (0-59)
tm_wday	Haftanın günü (0-6; Pazar = 0)
tm_yday	Yılın günü (0-365; 1 Ocak = 0)
tm_year	Yıl (geçerli yıl eksi 1900)

Yerel saati yapılandırma hakkında bilgi için bkz time. , _ftimeve localtime işlevleri. Saat dilimi ortamını ve genel değişkenleri tanımlama hakkında bilgi için işleve _tzset bakın.

tarafından asctime üretilen dize sonucu tam olarak 26 karakter içerir ve biçimindedir Wed Jan 2 02:03:55 1980\n\0. 24 saat kullanılır. Tüm alanların genişliği sabit olur. Yeni satır karakteri ve null karakter, dizenin son iki konumunda yer alır. asctime dönüş dizesini tutmak için statik olarak ayrılmış tek bir arabellek kullanır. Bu işleve yapılan her çağrı, önceki çağrının sonucunu yok eder.

_wasctime , geniş karakterli bir sürümüdür asctimeve aksi takdirde ile asctimeaynı şekilde davranır.

Bu işlevler parametrelerini doğrular. Boş bir işaretçiyse timeptr veya aralık dışı değerler içeriyorsa, Parametre doğrulama bölümünde açıklandığı gibi geçersiz parametre işleyicisi çağrılır. Yürütmenin devam etmesi için izin verilirse, işlevi döndürür NULL ve olarak EINVALayarlanırerrno.

Varsayılan olarak, bu işlevin genel durumunun kapsamı uygulama olarak belirlenmiştir. Bu davranışı değiştirmek için bkz. CRT'de Genel durum.

Genel metin yordamı eşlemesi

TCHAR.H Rutin	_UNICODE ve _MBCS tanımlanmadı	_MBCS Tanımlanan	_UNICODE Tanımlanan
_tasctime	asctime	asctime	_wasctime

Gereksinimler

Yordam	Gerekli başlık
asctime	<time.h>
_wasctime	<time.h> veya <wchar.h>

Örnek

Bu program, sistem zamanını uzun tamsayıya aclockyerleştirir, yapısına newtimeçevirir ve ardından işlevini kullanarak çıkış için dize biçimine asctime dönüştürür.

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

Current date and time: Sun Feb  3 11:38:58 2002

Ayrıca bkz.

Zaman yönetimi
ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64
_ftime, _ftime32, _ftime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
time, _time32, _time64
_tzset
asctime_s, _wasctime_s