COleDateTime::SetDateTime
Imposta la data e l'ora dell'oggetto COleDateTime.
int SetDateTime(
int nYear,
int nMonth,
int nDay,
int nHour,
int nMin,
int nSec
) throw( );
Parametri
- nYear, nMonth, nDay, nHour, nMin, nSec
Scegliere i componenti di data e ora da copiare in questo oggetto COleDateTime.
Valore restituito
Zero se il valore di questo oggetto COleDateTime fosse impostato correttamente; in caso contrario, 1.Questo valore restituito è basato sul tipo enumerato DateTimeStatus.Per ulteriori informazioni, vedere la funzione membro SetStatus.
Note
Vedere la tabella seguente per i limiti dei valori di parametro:
Parametro |
Limiti |
|---|---|
nYear |
100 – 9999 |
nMonth |
1 – 12 |
nDay |
0 – 31 |
nHour |
0 – 23 |
nMin |
0 – 59 |
nSec |
0 – 59 |
Se il giorno degli overflow di mese, viene convertita al giorno del mese e il giorno e/o l'anno viene incrementato di conseguenza.Un valore di ora pari a zero indica l'ultimo giorno del mese precedente.Il comportamento sarà uguale a SystemTimeToVariantTime.
Se la data o il valore specificato dai parametri non è valido, lo stato di questo oggetto è impostata su non valido e il valore di questo oggetto non viene modificato.
Di seguito sono riportati alcuni esempi di valori:
nHour |
nMin |
nSec |
Valore |
|---|---|---|---|
1 |
3 |
3 |
01:03:03 |
23 |
45 |
0 |
23:45:00 |
25 |
30 |
0 |
Invalid |
9 |
60 |
0 |
Invalid |
Di seguito sono riportati alcuni esempi di valori di data:
nYear |
nMonth |
nDay |
Valore |
|---|---|---|---|
1995 |
4 |
15 |
15 aprile 1995 |
1789 |
7 |
14 |
17 luglio 1789 |
1925 |
2 |
30 |
Invalid |
10000 |
1 |
1 |
Invalid |
Per impostare la data solo, vedere COleDateTime::SetDate.Per impostare il tempo solo, vedere COleDateTime::SetTime.
Per informazioni sulle funzioni membro che interroga il valore di questo oggetto COleDateTime, vedere le seguenti funzioni membro:
Per ulteriori informazioni sui limiti dei valori COleDateTime, vedere l'articolo data e ora: supporto di automazione.
Esempio
Vedere l'esempio relativo GetStatus.
Requisiti
Header: atlcomtime.h