CTime::CTime
Crea un nuevo objeto de CTime inicializada con el tiempo especificado.
CTime( ) throw( );
CTime(
__time64_t time
) throw( );
CTime(
int nYear,
int nMonth,
int nDay,
int nHour,
int nMin,
int nSec,
int nDST = -1
);
CTime(
WORD wDosDate,
WORD wDosTime,
int nDST = -1
);
CTime(
const SYSTEMTIME& st,
int nDST = - 1
) throw( );
CTime(
const FILETIME& ft,
int nDST = - 1
);
CTime(
const DBTIMESTAMP& dbts,
int nDST = -1
) throw( );
Parámetros
timeSrc
Indica un objeto de CTime que ya existe.time
Un valor de tiempo de __time64_t , que es el número de la hora UTC de segundos después del 1 de enero de 1970.Observe que se ajusta a la hora local.Por ejemplo, si está de Nueva York y crea un objeto de CTime pasando un parámetro de 0, CTime::GetMonth devolverá 12.En las versiones de Visual C++ 6,0 y anterior, time es un valor de time_t.Visual C++ .NET y convertirán posteriores un parámetro de time_t a __time64_t.
nYear, nMonth, nDay, nHour, nMin, nSec
Indica los valores de fecha y hora que se copiará en el nuevo objeto de CTime .nDST
Indica si el horario de verano está vigente.Puede tener uno de estos tres valores:nDST establecido en 0 horas normas está vigente.
nDST establecido en mayor que 0 horarios de verano de valor está en vigor.
nDST establecido en un valor menor que 0 valores predeterminados de El.Calcula automáticamente si la hora estándar o el horario de verano está vigente.
wDosDate, wDosTime
Valores de fecha y hora de MS-DOS que se convertirán a una fecha y un valor de hora y copiar en nuevo CTime el objeto.st
Una estructura de SYSTEMTIME para convertirse en una fecha y un valor de hora y copiados en nuevo CTime el objeto.ft
Una estructura de FILETIME para convertirse en una fecha y un valor de hora y copiados en nuevo CTime el objeto.dbts
Una referencia a una estructura de DBTimeStamp que contiene la hora local actual.
Comentarios
Cada constructor se describe a continuación:
CTime( ); construye un objeto sin inicializar de CTime .Este constructor permite definir las matrices de objetos de CTime .Debe inicializar estas matrices con tiempo válidas antes de su uso.
CTime( const CTime& ); construye un objeto de CTime de otro valor de CTime .
CTime( __time64_t ); construye un objeto de CTime de un tipo de __time64_t .Este constructor cuenta con una hora UTC y convierte el resultado a una hora local antes de almacenar el resultado.
Construcciones deCTime( int, int,…); un objeto de CTime de los componentes de la hora local con cada componente restringido a los intervalos siguientes:
Componente
Intervalo
nYear
1970–3000
nMonth
1–12
nDay
1–31
nHour
0-23
nMin
0-59
nSec
0-59
Este constructor crea la conversión adecuada en hora UTC.La versión de depuración de la biblioteca Microsoft Foundation Class aserciones si uno o más de los componentes de tiempo están fuera del intervalo.Debe validar los argumentos antes de llamar a.Este constructor cuenta con una hora local.
CTime( WORD, WORD ); construye un objeto de CTime de los valores especificados de fecha y hora de MS-DOS.Este constructor cuenta con una hora local.
CTime( const SYSTEMTIME& ); construye un objeto de CTime de una estructura de SYSTEMTIME .Este constructor cuenta con una hora local.
CTime( const FILETIME& ); construye un objeto de CTime de una estructura de FILETIME .No utilizará probablemente la inicialización de CTimeFILETIME directamente.Si utiliza un objeto de CFile para manipular un archivo, CFile::GetStatus recupera la marca de tiempo del archivo a través de un objeto de CTime inicializada con una estructura de FILETIME .Este constructor supone una hora basada en hora UTC y convierte automáticamente el valor en hora local antes de almacenar el resultado.
[!NOTA]
El constructor con el parámetro de DBTIMESTAMP sólo está disponible cuando OLEDB.h se incluye.
Para obtener más información, vea la estructura de SYSTEMTIME y de FILETIME en Windows SDK.Vea también la entrada de Fecha y hora de MS-DOS en Windows SDK.
Ejemplo
time_t osBinaryTime; // C run-time time (defined in <time.h>)
time(&osBinaryTime) ; // Get the current time from the
// operating system.
CTime time1; // Empty CTime. (0 is illegal time value.)
CTime time2 = time1; // Copy constructor.
CTime time3(osBinaryTime); // CTime from C run-time time
CTime time4(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999
Requisitos
encabezado: atltime.h