COleDateTime::Format
Tworzy sformatowany reprezentacja wartości daty i godziny.
CString Format(
DWORD dwFlags = 0,
LCID lcid = LANG_USER_DEFAULT
) const;
CString Format(
LPCTSTR lpszFormat
) const;
CString Format(
UINT nFormatID
) const;
Parametry
dwFlags
Wskazuje jedną z następujących flag ustawień regionalnych:LOCALE_NOUSEROVERRIDEDomyślne ustawienia regionalne ustawienia systemu, należy użyć zamiast niestandardowych ustawień użytkownika.
VAR_TIMEVALUEONLYIgnoruj część Data podczas analizy.
VAR_DATEVALUEONLYIgnoruj czas część podczas analizy.
lcid
Wskazuje identyfikator ustawień regionalnych do konwertowania.Aby uzyskać więcej informacji na temat identyfikatorów języka, zobacz Identyfikatorów języka.lpszFormat
Formatowanie ciągów podobny do printf ciąg formatowania.Formatowanie każdy kod, poprzedzony procent (%) podpisać, jest zastąpiony przez odpowiednie COleDateTime składnika.Inne znaki w ciągu formatowania są kopiowane bez zmian zwrócony ciąg.Zobacz opis funkcji wykonywania strftime uzyskać więcej informacji.Wartość i znaczenie kodów formatowania dla Format są:%HGodziny w dniu bieżącym
%MMinuty w bieżącej godziny
%SSekund na minuty
**%%**Znak procentu
nFormatID
Identyfikator zasobu ciągu sterowania formatem.
Wartość zwracana
A CString zawiera wartość sformatowana data/godzina.
Uwagi
Jeśli stan to COleDateTime obiekt jest null, wartość zwracana jest ciągiem pustym.Jeśli stan jest nieprawidłowy, zwracanego ciągu jest określona przez zasób ciąg ATL_IDS_DATETIME_INVALID.
Krótki opis trzy formularze dla tej funkcji jest następujący:
Format( dwFlags, lcid)
Ten formularz formaty wartości przy użyciu specyfikacji języka (identyfikatorów ustawień regionalnych) dla daty i godziny.Przy użyciu domyślnych parametrów, tego formularza będą drukowane daty i godziny, chyba, że część czasu jest 0 (północ), w którym to przypadku będzie drukować tylko daty lub część data jest 0 (30 grudnia 1899), w tym przypadku będzie drukować tylko raz.Jeśli wartość Data/godzina jest 0 (30 grudnia 1899 północy), ten formularz z parametrami domyślnymi zostanie wydrukowany o północy.Format( lpszFormat)
Ten formularz formatuje wartości przy użyciu ciąg formatu, który zawiera specjalne kody formatowania, które są poprzedzone znakiem procentu (%), jak w printf.Ciąg formatowania jest przekazywana jako parametr do funkcji.Aby uzyskać więcej informacji na temat kodów formatowania, zobacz strftime, wcsftime w odwołaniu biblioteki uruchomieniowej.Format( nFormatID)
Ten formularz formatuje wartości przy użyciu ciąg formatu, który zawiera specjalne kody formatowania, które są poprzedzone znakiem procentu (%), jak w printf.Ciąg formatowania jest zasób.Identyfikator zasobu ten ciąg jest przekazywana jako parametr.Aby uzyskać więcej informacji na temat kodów formatowania, zobacz strftime, wcsftime w Run-Time Library odniesienia.
Przykład
COleDateTime t(1999, 3, 19, 22, 15, 0);
CString str = t.Format(_T("%A, %B %d, %Y"));
ASSERT(str == _T("Friday, March 19, 1999"));
Wymagania
Nagłówek: atlcomtime.h