Classe de COleDateTime

Artigo
03/26/2013

Encapsula o tipo de dados de DATE que é usado na automação OLE.

class COleDateTime

Membros

Construtores public

Nome	Descrição
COleDateTime::COleDateTime	constrói um objeto de COleDateTime .

métodos públicos

Nome	Descrição
COleDateTime::Format	Produz uma representação de cadeia de caracteres formatada de um objeto de COleDateTime .
COleDateTime::GetAsDBTIMESTAMP	Chamar esse método para obter o tempo no objeto de COleDateTime como uma estrutura de dados de DBTIMESTAMP .
COleDateTime::GetAsSystemTime	Chamar esse método para obter o tempo no objeto de COleDateTime como uma estrutura de dados de SYSTEMTIME .
COleDateTime::GetAsUDATE	Chamar esse método para obter o tempo em COleDateTime como uma estrutura de dados de UDATE .
COleDateTime::GetCurrentTime	Cria um objeto de COleDateTime que representa a hora atual (função de membro estático).
COleDateTime::GetDay	Retorna o dia onde esse objeto de COleDateTime representa 1 (– 31).
COleDateTime::GetDayOfWeek	Retorna o dia da semana onde esse objeto de COleDateTime representa domingo (= 1).
COleDateTime::GetDayOfYear	Retorna o dia do ano onde esse objeto de COleDateTime representa (1º de janeiro = 1).
COleDateTime::GetHour	Retorna a hora em este objeto de COleDateTime representa 0 (– 23).
COleDateTime::GetMinute	Retorna o minuto onde esse objeto de COleDateTime representa 0 (– 59).
COleDateTime::GetMonth	Retorna o mês que este objeto de COleDateTime representa 1 (– 12).
COleDateTime::GetSecond	Retorna o segundo este objeto de COleDateTime representa 0 (– 59).
COleDateTime::GetStatus	Obtém o status () validade de esse objeto de COleDateTime .
COleDateTime::GetYear	Retorna o ano onde esse objeto de COleDateTime representa.
COleDateTime::ParseDateTime	Ler um valor de data/hora de uma cadeia de caracteres e defina o valor de COleDateTime.
COleDateTime::SetDate	Defina o valor de esse objeto de COleDateTime para o valor especificado de data - somente.
COleDateTime::SetDateTime	Defina o valor de esse objeto de COleDateTime para o valor especificado de data/hora.
COleDateTime::SetStatus	Define o status () validade de esse objeto de COleDateTime .
COleDateTime::SetTime	Defina o valor de esse objeto de COleDateTime para o valor especificado hora somente.

operadores públicos

Nome	Descrição
== De COleDateTime::operator, COleDateTime::operator <, etc..	compare dois valores de COleDateTime .
COleDateTime::operator +, - COleDateTime::operator	Adicionar ou subtrair valores de COleDateTime .
COleDateTime::operator +=, COleDateTime::operator - =	Adicionar ou subtrair um valor de COleDateTime de esse objeto de COleDateTime .
COleDateTime::operator =	copia um valor de COleDateTime .
DATA de COleDateTime::operator, COleDateTime::operator Date*	Converter um valor de COleDateTime em DATE ou em DATE*.

Membros públicos de dados

Nome	Descrição
COleDateTime::m_dt	Contém DATA subjacente para este objeto de COleDateTime .
COleDateTime::m_status	Contém o status de esse objeto de COleDateTime .

Comentários

COleDateTime não tem uma classe base.

É um dos tipos possíveis para o tipo de dados de VARIANTE de automação OLE.Um valor de COleDateTime representa um valor de data e hora absoluto.

o tipo de DATE é implementado como um valor de ponto flutuante.Os dias são medidos desde o 30 de dezembro de 1899, na meia-noite.A tabela a seguir mostra certas datas e seus valores associados:

Date	Valor
29 de dezembro de 1899, Meia-noite	-1.0
29 de dezembro de 1899, M A 6.	-1.25
30 de dezembro de 1899, Meia-noite	0.0
31 de dezembro de 1899, Meia-noite	1.0
1º de janeiro de 1900, 6 AM..	2.25

Cuidado
Observação na tabela anterior do que embora os valores de eles se tornem negativos dia antes da meia-noite o 30 de dezembro de 1899, valores de hora não.Por exemplo, o 6:00 AM sempre é representado por um valor fracionário 0,25 independentemente se o número inteiro que representa o dia for positivo (depois do 30 de dezembro de 1899) ou negativo (antes do 30 de dezembro de 1899).Isso significa que uma comparação simples de ponto flutuante classificaria erroneamente que representa o COleDateTime 6:00 AM em 12/29/1899 porque later de um 7:00 de representação AM no mesmo dia.

Observação na tabela anterior do que embora os valores de eles se tornem negativos dia antes da meia-noite o 30 de dezembro de 1899, valores de hora não.Por exemplo, o 6:00 AM sempre é representado por um valor fracionário 0,25 independentemente se o número inteiro que representa o dia for positivo (depois do 30 de dezembro de 1899) ou negativo (antes do 30 de dezembro de 1899).Isso significa que uma comparação simples de ponto flutuante classificaria erroneamente que representa o COleDateTime 6:00 AM em 12/29/1899 porque later de um 7:00 de representação AM no mesmo dia.

A classe trata de COleDateTime datas desde o 1º de janeiro, 100, 9999., até o 31 de dezembroa classe de COleDateTime usa o calendário gregoriano; não suporta datas julianas.COleDateTime ignora o horário de verão.(Consulte) Data e hora: Suporte de automação.

Observação
você pode usar o formato de %y para recuperar um ano de dois dígitos somente por datas que começa em 1900.Se você usar o formato de %y em uma data antes de 1900, o código gera uma falha AFIRMAR.

Este tipo também é usado para representar valores de data - somente ou hora somente.Por convenção, a data 0 (30 de dezembro de 1899) é usada para valores hora somente o e 00:00 de tempo (meia-noite) é usada para valores de data - somente.

Se você criar um objeto de COleDateTime usando uma data menor que 100, a data for aceita, mas chamadas subseqüentes a GetYear, GetMonth, GetDay, GetHour, GetMinute, e falha de GetSecond e retorne -1.Anteriormente, você pode usar datas de dois dígitos, mas as datas devem ser 100 ou maior em MFC 4,2 e posterior.

Para evitar problemas, especifique uma data de quatro dígitos.Por exemplo:

COleDateTime mytime(1996, 1, 1, 0, 0, 0);

Operações aritméticas básicas para os valores de COleDateTime usam a classe complementar COleDateTimeSpan.os valores deCOleDateTimeSpan definem um intervalo de tempo.A relação entre essas classes é semelhante a aquela entre CTime e CTimeSpan.

Para obter mais informações sobre as classes de COleDateTime e de COleDateTimeSpan , consulte o artigo Data e hora: Suporte de automação.