CTime::CTime
Tworzy nowy CTime obiektu zainicjowany z określonego czasu.
CTime( ) throw( );
CTime(
__time64_t time
) throw( );
CTime(
int nYear,
int nMonth,
int nDay,
int nHour,
int nMin,
int nSec,
int nDST = -1
);
CTime(
WORD wDosDate,
WORD wDosTime,
int nDST = -1
);
CTime(
const SYSTEMTIME& st,
int nDST = - 1
) throw( );
CTime(
const FILETIME& ft,
int nDST = - 1
);
CTime(
const DBTIMESTAMP& dbts,
int nDST = -1
) throw( );
Parametry
timeSrc
Wskazuje CTime obiekt, który już istnieje.time
A __time64_t wartość czasu jest liczba sekund, po 1 stycznia 1970 roku UTC.Należy zauważyć, że ta zostanie dostosowana do czasu lokalnego.Na przykład, jeśli w Nowym Jorku i utworzyć CTime obiektu przez przekazanie parametru 0, CTime::GetMonth zwróci 12.W wersji Visual C++ 6.0 i starsze time została wartość time_t.Visual C++ .net i konwertuje później time_t parametr __time64_t.
nYear, nMonth, nDay, nHour, nMin, nSec
Wskazuje wartości daty i godziny można skopiować do nowej CTime obiektu.nDST
Wskazuje, czy obowiązuje czasu letniego.Może mieć jedną z trzech wartości:nDSTwartość 0, który jest czas standardowy.
nDSTUstaw wartość większa niż 0, który obowiązuje czasu letniego.
nDSTustawiona wartość mniejsza niż domyślne.Automatycznie oblicza się, czy czas standardowy lub czasu letniego obowiązuje.
wDosDate, wDosTime
Wartości daty i godziny MS-DOS konwertowane na wartości daty i godziny i kopiowane do nowej CTime obiektu.st
A SYSTEMTIME być konwertowane na wartości daty i godziny i kopiowane do nowej struktury CTime obiektu.ft
A FILETIME być konwertowane na wartości daty i godziny i kopiowane do nowej struktury CTime obiektu.dbts
Odwołanie do DBTimeStamp struktury zawierającej bieżący czas lokalny.
Uwagi
Poniżej opisano każdy konstruktora:
(CTime); Konstrukcje niezainicjowanej CTime obiektu.Ten konstruktor pozwala zdefiniować CTime obiektu tablic.Należy zainicjować takie tablice z prawidłowe godziny przed użyciem.
CTime (const CTime & ); Konstrukcje CTime obiekt z innego CTime wartości.
CTime (__time64_t); Konstrukcje CTime obiekt z __time64_t typu.Ten konstruktor oczekuje, że czas UTC i konwertuje wynik na czas lokalny, przed rozpoczęciem przechowywania wynik.
CTime (int, int,...); Konstrukcje CTime obiektu od składników czas lokalny z każdego składnika ograniczone do następujących zakresów:
Składnik
Zakres
nYear
1970–3000
nMonth
1–12
nDay
1–31
nHour
0-23
nMin
0-59
nSec
0-59
Ten konstruktor czyni konwersję odpowiednie do czasu UTC.Wersja debugowania biblioteki klas Microsoft Foundation twierdzi, jeśli jeden lub więcej składników czasu są poza zakresem.Należy sprawdzić poprawność argumenty przed wywoływaniem.Ten konstruktor oczekuje czasu lokalnego.
CTime( WORD, WORD ); Konstrukcje CTime obiektu od określonej wartości daty i godziny systemu MS-DOS.Ten konstruktor oczekuje czasu lokalnego.
CTime( const SYSTEMTIME & ); Konstrukcje CTime obiekt z SYSTEMTIME struktury.Ten konstruktor oczekuje czasu lokalnego.
CTime( const FILETIME & ); Konstrukcje CTime obiekt z FILETIME struktury.Najprawdopodobniej nie będzie używać CTimeFILETIME bezpośrednio do inicjowania.Jeśli używasz CFile obiektu do manipulowania plik, CFile::GetStatus pobiera plik sygnaturę czasową dla przez CTime zainicjować obiektu z FILETIME struktury.Ten konstruktor zakłada godziny UTC i automatycznie konwertuje wartość na czas lokalny, przed rozpoczęciem przechowywania wynik.
[!UWAGA]
Za pomocą konstruktora odcisk CZASOWY parametr jest dostępny tylko, gdy OLEDB.h jest włączone.
Aby uzyskać więcej informacji, zobacz SYSTEMTIME i FILETIME struktury w Windows SDK.Zobacz też systemu MS-DOS, datę i godzinę wpis w Windows SDK.
Przykład
time_t osBinaryTime; // C run-time time (defined in <time.h>)
time(&osBinaryTime) ; // Get the current time from the
// operating system.
CTime time1; // Empty CTime. (0 is illegal time value.)
CTime time2 = time1; // Copy constructor.
CTime time3(osBinaryTime); // CTime from C run-time time
CTime time4(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999
Wymagania
Nagłówek: atltime.h