CTime::CTime

Cria um novo CTime objeto inicializado com o time especificado.

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 CTime objeto que já existe.
time
A __time64_t time valor, que é o número de segundos após 1 º de janeiro de 1970 UTC.Observe que isso será ajustado para sua time local.Por exemplo, se você estiver em são Paulo e cria um CTime objeto por passar um parâmetro de 0, CTime::GetMonth retornará 12.

No Visual C++ versões 6.0 e anteriores, time foi um valor de time_t. O Visual C++ .NET e posteriormente converte um time_t parâmetro para __time64_t.
nYear, nMonth, nDay, nHour, nMin, nSec
Indica os valores de data e time sejam copiados para o novo CTime objeto.
nDST
Indica se verão time está em vigor.Pode ter um dos três valores:
- nDST conjunto para 0 time padrão está em vigor.
- nDST Defina um valor maior que 0 time de economia de verão está em vigor.
- nDST conjunto como um valor menor que 0 O padrão. Calcula automaticamente se time padrão ou horário de verão estiver em vigor.
wDosDate, wDosTime
Valor de valores de data e time do MS-DOS a ser convertido em uma data/time e copiado para o novo CTime objeto.
st
A SISTEMA time estrutura a ser convertido em uma data / time valor e copiado para o novo CTime objeto.
ft
A FILETIME estrutura ser convertido em um valor de data/time e copiado para o novo CTime objeto.
dbts
Uma referência a um DBTimeStamp estrutura que contém a time local corrente.

Comentários

Cada construtor é descrito a seguir:

() CTime; Constrói um não-inicializado CTime objeto. Esse construtor permite definir CTime matrizes de objeto. Você deve inicializar esses arrays com horas válidas antes de usar.
CTime (CTime const &); Constrói um CTime objeto a partir de outro CTime valor.
CTime (__time64_t); Constrói um CTime objeto de um __time64_t tipo.Esse construtor espera uma time UTC e converte o resultado em um horário local antes de armazenar o resultado.
CTime( int, int, ...); Constructs a CTime object from local time components with each component constrained to the following ranges:

Componente

Intervalo

nYear

1970–3000

nMonth

1–12

nDay

1–31

nHour

0-23

nMin

0-59

nSec

0-59

Esse construtor faz a conversão apropriada em UTC.Versão de depurar de biblioteca Microsoft Foundation classe declara se uma ou mais dos componentes de time estiverem fora do intervalo.Você deve validar os argumentos antes de chamar.Esse construtor espera um horário local.
CTime( PALAVRA, PALAVRA ); Constrói um CTime objeto de valores especificados de data e time do MS-DOS. Esse construtor espera um horário local.
CTime( Const SYSTEMTIME & ); Constrói um CTime objeto de um SYSTEMTIME estrutura. Esse construtor espera um horário local.
CTime( FILETIME const & ); Constrói um CTime objeto de um FILETIME estrutura. You most likely will not use CTime FILETIME initialization directly.Se você usar um CFile objeto para manipular um arquivo CFile::GetStatus recupera o carimbo de data / time de arquivo para você por meio de um CTime o objeto inicializado com um FILETIME estrutura. Esse construtor assume um horário com base no UTC e converte automaticamente o valor para a time local antes de armazenar o resultado.

Observação:

O construtor usando DBTIMESTAMP parâmetro só está disponível quando OLEDB.h está 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 usando DBTIMESTAMP parâmetro só está disponível quando OLEDB.h está incluído.

Para obter mais informações, consulte o SYSTEMTIME and FILETIME estrutura o Windows SDK. Consulte também o MS-DOS data e time entrada o 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