Classe di COleDateTime

Articolo
03/05/2013

Incapsula il tipo di dati DATE di automazione OLE.

class COleDateTime

Membri

Costruttori pubblici

Nome	Descrizione
COleDateTime::COleDateTime	Costruisce un oggetto COleDateTime.

Metodi pubblici

Nome	Descrizione
COleDateTime::Format	Genera una rappresentazione di stringa formattata di un oggetto COleDateTime.
COleDateTime::GetAsDBTIMESTAMP	Chiamare questo metodo per ottenere l'ora nell'oggetto COleDateTime come struttura dati DBTIMESTAMP.
COleDateTime::GetAsSystemTime	Chiamare questo metodo per ottenere l'ora nell'oggetto COleDateTime come struttura dati SYSTEMTIME.
COleDateTime::GetAsUDATE	Chiamare questo metodo per ottenere l'ora in COleDateTime come struttura dati UDATE.
COleDateTime::GetCurrentTime	Crea un oggetto COleDateTime che rappresenta l'ora corrente (funzione membro statico).
COleDateTime::GetDay	Restituisce il giorno che l'oggetto COleDateTime rappresenta (da 1 a 31).
COleDateTime::GetDayOfWeek	Restituisce il giorno della settimana che l'oggetto COleDateTime rappresenta (domenica = 1).
COleDateTime::GetDayOfYear	Restituisce il giorno dell'anno che l'oggetto COleDateTime per (1° gennaio = 1).
COleDateTime::GetHour	Restituisce l'ora che l'oggetto COleDateTime rappresenta (da 0 a 23).
COleDateTime::GetMinute	Restituisce il minuto che l'oggetto COleDateTime rappresenta (da 0 a 59).
COleDateTime::GetMonth	Restituisce il mese che l'oggetto COleDateTime rappresenta (da 1 a 12).
COleDateTime::GetSecond	Restituisce il secondo di questo oggetto rappresenta COleDateTime (da 0 a 59).
COleDateTime::GetStatus	Ottiene lo stato (validità) di questo oggetto COleDateTime.
COleDateTime::GetYear	Restituisce l'anno di questo oggetto COleDateTime rappresenta.
COleDateTime::ParseDateTime	Legge un valore data/ora da una stringa e imposta il valore COleDateTime.
COleDateTime::SetDate	Imposta il valore di questo oggetto COleDateTime il valore solo data specificato.
COleDateTime::SetDateTime	Imposta il valore di questo oggetto COleDateTime il valore data/ora specificato.
COleDateTime::SetStatus	Imposta lo stato (validità) di questo oggetto COleDateTime.
COleDateTime::SetTime	Imposta il valore di questo oggetto COleDateTime al valore di ora specificato.

Operatori pubblici

Nome	Descrizione
== Di COleDateTime::operator, COleDateTime::operator <, e così via.	Confronta due valori COleDateTime.
COleDateTime::operator +, - COleDateTime::operator	Aggiungere e sottrarre i valori COleDateTime.
COleDateTime::operator +=, COleDateTime::operator - =	Aggiungere e sottrarre un valore COleDateTime da questo oggetto COleDateTime.
COleDateTime::operator =	Copia un valore COleDateTime.
DATA di COleDateTime::operator, COleDateTime::operator Date*	Converte un valore COleDateTime in DATE o in DATE*.

Membri dati pubblici

Nome	Descrizione
COleDateTime::m_dt	Contiene date sottostante per questo oggetto COleDateTime.
COleDateTime::m_status	Contiene lo stato di questo oggetto COleDateTime.

Note

COleDateTime non dispone di una classe base.

È uno dei tipi possibili per il tipo di dati VARIANT di automazione OLE.Un valore COleDateTime rappresenta un valore assoluto di data e ora.

Il tipo DATE viene implementato come valore a virgola mobile.I giorni sono misurati dal 30 dicembre 1899, la mezzanotte.Nella tabella seguente vengono illustrate alcune date e i relativi valori collegati:

Data	Valore
29 dicembre 1899, Mezzanotte	-1.0
29 dicembre 1899, 6 A.m.	-1.25
30 dicembre 1899, Mezzanotte	0.0
31 dicembre 1899, Mezzanotte	1.0
1° gennaio 1900, 6 AM..	2.25

Attenzione
La nota nella tabella sopra quella sebbene il giorno stimare diventano negativo prima di mezzanotte il 30 dicembre 1899, valori di ora contrario.Ad esempio, il 6:00 è rappresentato sempre un valore frazionario 0,25 indipendentemente dall'intero che rappresenta il giorno è positivo (dopo il 30 dicembre 1899) o negativo (prima del 30 dicembre 1899).Ciò significa che un confronto semplice a virgola mobile ordinerebbe erroneamente COleDateTime che rappresenta il 6:00 del 12/29/1899 come later che un 7:00 di rappresentazione lo stesso giorno.

La nota nella tabella sopra quella sebbene il giorno stimare diventano negativo prima di mezzanotte il 30 dicembre 1899, valori di ora contrario.Ad esempio, il 6:00 è rappresentato sempre un valore frazionario 0,25 indipendentemente dall'intero che rappresenta il giorno è positivo (dopo il 30 dicembre 1899) o negativo (prima del 30 dicembre 1899).Ciò significa che un confronto semplice a virgola mobile ordinerebbe erroneamente COleDateTime che rappresenta il 6:00 del 12/29/1899 come later che un 7:00 di rappresentazione lo stesso giorno.

La classe COleDateTime gestisce le date dal 1° gennaio, 100, fino al 31 dicembre, 9999.La classe COleDateTime utilizza il calendario gregoriano, non supporta le date giuliano.COleDateTime ignora l'ora legale.(Vedere) data e ora: supporto di automazione.

[!NOTA]

È possibile utilizzare il formato %y per recuperare un anno a due cifre solo per le date di iniziare a 1900.Se si utilizza il formato %y a una data prima del 1900, il codice generato un errore ASSERT.

Questo tipo viene utilizzato per rappresentare valori di data o solo ora.Per convenzione, la data 0 (30 dicembre 1899) per i valori solo ora e il 00:00 di tempo (mezzanotte) per i valori solo data.

Se si crea un oggetto COleDateTime utilizzando una data precedente alla 100, la data viene accettata, ma chiamate successive a GetYear, GetMonth, GetDay, GetHour, GetMinutee permette GetSecond e restituiscono -1.In precedenza, utilizzare le date a due cifre, ma le date devono essere 100 o maggiore in MFC 4,2 e versioni successive.

Per evitare problemi, specificare una data a quattro cifre.Ad esempio:

COleDateTime mytime(1996, 1, 1, 0, 0, 0);

Le operazioni aritmetiche di base per i valori COleDateTime utilizzano la classe complementare COleDateTimeSpan.i valori diCOleDateTimeSpan definiscono un intervallo di tempo.La relazione tra queste classi è simile a quella tra CTime e CTimeSpan.

Per ulteriori informazioni sulle classi COleDateTimeSpan e COleDateTime, vedere l'articolo data e ora: supporto di automazione.