COleDateTime::SetDateTime

Artigo
06/09/2015

Define a data e hora de esse 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 os componentes de data e hora a serem copiados em este objeto de COleDateTime .

Valor de retorno

Zero se o valor de esse objeto de COleDateTime foi definido com êxito; caso contrário, 1. Este valor de retorno é baseado no tipo enumerado de DateTimeStatus . Para obter mais informações, consulte a função de membro de SetStatus .

Comentários

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
nHour	0 – 23
nMin	0 – 59
nSec	0 – 59

Se o dia do mês transborda, é convertido para o dia do mês seguinte correto e o mês e/ou o ano são incrementadas de acordo. Um valor do dia de zero indica o último dia do mês anterior. o comportamento é o mesmo que SystemTimeToVariantTime.

Se a data ou o valor de data especificada pelos parâmetros são inválido, o status de esse objeto é definido como inválido e o valor de esse objeto não é alterado.

Eis alguns exemplos dos valores de tempo:

nHour	nMin	nSec	Valor
1	3	3	01:03:03
23	45	0	23:45:00
25	30	0	Inválido
9	60	0	Inválido

Eis alguns exemplos de valores de data:

nYear	nMonth	nDay	Valor
1995	4	15	15 de abril de 1995
1789	7	14	17 de julho de 1789
1925	2	30	Inválido
10000	1	1	Inválido

Para definir a data somente, consulte COleDateTime::SetDate. Para definir a hora somente, consulte COleDateTime::SetTime.

Para obter mais informações sobre funções de membro que consulte o valor de esse objeto de COleDateTime , consulte as seguintes funções de membro: