int SetDateTime (int nYear, int nMonth, int nDay,int nHour, int nMin, int nSec );
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, nHour, nMin, nSec
Indica os componentes de data e hora sejam copiados para esse objeto COleDateTime.
Observações
Chame essa função de membro para definir a data e hora deste objeto COleDateTime.
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 |
| nHour | 0-23 |
| nMin | 0 – 59 |
| nSec | 0 – 59 |
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 valor de data ou hora especificado pelos parâmetros não é válido, que 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 tempo:
| nHour | nMin | nSec | Valor |
| 1 | 3 | 3 | 01:03:03 |
| 23 | 45 | 0 | 23:45 |
| 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 | 17 De julho de 1789 |
| 1925 | 2 | 30 | Inválido |
| 10000 | 1 | 1 | Inválido |
Para definir apenas a data, consulte COleDateTime::SetDate. Para definir o tempo somente, consulte COleDateTime::SetTime.
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::SetDate, COleDateTime::SetTime, COleDateTime:: operador =, COleDateTime::GetStatus, COleDateTime::m_dt