COleDateTimeSpan::Format

Articolo
03/05/2013

Genera una rappresentazione di stringa formattata di un oggetto COleDateTimeSpan.

CString Format(
   LPCTSTR pFormat 
) const;
CString Format(
   UINT nID 
) const;

Parametri

pFormat
Una stringa di formattazione simile alla stringa printf.I codici di formattazione, preceduti dalla percentuale (%) applicano, vengono sostituiti dalla parte corrispondente COleDateTimeSpan.Altri caratteri nella stringa di formattazione è invariato copiati nella stringa restituita.Il valore e il significato dei codici di formattazione per Formato vengono elencati di seguito:
- Ore di**%H** il giorno corrente
- Minuti di**%M** nell'ora corrente
- Secondi di**%S** del minuto corrente
- Simbolo di percentuale di %%
I quattro codici di formato elencati in precedenza sono gli unici codici nel formato accettato.
nID
ID di risorsa per la stringa di formato controllo.

Valore restituito

CString che contiene il valore di intervallo data/ora formattato.

Note

Chiamare queste funzioni per creare una rappresentazione in formato del valore di ora.Se lo stato di questo oggetto COleDateTimeSpan è null, verrà restituita una stringa vuota.Se lo stato non è valido, la stringa restituita è determinata dalla risorsa di tipo stringa IDS_INVALID_DATETIMESPAN.

Una breve descrizione dei form per la funzione seguente:

Format( pFormat )
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.
Format( nID )
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.

Esempio

// get the current time
COleDateTime tmStart = COleDateTime::GetCurrentTime();

// waste some time
CString str;
::Sleep(3000);

// get the current time again
COleDateTime tmFinish = COleDateTime::GetCurrentTime();

// find the difference
COleDateTimeSpan tmSpan = tmFinish - tmStart;

// tell the user
str = tmSpan.Format(_T("%S seconds elapsed"));
_tprintf_s(_T("%s\n"), (LPCTSTR) str);