COleDateTimeSpan::Format

Artículo
06/09/2015

Genera una representación de cadena con formato de un objeto de COleDateTimeSpan .

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

Parámetros

pFormat
Una cadena de formato similar a printf que da formato a la cadena. Los códigos de formato, precedido por un signo de porcentaje (%), se reemplazan por el componente correspondiente de COleDateTimeSpan . Otros caracteres de la cadena de formato se copian sin cambiar la cadena devuelta. El valor y el significado de los códigos de formato para Formato se muestran a continuación:
- Horas de**%H** en el día actual
- %M Minutes en la hora actual
- %S Seconds en el minuto actual
- Signo de porcentaje %%
Los cuatro códigos de formato enumerados son los únicos códigos que el formato aceptará.
nID
el Id. de recurso para la cadena de la formato-CONTROL.

Valor devuelto

CString que contiene el valor con formato de fecha y de la duración.

Comentarios

Llame a estas funciones para crear una representación con formato de valor de duración. Si el estado de este objeto de COleDateTimeSpan es null, el valor devuelto es una cadena vacía. Si el estado no es válido, la cadena devuelta es especificada por el recurso de cadena IDS_INVALID_DATETIMESPAN.

Una descripción breve de formularios para esta función siguiente:

Format( pFormat )
Este formulario da formato al valor mediante la cadena de formato que contiene los códigos de formato especial que va precedido por un signo de porcentaje (%), como en printf. La cadena de formato se pasa como parámetro a la función.
Format( nID )
Este formulario da formato al valor mediante la cadena de formato que contiene los códigos de formato especial que va precedido por un signo de porcentaje (%), como en printf. La cadena de formato es un recurso. El identificador de este recurso de cadena se pasa como parámetro.

Ejemplo

// 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);