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

Vedere anche

Riferimenti

Classe di COleDateTime

Grafico della gerarchia

COleDateTime::COleDateTime

COleDateTime::SetDate

COleDateTime::SetTime

COleDateTime::operator =

COleDateTime::GetStatus

COleDateTime::m_dt