Classe de CTime

Artigo
02/25/2013

Representa uma data e hora absolutas.

class CTime

Membros

Construtores public

Nome	Descrição
CTime::CTime	Constrói objetos de CTime de várias maneiras.

Métodos públicos

Nome	Descrição
CTime::Format	Converte um objeto de CTime em uma cadeia de caracteres formatada com base na zona de tempo local.
CTime::FormatGmt	Converte um objeto de CTime em uma cadeia de caracteres formatada com base em UTC.
CTime::GetAsDBTIMESTAMP	Converte informações de tempo armazenadas no objeto de CTime a estrutura de Win32-compatible DBTimeStamp .
CTime::GetAsSystemTime	Converte informações de tempo armazenadas no objeto de CTime a estrutura de Win32-compatible SYSTEMTIME .
CTime::GetCurrentTime	Cria um objeto de CTime que representa a hora atual (função de membro estático).
CTime::GetDay	Retorna o dia representam pelo objeto de CTime .
CTime::GetDayOfWeek	Retorna o dia da semana representada pelo objeto de CTime .
CTime::GetGmtTm	Divide um objeto de CTime nos componentes baseados em UTC.
CTime::GetHour	Retorna a hora representada pelo objeto de CTime .
CTime::GetLocalTm	Divide um objeto de CTime nos componentes baseados em na zona de tempo local.
CTime::GetMinute	Retorna o minuto representado pelo objeto de CTime .
CTime::GetMonth	Retorna o mês representado pelo objeto de CTime .
CTime::GetSecond	Retorna o segundo representado pelo objeto de CTime .
CTime::GetTime	Retorna um valor de __time64_t para o dado objeto de CTime .
CTime::GetYear	Retorna o ano representado pelo objeto de CTime .
CTime::Serialize64	Serializa a dados ou um arquivo neutro.

Operadores

operador + –	Esses operadores e adicione subtraem CTimeSpan e objetos de CTime .
operador +=, – =	Esses operadores e adicione subtraem um objeto de CTimeSpan a e de esse objeto de CTime .
operador =	o operador de atribuição.
== do operador, <, etc..	Operadores de comparação.

Comentários

CTime não tem uma classe base.

Os valores deCTime são baseados em tempo de coordenadas conventions (UTC), que são equivalentes a hora universais de coordenadas (o horário de Greenwich, GMT).Consulte Gerenciamento de tempo para obter informações sobre como o fuso horário é determinado.

Quando você cria um objeto de CTime , defina o parâmetro de nDST a 0 para indicar que a hora padrão é aplicado, ou para um valor maior que 0 para indicar que o horário de verão é aplicado, ou para um valor menor que zero para o cálculo de código de biblioteca em tempo de execução de C se o horário padrão ou o horário de verão tem efeito.tm_isdst é um campo necessário.Se não definida, o valor é indefinida e o valor de retorno de mktime é imprevisível.Se os pontos de timeptr a estrutura de TM retornada pela chamada anterior a asctime_s, a _gmtime_s, ou a localtime_s, o campo de tm_isdst contém o valor correto.

Uma classe, CTimeSpancomplementar, representa um intervalo de tempo.

As classes de CTime e de CTimeSpan não são criadas para a derivação.Como não há nenhuma função virtual, o tamanho de CTime e de objetos de CTimeSpan é exatamente 8 bytes.A maioria das funções de membro são embutidas.

Observação
O limite superior de data é 12/31/3000.O limite inferior é 1/1/1970 de 12:00: GMT DE 00 AM.

Para obter mais informações sobre como usar CTime, consulte os artigos Data e Hora, e Gerenciamento de tempo na referência da biblioteca em tempo de execução.

Observação
A estrutura de CTime alterado MFC 7,1 a MFC 8,0.Se você serializa uma estrutura de CTime usando operator << em MFC 8,0 ou posterior, o arquivo resultante não será legível em versões anteriores MFC.