COleDateTime::COleDateTime

Artigo
02/25/2013

Constrói um objeto de 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();

Parâmetros

dateSrc
Um objeto existente de COleDateTime a ser copiado para o novo objeto de COleDateTime .
varSrc
Uma estrutura de dados existente de VARIANT (possivelmente um objeto de COleVariant ) a ser convertido em um valor de data/hora (VT_DATE) e copiada novo em COleDateTime o objeto.
dtSrc
Um valor de data/hora (DATE) a ser copiado para o novo objeto de COleDateTime .
timeSrc
Um valor de time_t ou de __time64_t a ser convertido em um valor de data/hora e copiado novo em COleDateTime o objeto.
systimeSrc
Uma estrutura de SYSTEMTIME a ser convertido em um valor de data/hora e copiada novo em COleDateTime o objeto.
filetimeSrc
Uma estrutura de FILETIME a ser convertido em um valor de data/hora e copiada novo em COleDateTime o objeto.Observe que o universal dos usos de FILETIME coordenou tempo (UTC), então se você passar uma hora local na estrutura, seus resultados incorretos serão.Consulte Tempo de Arquivo em Windows SDK para mais informações.
nYear, nMonth, nDay, nHour, nMin, nSec
Indica a data e valores de tempo a ser copiados para o novo objeto de COleDateTime .
wDosDate, wDosTime
Valores de data e hora de MS-DOS a ser convertido em um valor de data/hora e copiados novo em COleDateTime o objeto.
dbts
Uma referência a uma estrutura de DBTimeStamp que contém a hora local atual.

Comentários

Todos esses construtores criam novos objetos de COleDateTime inicializados para o valor especificado.A tabela a seguir mostra intervalos válidos para cada componente de data e hora:

Componente de data/hora	Intervalo válido
ano	100 – 9999
mês	0 – 12
dia	0 – 31
hora	0 – 23
minuto	0 – 59
segundo	0 – 59

Observe que o limite superior real para o componente do dia varia de acordo com os componentes do mês e ano.Para obter detalhes, consulte as funções de membro de SetDate ou de SetDateTime .

A seguir está um breve descrição de cada construtor:

Compilações deCOleDateTime() um objeto de COleDateTime inicializado para 0 (meia-noite, o 30 de dezembro de 1899).
COleDateTime(dateSrc) constrói um objeto de COleDateTime de um objeto existente de COleDateTime .
o varSrc**)** de**COleDateTime(**constrói um objeto de COleDateTime .Tenta converter uma estrutura de VARIANT ou um objeto de COleVariant a um valor de data/hora (VT_DATE).Se essa conversão é bem-sucedida, o valor convertido é copiado para o novo objeto de COleDateTime .Se não estiver, o valor do objeto de COleDateTime é definido como 0 (meia-noite, o 30 de dezembro de 1899) e seu status para inválido.
COleDateTime(dtSrc) constrói um objeto de COleDateTime de um valor de DATE .
COleDateTime(timeSrc) constrói um objeto de COleDateTime de um valor de time_t .
o systimeSrc**)** de**COleDateTime(**constrói um objeto de COleDateTime de um valor de SYSTEMTIME .
COleDateTime(filetimeSrc) constrói um objeto de COleDateTime de um valor de FILETIME ..Observe que o universal dos usos de FILETIME coordenou tempo (UTC), então se você passar uma hora local na estrutura, seus resultados incorretos serão.Consulte Tempo de Arquivo em Windows SDK para mais informações.
COleDateTime(nYear, nMonth, nDay, nHour, nMin, nSec) constrói um objeto de COleDateTime de valores numéricos especificados.
COleDateTime(wDosDate, wDosTime) constrói um objeto de COleDateTime de valores de data e hora especificados de MS-DOS.

Para obter mais informações sobre o tipo de dados de time_t , consulte a função de tempona referência da biblioteca em tempo de execução.

Para obter mais informações, consulte as estruturas de SYSTEMTIME e de FILETIME em Windows SDK.

Para obter mais informações sobre limites para valores de COleDateTime , consulte o artigo Data e hora: Suporte de automação.

Observação
O construtor que usa o parâmetro de DBTIMESTAMP está disponível apenas quando OLEDB.h é incluído.

Exemplo

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);