CTime::CTime
Crea un nuovo oggetto CTime inizializzato con l'ora specificata.
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( );
Parametri
timeSrc
Indica un oggetto CTime già esistente.time
Un valore __time64_t, ovvero il numero di secondi dopo il 1° gennaio 1970 UTC. Si noti che questo venga portato all'ora locale. Ad esempio, se si in New York e creare un oggetto CTime passando un parametro di 0, CTime::GetMonth restituirà 12.In Visual C++ versione 6,0 e precedenti, time è un valore time_t. Visual C++.NET e convertiti successivi un parametro time_t a __time64_t.
nYear, nMonth, nDay, nHour, nMin, nSec
Legge i valori di data e ora da copiare nel nuovo oggetto CTime.nDST
Indica se tenuto conto dell'ora legale è attiva. Può assumere uno dei tre valori:nDST impostato su 0 ore standard è attiva.
nDST impostato a maggiore di 0 ore di ora legale del giorno di valore è attiva.
nDST impostato su un valore minore di 0 l'impostazione predefinita. Calcola automaticamente se viene tenuto conto dell'ora legale o di ora solare sia attiva.
wDosDate, wDosTime
Valori di data e ora MS-DOS da convertire in un valore data/ora e copiati nuovo in CTime l'oggetto.st
Una struttura SYSTEMTIME da convertire in un valore data/ora e copiata nuovo in CTime l'oggetto.ft
Una struttura FILETIME da convertire in un valore data/ora e copiata nuovo in CTime l'oggetto.dbts
Un riferimento a una struttura DBTimeStamp contenente l'ora locale corrente.
Note
Ogni costruttore viene descritto di seguito:
CTime( ); costruisce un oggetto non inizializzata CTime. Questo costruttore consente di definire le matrici di oggetti CTime. È necessario inizializzare tali matrici con ore validi prima di utilizzare.
CTime( const CTime& ); costruisce un oggetto CTime da un altro valore CTime.
CTime( __time64_t ); costruisce un oggetto CTime da un tipo __time64_t. Questo costruttore accetta un'ora UTC e converte il risultato a un'ora locale prima di archiviare il risultato.
CTime( int, int,…); costruisce un oggetto CTime da componenti dell'ora locale con ogni componente vincolata agli intervalli:
Componente
Intervallo
nYear
1970–3000
nMonth
1–12
nDay
1–31
nHour
0-23
nMin
0-59
nSec
0-59
Questo costruttore esegue la conversione appropriata all'ora UTC. La versione di debug delle asserzioni della libreria MFC se uno o più componenti relativi all'ora sono esterni intervallo. È necessario convalidare gli argomenti prima di chiamare. Questo costruttore accetta un'ora locale.
CTime( WORD, WORD ); costruisce un oggetto CTime dai valori specificati di data e ora di MS-DOS. Questo costruttore accetta un'ora locale.
CTime( const SYSTEMTIME& ); costruisce un oggetto CTime da una struttura SYSTEMTIME. Questo costruttore accetta un'ora locale.
CTime( const FILETIME& ); costruisce un oggetto CTime da una struttura FILETIME. Probabilmente non utilizzare direttamente l'inizializzazione CTimeFILETIME. Se si utilizza un oggetto CFile per modificare un file, CFile::GetStatus recupera il timestamp dell'ora del file automaticamente tramite un oggetto CTime inizializzato con una struttura FILETIME. Questo costruttore assume un momento in base all'ora UTC e converte automaticamente il valore nell'ora locale prima di archiviare il risultato.
Nota
Il costruttore che utilizza il parametro DBTIMESTAMP è disponibile solo quando OLEDB.h è incluso.
Per ulteriori informazioni, vedere la struttura FILETIME e SYSTEMTIME in Windows SDK. Vedere anche la voce Data e ora MS-DOS in Windows SDK.
Esempio
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
Requisiti
Header: atltime.h