COleDateTime::COleDateTime

Artigo
08/25/2010

Constrói um COleDateTime objeto.

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 existenteCOleDateTime objeto a ser copiado para a nova COleDateTime objeto.
varSrc
Um existenteVARIANTE estrutura de dados (possivelmente um do COleVariant objeto) a ser convertido em um Data/time valor ()VT_DATE) e copiado para a nova COleDateTime objeto.
dtSrc
Uma data/time (DATA) valor a ser copiado para o novo COleDateTime objeto.
timeSrc
A time_t ou __time64_t valor a ser convertido em um Data/time valor e copiado para o novo COleDateTime objeto.
systimeSrc
A SYSTEMTIME estrutura a ser convertido em uma data / valor temporal e copiado para a nova COleDateTime objeto.
filetimeSrc
A FILETIME estrutura a ser convertido em uma data / valor temporal e copiado para a nova COleDateTime objeto. Observe que FILETIME usa a time universal coordenada (UTC), portanto, se você passar uma time local na estrutura, os resultados será incorretos. See Arquivo Times in the Windows SDK Para obter mais informações.
nYear, nMonth, nDay, nHour, nMin, nSec
Indicar os valores de data e time sejam copiados para o novo COleDateTime objeto.
wDosDate, wDosTime
Valor de valores de data e time do MS-DOS a ser convertido em uma data/time e copiado para o novo COleDateTime objeto.
dbts
Uma referência a um DBTimeStamp estrutura que contém a time local corrente.

Comentários

Todos esses construtores criar novo COleDateTime objetos inicializados para o valor especificado. A tabela a seguir mostra os intervalos válido para cada componente de data e time:

Componente de data/time	Intervalo válido
year	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 dia varia com base nos componentes do mês e ano.Para obter detalhes, consulte o SetDate or SetDateTime funções de membro.

A seguir é uma breve descrição de cada construtor:

COleDateTime( ) Constructs a COleDateTime object initialized to 0 (midnight, 30 December 1899).
COleDateTime( dateSrc ) Constructs a COleDateTime object from an existing COleDateTime object.
COleDateTime( varSrc ) Constructs a COleDateTime object.Tenta converter um VARIANTE a estrutura ou COleVariant objeto uma data/time ( VT_DATE) valor. Se essa conversão for bem-sucedida, o valor convertido será copiado para o novo COleDateTime objeto. Se não, o valor de COleDateTime objeto é definido como 0 (meia-noite, 30 de dezembro de 1899) e seu status para inválido.
COleDateTime( dtSrc ) Constructs a COleDateTime object from a DATE value.
COleDateTime( timeSrc ) Constructs a COleDateTime object from a time_t value.
COleDateTime( systimeSrc ) Constructs a COleDateTime object from a SYSTEMTIME value.
COleDateTime( filetimeSrc ) Constructs a COleDateTime object from a FILETIME value..Observe que FILETIME usa a time universal coordenada (UTC), portanto, se você passar uma time local na estrutura, os resultados será incorretos. See Arquivo Times in the Windows SDK Para obter mais informações.
COleDateTime( nYear, nMonth, nDay, nHour, nMin, nSec ) Constructs a COleDateTime object from the specified numerical values.
COleDateTime( wDosDate, wDosTime ) Constructs a COleDateTime object from the specified MS-DOS date and time values.

Para obter mais informações, consulte o VARIANTE entrada o Windows SDK.

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

Para obter mais informações, consulte o SYSTEMTIME and FILETIME estruturas no Windows SDK.

Para obter mais informações nos valores de data e time do MS-DOS, consulte DosDateTimeToVariantTime in the Windows SDK.

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

Observação:
O construtor usando DBTIMESTAMP parâmetro só está disponível quando OLEDB.h está 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);