COleDateTime::SetDate

Artigo
08/25/2010

Define a data e time deste COleDateTime objeto.

int SetDate(
   int nYear,
   int nMonth,
   int nDay 
) throw( );

Parâmetros

nYear, nMonth, nDay
Indicar os componentes de data a ser copiado para este COleDateTime objeto.

Valor de retorno

Zero se o valor de esseCOleDateTime objeto foi conjunto com êxito; caso contrário, 1. Esse valor retornado se baseia o DateTimeStatus tipo enumerado.Para obter mais informações, consulte o SetStatusfunção de membro .

Comentários

A data é conjunto para os valores especificados.O time é conjunto time 0, meia-noite.

Consulte a tabela a seguir para limites para os valores de parâmetro:

Parâmetro	Limites
nYear	100 – 9999
nMonth	1 – 12
nDay	0 – 31

Se o dia do mês estourar, ela é convertida para o dia correto do próximo mês e o mês e/ou ano é incrementado adequadamente.Um dia o valor zero indica o último dia do mês anterior.O comportamento é semelhante a SystemTimeToVariantTime.

Se o valor de data especificado pelos parâmetros inválido for válido, o status deste objeto é definido como COleDateTime::invalid.Você deve usar GetStatus para verificar a validade do DATA valor e não deve presumir que o valor de m_dt permanecerá inalterado.

Aqui estão alguns exemplos de valores de data:

nYear	nMonth	nDay	Valor
2000	2	29	29 De fevereiro de 2000
1776	7	4	De 1776 4 de julho
1925	4	35	35 De 1925 abril (Data inválido)
10000	1	1	1 De janeiro 10000 (Data inválido)

Para conjunto a data e time, consulte COleDateTime::SetDateTime.

Para obter informações sobre funções de membro que consulta o valor de esseCOleDateTime objeto, consulte as seguintes funções de membro:

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

Exemplo

// set only the date, time set to midnight
dt.SetDate(1999, 3, 19);
ASSERT(dt.GetYear() == 1999);
ASSERT(dt.GetDay() == 19);
ASSERT(dt.GetMonth() == 3);
ASSERT(dt.GetHour() == 0);
ASSERT(dt.GetMinute() == 0);
ASSERT(dt.GetSecond() == 0);

// setting the time only resets the date to 1899!
dt.SetTime(22, 15, 0);
ASSERT(dt.GetYear() == 1899);
ASSERT(dt.GetDay() == 30);
ASSERT(dt.GetMonth() == 12);
ASSERT(dt.GetHour() == 22);
ASSERT(dt.GetMinute() == 15);
ASSERT(dt.GetSecond() == 0);