COleDateTime::SetDateTime
establece la fecha y hora de este objeto de COleDateTime .
int SetDateTime(
int nYear,
int nMonth,
int nDay,
int nHour,
int nMin,
int nSec
) throw( );
Parámetros
- nYear, nMonth, nDay, nHour, nMin, nSec
Indica los componentes de fecha y hora 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
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 |
nHour |
0 – 23 |
nMin |
0 – 59 |
nSec |
0 – 59 |
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 la fecha o el tiempo especificado por los parámetros no es válido, establece el estado de este objeto como no válido y el valor de este objeto no cambia.
A continuación se muestran algunos ejemplos de valores de hora:
nHour |
nMin |
nSec |
Valor |
---|---|---|---|
1 |
3 |
3 |
01:03:03 |
23 |
45 |
0 |
23:45:00 |
25 |
30 |
0 |
Invalid |
9 |
60 |
0 |
Invalid |
A continuación se muestran algunos ejemplos de valores de fecha:
nYear |
nMonth |
nDay |
Valor |
---|---|---|---|
1995 |
4 |
15 |
15 de abril de 1995 |
1789 |
7 |
14 |
17 de julio de 1789 |
1925 |
2 |
30 |
Invalid |
10000 |
1 |
1 |
Invalid |
Para establecer la fecha sólo, vea COleDateTime:: SetDate. Para establecer la hora sólo, vea COleDateTime:: SetTime.
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
Vea el ejemplo para GetStatus.
Requisitos
encabezado: atlcomtime.h