Compartir a través de


CTime Class

representa una hora y una fecha absolutas.

class CTime

Members

Constructores públicos

Name

Descripción

CTime::CTime

Crea los objetos de CTime de varias maneras.

Métodos públicos

Name

Descripción

CTime::Format

Convierte un objeto de CTime en una cadena con formato basada en la zona horaria local.

CTime::FormatGmt

Convierte un objeto de CTime en una cadena con formato basada en hora UTC.

CTime::GetAsDBTIMESTAMP

Convierte la información de tiempo almacenada en el objeto de CTime a una estructura de Win32-compatible DBTimeStamp .

CTime::GetAsSystemTime

Convierte la información de tiempo almacenada en el objeto de CTime a una estructura de Win32-compatible SYSTEMTIME .

CTime::GetCurrentTime

Crea un objeto de CTime que representa la hora actual (función miembro estática).

CTime::GetDay

devuelve el día representan por el objeto de CTime .

CTime::GetDayOfWeek

devuelve el día de la semana representada por el objeto de CTime .

CTime::GetGmtTm

Analiza un objeto de CTime en componentes — basados en hora UTC.

CTime::GetHour

devuelve la hora representada por el objeto de CTime .

CTime::GetLocalTm

Analiza un objeto de CTime en componentes — según la zona horaria local.

CTime::GetMinute

devuelve el minuto representado por el objeto de CTime .

CTime::GetMonth

devuelve el mes representado por el objeto de CTime .

CTime::GetSecond

devuelve el segundo representado por el objeto de CTime .

CTime::GetTime

Devuelve un valor de __time64_t para el objeto especificado de CTime .

CTime::GetYear

Devuelve el año representado por el objeto de CTime .

CTime::Serialize64

Serializa los datos a o desde un archivo.

Operadores

operador + –

estos operadores agregan y restan CTimeSpan y los objetos de CTime .

operador +=, – =

Estos operadores agregan y restar un objeto de CTimeSpan a y desde este objeto de CTime .

operador =

el operador de asignación.

operator ==, <, etc..

operadores de comparación.

Comentarios

CTime no tiene una clase base.

los valores deCTime se basan el la hora universal coordinada (UTC), que es equivalente a la hora universal coordinada (hora media de Greenwich o, GMT). Vea Administración del tiempo para obtener información sobre cómo se determina la zona horaria.

Cuando se crea un objeto de CTime , establezca el parámetro de nDST en 0 para indicar que la hora estándar está vigente, o un valor mayor que 0 para indicar que el tiempo de guardar de luz está vigente, o un valor menor que cero para obtener el cálculo del código de la biblioteca en tiempo de ejecución de C si la hora estándar o tiempo de guardar de luz está vigente. tm_isdst es un campo obligatorio. Si no establece, su valor es indefinido y el valor devuelto de mktime es imprevisible. Si los puntos de timeptr a una estructura de TM devuelta por una llamada anterior a asctime_s, a _gmtime_s, o a localtime_s, el campo de tm_isdst contienen el valor correcto.

Una clase complementaria, CTimeSpan, representa un intervalo de tiempo.

Las clases de CTime y de CTimeSpan no están diseñados para la derivación. Porque no hay funciones virtuales, el tamaño de CTime y objetos de CTimeSpan es 8 bytes. La mayoría de las funciones miembro inline.

Nota

La fecha límite superior es 12/31/3000.El límite inferior es 1/1/1970 12:00: GMT OF 00.

Para obtener más información sobre cómo utilizar CTime, vea los artículos fecha y hora, y administración de tiempo en la referencia de la biblioteca en tiempo de ejecución.

Nota

La estructura de CTime modificada de MFC 7,1 a MFC 8,0.Si se serializa una estructura de CTime mediante operator << en MFC 8,0 o una versión posterior, el archivo resultante no será legible en versiones anteriores de MFC.

Requisitos

encabezado: atltime.h

Vea también

Referencia

asctime_s, _wasctime_s

_ftime_s, _ftime32_s, _ftime64_s

gmtime_s, _gmtime32_s, _gmtime64_s

localtime_s, _localtime32_s, _localtime64_s

strftime, wcsftime, _strftime_l, _wcsftime_l

time, _time32, _time64

CTimeSpan Class

Gráfico de jerarquías

Otros recursos

ATL/MFC Shared Classes