COleDateTime::SetDateTime
Określa datę i godzinę to COleDateTime obiektu.
int SetDateTime(
int nYear,
int nMonth,
int nDay,
int nHour,
int nMin,
int nSec
) throw( );
Parametry
- nYear, nMonth, nDay, nHour, nMin, nSec
Wskazuje datę i godzinę składniki skopiowane do tego COleDateTime obiektu.
Wartość zwracana
Zero, jeśli wartość tego COleDateTime obiekt został ustawiony pomyślnie; inaczej, 1.Zwrócona wartość jest oparte na DateTimeStatus typ wyliczeniowy.Aby uzyskać więcej informacji, zobacz SetStatus funkcji składowej.
Uwagi
Zobacz granice wartości parametrów w poniższej tabeli:
Parametr |
Granice |
|---|---|
nYear |
100 – 9999 |
nMonth |
1 – 12 |
nDay |
0 – 31 |
nHour |
0 – 23 |
nMin |
0 – 59 |
nSec |
0 – 59 |
Jeśli zachodzi dzień miesiąca, są konwertowane na poprawne dnia następnego miesiąca i miesiąca lub roku jest zwiększana odpowiednio.Dzień wartość zero wskazuje ostatni dzień poprzedniego miesiąca.Zachowanie jest taki sam, jak SystemTimeToVariantTime.
Jeśli wartość daty lub godziny określonej przez parametry nie jest prawidłowy stan tego obiektu ustawiono nieprawidłowy i wartość tego obiektu nie ulega zmianie.
Oto niektóre przykłady wartości czasu:
nHour |
nMin |
nSec |
Wartość |
|---|---|---|---|
1 |
3 |
3 |
01:03:03 |
23 |
45 |
0 |
23:45:00 |
25 |
30 |
0 |
Nieprawidłowy |
9 |
60 |
0 |
Nieprawidłowy |
Oto niektóre przykłady wartości dat:
nYear |
nMonth |
nDay |
Wartość |
|---|---|---|---|
1995 |
4 |
15 |
15 Kwietnia 1995 r. |
1789 |
7 |
14 |
17 Lipca 1789 |
1925 |
2 |
30 |
Nieprawidłowy |
10000 |
1 |
1 |
Nieprawidłowy |
Aby ustawić tylko daty, zobacz COleDateTime::SetDate.Aby ustawić tylko raz, zobacz COleDateTime::SetTime.
Informacje na temat funkcji Członkowskich, które kwerendę dotyczącą wartości to COleDateTime obiektów, zobacz następujące funkcje składowe:
Aby uzyskać więcej informacji na temat granic dla COleDateTime wartości, zobacz artykuł datę i godzinę: automatyzacja obsługi.
Przykład
Zobacz przykład dla GetStatus.
Wymagania
Nagłówek: atlcomtime.h