int SetDate (int nYear, int nMonth, int nDay );
Valor de retorno
Zero se o valor deste objeto COleDateTime foi definido com êxito; caso contrário, 1. Esse valor de retorno se baseia o DateTimeStatus enumerados tipo. Para obter mais informações, consulte a função de membro SetStatus.
Parâmetros
nYear, nMonth, nDay
Indica os componentes de data a ser copiados neste objeto COleDateTime.
Observações
Chame essa função de membro para definir a data e hora deste objeto COleDateTime . A data é definida como os valores especificados. O tempo é definido como 0, tempo de 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 | 1 – 31 |
O Ligado superior real de nDay valores varia de acordo com o mês e o ano. Meses 1, 3, 5, 7, 8, 10 e 12, o Ligado superior é 31. Meses 4, 6, 9 e 11, é 30. Mês 2, se for 28 ou 29 em um ano bissexto.
Se o data valor especificado pelos parâmetros não é válido, o status do objeto é definido como inválido e o valor deste objeto não será alterado.
Aqui estão 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 e hora, consulte COleDateTime:: SetDateTime.
Para obter informações sobre as funções de membro that consulta the valor of this objeto COleDateTime , see the seguinte funções membro:
Para obter mais informações sobre os limites para valores de COleDateTime , consulte o artigo data e hora: automação de suporte no Guia do programador do Visual C++.
Visão geral de COleDateTime | Membros de classe | Gráfico de hierarquia
Co&nsulte tambémnbsp;COleDateTime::COleDateTime, COleDateTime:: SetDateTime, COleDateTime:: operador =, COleDateTime::GetStatus, COleDateTime::m_dt