CTime::CTime

Artigo
02/25/2013

Cria um novo objeto de CTime inicializado com os momentos especificados.

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

Parâmetros

timeSrc
Indica um objeto de CTime que já existe.
time
Um valor de tempo de __time64_t , que é o número de segundos depois do 1º de janeiro de 1970 UTC.Observe que isso será ajustado para suas horário local.Por exemplo, se você estiver em York New e cria um objeto de CTime passando um parâmetro de CTime::GetMonth 0, retornará 12.

Em as versões 6,0 Visual C++ e anterior, time fosse um valor de time_t.Visual C++ .NET e converte posteriores um parâmetro de time_t a __time64_t.
nYear, nMonth, nDay, nHour, nMin, nSec
Indica a data e valores de tempo a ser copiados para o novo objeto de CTime .
nDST
Indica se a hora do horário de verão tem efeito.Pode ter um dos três valores:
- nDST definido como 0 horário padrão é aplicado.
- nDST definido tempo maiores do horário de verão do valor a um de 0 é aplicado.
- nDST definido como um valor menor que 0 a opção.Calcula automaticamente se o horário padrão ou a hora do horário de verão tem efeito.
wDosDate, wDosTime
Valores de data e hora de MS-DOS a ser convertido em um valor de data/hora e copiados novo em CTime o objeto.
st
Uma estrutura de SYSTEMTIME a ser convertido em um valor de data/hora e copiada novo em CTime o objeto.
ft
Uma estrutura de FILETIME a ser convertido em um valor de data/hora e copiada novo em CTime o objeto.
dbts
Uma referência a uma estrutura de DBTimeStamp que contém a hora local atual.

Comentários

Cada construtor é descrito abaixo:

CTime( ); constrói um objeto não inicializado de CTime .Esse construtor permite que você defina matrizes de objetos de CTime .Você deve inicializar tal matrizes com horários válidos antes de usar.
CTime( const CTime& ); constrói um objeto de CTime de outro valor de CTime .
CTime( __time64_t ); constrói um objeto de CTime de um tipo de __time64_t .Esse construtor espera uma hora UTC e converte o resultado a uma hora local antes de armazenar o resultado.
CTime( int, int,...); Compilações de um objeto de CTime de componentes de tempo local com cada componente restrito aos intervalos:

Componente

Intervalo

nYear

1970–3000

nMonth

1–12

nDay

1–31

nHour

0-23

nMin

0-59

nSec

0-59

Esse construtor faz coversão apropriado ao UTC.A versão de depuração de biblioteca de classes da Microsoft foundation afirma se um ou mais dos componentes de tempo estão fora do intervalo.Você deve validar os argumentos antes de chamar.Esse construtor espera uma hora local.
CTime( WORD, WORD ); constrói um objeto de CTime de valores de data e hora especificados de MS-DOS.Esse construtor espera uma hora local.
CTime( const SYSTEMTIME& ); constrói um objeto de CTime de uma estrutura de SYSTEMTIME .Esse construtor espera uma hora local.
CTime( const FILETIME& ); constrói um objeto de CTime de uma estrutura de FILETIME .Você provavelmente não usará a inicialização de CTimeFILETIME diretamente.Se você usar um objeto de CFile para manipular um arquivo, CFile::GetStatus recupera o carimbo de data/hora de arquivo para você por meio de um objeto de CTime inicializado com uma estrutura de FILETIME .Esse construtor pressupõe uma hora com base em UTC e automaticamente converte o valor em horário local antes de armazenar o resultado.

Observação

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

Componente	Intervalo
nYear	1970–3000
nMonth	1–12
nDay	1–31
nHour	0-23
nMin	0-59
nSec	0-59

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

Para obter mais informações, consulte a estrutura de SYSTEMTIME e de FILETIME em Windows SDK.Consulte também a entrada de Data e hora de MS-DOS em Windows SDK.

Exemplo

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