COleDateTime::SetDate

Artículo
02/19/2013

establece la fecha de este objeto de COleDateTime .

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

Parámetros

nYear, nMonth, nDay
Indica los componentes de la fecha que se copiarán en este objeto de COleDateTime .

Valor devuelto

Cero si el valor de este objeto de COleDateTime se estableció correctamente; de lo contrario, 1.este valor devuelto se basa en el tipo enumerado de DateTimeStatus .Para obtener más información, vea la función miembro de SetStatus trabajar.

Comentarios

La fecha se establece en los valores especificados.Se establece la hora de sincronizar 0, medianoche.

Vea la tabla siguiente para los límites para los valores de parámetro:

Parámetro	Límites
nYear	100 – 9999
nMonth	1 – 12
nDay	0 – 31

Si desborda el día del mes, se convierte al día correcto de mes y aumentan el mes y el año en consecuencia.Un valor de día de cero indica el último día del mes anterior.El comportamiento es igual que SystemTimeToVariantTime.

Si el valor de fecha especificado por los parámetros no es válido, establece el estado de este objeto a COleDateTime:: no válido.Debe utilizar GetStatus para comprobar la validez del valor de fecha y no debe suponer que el valor de m_dt permanece sin modificar.

A continuación se muestran algunos ejemplos de valores de fecha:

nYear	nMonth	nDay	Valor
2000	2	29	29 de febrero de 2000
1776	7	4	4 de julio de 1776
1925	4	35	Abril de 1925 35 (fecha no válida)
10000	1	1	1 de enero 10000 (Fecha no válida)

Para establecer ambos fecha y hora, vea COleDateTime:: SetDateTime.

Para obtener información sobre las funciones miembro que consulta el valor de este objeto de COleDateTime , vea las siguientes funciones miembro:

Para obtener más información sobre los límites para los valores de COleDateTime , vea el artículo fecha y hora: Compatibilidad de automatización.

Ejemplo

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