COleDateTime::Format
Crea una rappresentazione in formato del valore data/ora.
CString Format(
DWORD dwFlags = 0,
LCID lcid = LANG_USER_DEFAULT
) const;
CString Format(
LPCTSTR lpszFormat
) const;
CString Format(
UINT nFormatID
) const;
Parametri
dwFlags
Indica uno dei seguenti flag delle impostazioni locali:Utilizzo diLOCALE_NOUSEROVERRIDE le impostazioni locali predefinite di sistema, anziché le impostazioni utente personalizzate.
VAR_TIMEVALUEONLY ignora la parte relativa alla data durante l'analisi.
VAR_DATEVALUEONLY ignora la porzione di tempo durante l'analisi.
lcid
Indica l'id delle impostazioni locali da utilizzare per la conversione.Per ulteriori informazioni sugli identificatori di linguaggio, vedere identificatori di linguaggio.lpszFormat
Una stringa di formattazione simile alla stringa printf.Ogni codice di formattazione, preceduto dalla percentuale (%) firma, viene sostituito dalla parte corrispondente COleDateTime.Altri caratteri nella stringa di formattazione è invariato copiati nella stringa restituita.Vedere funzione di runtime strftime per ulteriori informazioni.Il valore e il significato dei codici di formattazione per Format sono:Ore di**%H** il giorno corrente
Minuti di**%M** nell'ora corrente
Secondi di**%S** del minuto corrente
Simbolo di percentuale di**%%**
nFormatID
ID di risorsa per la stringa di formato controllo.
Valore restituito
CString contenente il valore data/ora formattato.
Note
Se lo stato di questo oggetto COleDateTime è null, verrà restituita una stringa vuota.Se lo stato non è valido, la stringa restituita è determinata dalla risorsa di tipo stringa ATL_IDS_DATETIME_INVALID.
Una breve descrizione dei tre form per la funzione seguente:
Format( dwFlags, lcid)
Questo form il valore viene formattato mediante le specifiche del linguaggio (impostazioni locali ID) per la data e ora.Utilizzo di parametri predefiniti, questo form verrà stampato la data e l'ora, a meno che la porzione di tempo sia 0 (mezzanotte), nel qual caso verrà semplicemente la data, o la parte relativa alla data è 0 (30 dicembre 1899, nel qual caso verrà semplicemente il tempo.Se il valore data/ora è 0 (30 dicembre 1899, mezzanotte), questo form con parametri predefiniti verrà stampato la mezzanotte.Format( lpszFormat)
Questo form il valore viene formattato utilizzando la stringa di formato che contiene i codici di formattazione specifiche che sono preceduti da un segno di percentuale (%), come in printf.La stringa di formattazione viene passata come parametro alla funzione.Per ulteriori informazioni sui codici di formattazione, vedere strftime, wcsftime in riferimenti alla libreria di runtime.Format( nFormatID)
Questo form il valore viene formattato utilizzando la stringa di formato che contiene i codici di formattazione specifiche che sono preceduti da un segno di percentuale (%), come in printf.La stringa di formato è una risorsa.ID della risorsa di tipo stringa viene passato come parametro.Per ulteriori informazioni sui codici di formattazione, vedere strftime, wcsftime in Riferimenti alla libreria di runtime.
Esempio
COleDateTime t(1999, 3, 19, 22, 15, 0);
CString str = t.Format(_T("%A, %B %d, %Y"));
ASSERT(str == _T("Friday, March 19, 1999"));
Requisiti
intestazione: atlcomtime.h