COleDateTime::SetDateTime
Define a data e time deste COleDateTime objeto.
int SetDateTime(
int nYear,
int nMonth,
int nDay,
int nHour,
int nMin,
int nSec
) throw( );
Parâmetros
- nYear, nMonth, nDay, nHour, nMin, nSec
Indicar os componentes de data e time 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
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 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 ou time especificado pelos parâmetros não for válido, que o status deste objeto é definido como inválido e o valor deste objeto não é alterado.
Aqui estão alguns exemplos de valores de time:
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 |
Aqui estão alguns exemplos de valores de data:
nYear |
nMonth |
nDay |
Valor |
|---|---|---|---|
1995 |
4 |
15 |
15 De abril de 1995 |
1789 |
7 |
14 |
De 1789 17 de julho |
1925 |
2 |
30 |
Inválido |
10000 |
1 |
1 |
Inválido |
Para conjunto somente a data, consulte COleDateTime::SetDate.Para conjunto somente a time, consulte COleDateTime::SetTime.
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
Consulte o exemplo para GetStatus.
Requisitos
Cabeçalho: atlcomtime.h