COleDateTime::COleDateTime

Articolo
03/05/2013

Costruisce un oggetto COleDateTime.

COleDateTime( ) throw( ); 
COleDateTime(
   const VARIANT& varSrc 
) throw( );
COleDateTime(
   DATE dtSrc 
) throw( );
COleDateTime(
   time_t timeSrc 
) throw( );
COleDateTime(
   __time64_t timeSrc 
) throw( );
COleDateTime(
   const SYSTEMTIME& systimeSrc 
) throw( );
COleDateTime(
   const FILETIME& filetimeSrc 
) throw( );
COleDateTime(
   int nYear,
   int nMonth,
   int nDay,
   int nHour,
   int nMin,
   int nSec 
) throw( );
COleDateTime(
   WORD wDosDate,
   WORD wDosTime 
) throw( );
COleDateTime(
   const DBTIMESTAMP& dbts
) throw();

Parametri

dateSrc
Un oggetto esistente COleDateTime da copiare nel nuovo oggetto COleDateTime.
varSrc
Una struttura di dati esistente VARIANT possibilmente un oggetto COleVariant ) da convertire in un valore data/ora (VT_DATE) e copiata nuovo in COleDateTime l'oggetto.
dtSrc
Un valore data/ora (DATE) da copiare nel nuovo oggetto COleDateTime.
timeSrc
Un valore __time64_t o time_t da convertire in un valore data/ora e copiato nuovo in COleDateTime l'oggetto.
systimeSrc
Una struttura SYSTEMTIME da convertire in un valore data/ora e copiata nuovo in COleDateTime l'oggetto.
filetimeSrc
Una struttura FILETIME da convertire in un valore data/ora e copiata nuovo in COleDateTime l'oggetto.Si noti che FILETIME utilizza il tempo universale coordinato (UTC), pertanto se si passa un'ora locale nella struttura, i risultati saranno errati.Vedere Ore del file in Windows SDK per ulteriori informazioni.
nYear, nMonth, nDay, nHour, nMin, nSec
Scegliere i valori di data e ora da copiare nel nuovo oggetto COleDateTime.
wDosDate, wDosTime
Valori di data e ora MS-DOS da convertire in un valore data/ora e copiati nuovo in COleDateTime l'oggetto.
dbts
Un riferimento a una struttura DBTimeStamp contenente l'ora locale corrente.

Note

Tutti questi costruttori creano nuovi oggetti COleDateTime inizializzati sul valore specificato.Nella tabella seguente sono indicati gli intervalli validi per ogni componente di data e ora:

Data/componente relativo all'ora	Intervallo valido
anno	100 – 9999
mese	0 – 12
giorno	0 – 31
ora	0 – 23
minuto	0 – 59
in secondo luogo	0 – 59

Si noti che il limite superiore per il componente giorno varia in base al mese e i componenti relativi all'anno.Per ulteriori informazioni, vedere le funzioni membro SetDateTime o SetDate.

Di seguito viene fornita una breve descrizione di ciascun costruttore:

COleDateTime() costruisce un oggetto COleDateTime inizializzato su 0 (mezzanotte, il 30 dicembre 1899).
COleDateTime(dateSrc) costruisce un oggetto COleDateTime da un oggetto esistente COleDateTime.
il varSrc**)** di**COleDateTime(**costruisce un oggetto COleDateTime.Tenta di convertire una struttura VARIANT o un oggetto COleVariant a un valore data/ora (VT_DATE).Se la conversione ha esito positivo, il valore convertito viene copiato nel nuovo oggetto COleDateTime.Se non è, il valore dell'oggetto COleDateTime è impostato su 0 (mezzanotte, il 30 dicembre 1899) e il relativo stato a non valido.
COleDateTime(dtSrc) costruisce un oggetto COleDateTime da un valore DATE.
COleDateTime(timeSrc) costruisce un oggetto COleDateTime da un valore time_t.
lo systimeSrc**)** di**COleDateTime(**costruisce un oggetto COleDateTime da un valore SYSTEMTIME.
COleDateTime(filetimeSrc) costruisce un oggetto COleDateTime da un valore FILETIME..Si noti che FILETIME utilizza il tempo universale coordinato (UTC), pertanto se si passa un'ora locale nella struttura, i risultati saranno errati.Vedere Ore del file in Windows SDK per ulteriori informazioni.
COleDateTime(nYear, nMonth, nDay, nHour, nMin, nSec) costruisce un oggetto COleDateTime dai valori numerici specificati.
COleDateTime(wDosDate, wDosTime) costruisce un oggetto COleDateTime dai valori specificati di data e ora di MS-DOS.

Per ulteriori informazioni sul tipo di dati time_t, vedere la funzione tempoin riferimenti alla libreria di runtime.

Per ulteriori informazioni, vedere le strutture FILETIME e SYSTEMTIME in Windows SDK.

Per ulteriori informazioni sui limiti dei valori COleDateTime, vedere l'articolo data e ora: supporto di automazione.

[!NOTA]

Il costruttore che utilizza il parametro DBTIMESTAMP è disponibile solo quando OLEDB.h è incluso.

Esempio

time_t osBinaryTime;   // C run-time time (defined in <time.h>)
time(&osBinaryTime);   // Get the current time from the 
                     // operating system.

COleDateTime time1;   // initialized to 00:00am, 30 December 1899
                     // (and m_nStatus is valid!)

COleDateTime time2 = time1; // Copy constructor
COleDateTime time3(osBinaryTime);   // from time_t
COleDateTime time4(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999

SYSTEMTIME sysTime;   // Win32 time information
GetSystemTime(&sysTime);

COleDateTime time5(sysTime);