COleDateTime::COleDateTime

Artículo
06/09/2015

Crea un objeto COleDateTime.

COleDateTime( ) throw( ); 
COleDateTime( 
   const VARIANT& varSrc  
) throw( ); 
COleDateTime( 
   DATE dtSrc  
) throw( ); 
COleDateTime( 
   time_t timeSrc  
) throw( ); 
COleDateTime( 
   __time64_t timeSrc  
) throw( ); 
COleDateTime( 
   const SYSTEMTIME& systimeSrc  
) throw( ); 
COleDateTime( 
   const FILETIME& filetimeSrc  
) throw( ); 
COleDateTime( 
   int nYear, 
   int nMonth, 
   int nDay, 
   int nHour, 
   int nMin, 
   int nSec  
) throw( ); 
COleDateTime( 
   WORD wDosDate, 
   WORD wDosTime  
) throw( ); 
COleDateTime( 
   const DBTIMESTAMP& dbts 
) throw();

Parámetros

dateSrc
Un objeto existente de COleDateTime se copie en el nuevo objeto de COleDateTime .
varSrc
Una estructura de datos de VARIANT (posiblemente un objeto de COleVariant ) que se convertirá en una fecha o un valor de hora (VT_DATE) y copiados en nuevo COleDateTime el objeto.
dtSrc
Un valor de fecha y hora (DATE) que se copien en el nuevo objeto de COleDateTime .
timeSrc
Un valor de time_t o de __time64_t para convertirse en una fecha y un valor de hora y copiar en nuevo COleDateTime el objeto.
systimeSrc
Una estructura de SYSTEMTIME para convertirse en una fecha y un valor de hora y copiados en nuevo COleDateTime el objeto.
filetimeSrc
Una estructura de FILETIME para convertirse en una fecha y un valor de hora y copiados en nuevo COleDateTime el objeto. Observe que la hora Universal Coordinada de las aplicaciones de FILETIME (hora UTC), por lo que si se pasa una hora local en la estructura, los resultados serán incorrectos. Vea Tiempos de archivo en Windows SDK para obtener más información.
nYear, nMonth, nDay, nHour, nMin, nSec
Indica los valores de fecha y hora que se copiará en el nuevo objeto de COleDateTime .
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 COleDateTime el objeto.
dbts
Una referencia a una estructura de DBTimeStamp que contiene la hora local actual.

Comentarios

Todos estos constructores crean los nuevos objetos de COleDateTime inicializados en el valor especificado. La tabla siguiente se muestran los intervalos válidos para cada componente de fecha y hora:

Componente de fecha y hora	intervalo válido
año	100 – 9999
mes	0 – 12
día	0 – 31
hora	0 – 23
minuto	0 – 59
segundo	0 – 59

Observe que el límite superior real para el componente de días varía según los componentes del mes y el año. Para obtener información detallada, vea SetDate o miembro de SetDateTime funciona.

A continuación se ofrece una breve descripción de cada constructor:

Las construcciones deCOleDateTime() un objeto de COleDateTime inicializados en 0 (medianoche, el 30 de diciembre de 1899).
COleDateTime(dateSrc) construye un objeto de COleDateTime de un objeto existente de COleDateTime .
el varSrc**)** de**COleDateTime(**construye un objeto de COleDateTime . Intentos de convertir una estructura de VARIANT o un objeto de COleVariant en un valor de fecha y hora (VT_DATE). Si esta conversión se realiza correctamente, el valor convertido se copia en el nuevo objeto de COleDateTime . Si no es así, el valor del objeto de COleDateTime se establece en 0 (medianoche, el 30 de diciembre de 1899) y su estado a no válido.
COleDateTime(dtSrc) construye un objeto de COleDateTime de un valor de fecha.
COleDateTime(timeSrc) construye un objeto de COleDateTime de un valor de time_t .
el systimeSrc**)** de**COleDateTime(**construye un objeto de COleDateTime de un valor de SYSTEMTIME .
COleDateTime(filetimeSrc) construye un objeto de COleDateTime de un valor de FILETIME . . Observe que la hora Universal Coordinada de las aplicaciones de FILETIME (hora UTC), por lo que si se pasa una hora local en la estructura, los resultados serán incorrectos. Vea Tiempos de archivo en Windows SDK para obtener más información.
COleDateTime(nYear, nMonth, nDay, nHour, nMin, nSec) construye un objeto de COleDateTime de valores numéricos especificados.
COleDateTime(wDosDate, wDosTime) construye un objeto de COleDateTime de los valores especificados de fecha y hora de MS-DOS.

Para obtener más información sobre el tipo de datos de time_t , vea la función de tiempo en la referencia de la biblioteca en tiempo de ejecución.

Para obtener más información, vea las estructuras de SYSTEMTIME y de FILETIME en Windows SDK.

Para obtener más información sobre los límites para los valores de COleDateTime , vea el artículo fecha y hora: Compatibilidad de automatización.

Nota

El constructor con el parámetro de DBTIMESTAMP sólo está disponible cuando OLEDB.h se incluye.

Ejemplo

time_t osBinaryTime;   // C run-time time (defined in <time.h>)
time(&osBinaryTime);   // Get the current time from the  
                     // operating system.

COleDateTime time1;   // initialized to 00:00am, 30 December 1899 
                     // (and m_nStatus is valid!)

COleDateTime time2 = time1; // Copy constructor
COleDateTime time3(osBinaryTime);   // from time_t
COleDateTime time4(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999

SYSTEMTIME sysTime;   // Win32 time information
GetSystemTime(&sysTime);

COleDateTime time5(sysTime);