asctime, _wasctime

Makale
03/26/2013

Dönüştürme bir tm zaman yapısına bir karakter dizesi.Bu işlevler daha güvenli sürümlerinin kullanılabilir olduğunu; see asctime_s, _wasctime_s.

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

Parametreler

timeptr
Saat/tarih yapısı.

Dönüş Değeri

asctimekarakter dizesi sonucu bir işaretçi döndürür; _wasctimegeniş karakter dizesi sonucu bir işaretçi döndürür.Hiçbir hata dönüş değeri vardır.

Notlar

Bu işlevler daha güvenli sürümlerinin kullanılabilir olduğunu; Bkz: asctime_s, _wasctime_s.

asctime İşlevi bir karakter dizesi için bir yapı olarak depolanan bir süre dönüştürür.timeptr Değer bir çağrıya elde genellikle gmtime veya localtime, hangi her ikisi için bir işaretçi döndürür bir tm zaman içinde tanımlanmış yapısı.H.

timeptr üye	Value
tm_hour	Saat gece (0-23)
tm_isdst	Gün ışığından yararlanma saatine devrede ise pozitif; 0 gün ışığından yararlanma saatine etkili değildir; gün ışığından yararlanma saatine durumu bilinmeyen ise negatif.c Çalışma Zamanı Kitaplığı, gün ışığından yararlanma saatine (dst) hesaplama gerçekleştirmek için Amerika Birleşik Devletleri kuralları varsayar.
tm_mday	Ayın (günleri 1-31)
tm_min	Dakika sonra saat (0-59 arasında)
tm_mon	Ay (0–11; Ocak = 0)
tm_sec	Saniye sonra dakika (0-59 arasında)
tm_wday	Haftanın (0–6; Pazar = 0)
tm_yday	(0–365; Yılın günü Ocak 1 = 0)
tm_year	Yıl (geçerli yıl 1900 eksi)

Dönüştürülen karakter dizesi de yerel saat dilimi ayarlara göre ayarlanır.Yerel saat yapılandırma hakkında daha fazla bilgi için bkz: zaman, _ftime, ve localtime işlevleri ve _tzset işlev genel değişkenleri ve saat dilimi ortamı tanımlama hakkında daha fazla bilgi için.

Yapımcı dize sonucu asctime tam olarak 26 karakter içerir ve aþaðýdaki biçime sahip Wed Jan 02 02:03:55 1980\n\0.24 Saatlik zaman biçimi kullanılır.Tüm alanları bir sabit genişliğe sahip olur.Yeni satır karakteri ve boş karakter dizesinin son iki pozisyon kaplar.asctimeDönüş dizesi tutacak bir tek, statik olarak ayrılan arabelleğini kullanır.Bu işlev için her çağrı, önceki çağrı sonucu bozar.

_wasctimegeniş karakter sürümü asctime._wasctimeve asctime Aksi takdirde aynı şekilde davranır.

Bu işlevler, kendi parametreleri doğrulayın.timeptr Bir null işaretçi veya aralık dışı değer içeriyorsa, geçersiz parametre işleyicisi, açıklandığı şekilde çağrılır Parametre doğrulama.İşlev verir yürütülmesine devam etmek için izin verilip verilmediğini, NULL ve errno için EINVAL.

Genel metin yordamı eşleme

TCHAR.H yordamına girildi	_UNICODE & _mbcs tanımlı değil	Tanımlanan _mbcs	Tanımlanan _UNICODE
_tasctime	asctime	asctime	_wasctime

Gereksinimler

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

Örnek

Bu program uzun tamsayı sistem saatini koyar aclock, yapısına çevirir newtime ve sonra dize biçimini kullanarak, çıkış asctime işlevi.

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