Clase de COleDateTime

Artículo
04/10/2013

Encapsula el tipo de datos DATE que se utiliza en la automatización OLE.

class COleDateTime

Members

Constructores públicos

Nombre	Descripción
COleDateTime::COleDateTime	Crea un objeto COleDateTime.

Métodos públicos

Nombre	Descripción
COleDateTime::Format	Genera una representación de cadena con formato de un objeto COleDateTime .
COleDateTime::GetAsDBTIMESTAMP	Llame a este método para obtener el tiempo en el objeto COleDateTime como estructura de datos DBTIMESTAMP .
COleDateTime::GetAsSystemTime	Llame a este método para obtener el tiempo en el objeto COleDateTime como estructura de datos SYSTEMTIME .
COleDateTime::GetAsUDATE	Llame a este método para obtener el tiempo en COleDateTime como estructura de datos UDATE .
COleDateTime::GetCurrentTime	Crea un objeto COleDateTime que representa la hora actual (función miembro estática).
COleDateTime::GetDay	Devuelve el día que este objeto COleDateTime representa (1 – 31).
COleDateTime::GetDayOfWeek	Devuelve el día de la semana que este objeto COleDateTime representa (domingo = 1).
COleDateTime::GetDayOfYear	Devuelve el día del año que este objeto COleDateTime representa (1 de enero = 1).
COleDateTime::GetHour	Devuelve la hora que este objeto COleDateTime representa (0 – 23).
COleDateTime::GetMinute	Devuelve el minuto que este objeto COleDateTime representa (0 – 59).
COleDateTime::GetMonth	Devuelve el mes que este objeto COleDateTime representa (1 – 12).
COleDateTime::GetSecond	Devuelve el segundo este objeto COleDateTime representa (0 – 59).
COleDateTime::GetStatus	Obtiene el estado (validez) de este objeto COleDateTime .
COleDateTime::GetYear	Devuelve el año que este objeto COleDateTime representa.
COleDateTime::ParseDateTime	Lee un valor de fecha u hora de una cadena y establece el valor COleDateTime.
COleDateTime::SetDate	Establece el valor de este objeto COleDateTime al valor especificado de la fecha (sólo.
COleDateTime::SetDateTime	Establece el valor de este objeto COleDateTime a fecha y el valor de tiempo especificados.
COleDateTime::SetStatus	Establece el estado (validez) de este objeto COleDateTime .
COleDateTime::SetTime	Establece el valor de este objeto COleDateTime al valor especificado de Tiempo - únicamente.

Operadores públicos

Nombre	Descripción
== De COleDateTime::operator, COleDateTime::operator <, etc..	Compara dos valores COleDateTime .
COleDateTime::operator +, COleDateTime::operator -	Agregue y reste los valores COleDateTime .
COleDateTime::operator +=, COleDateTime::operator - =	Agregue y restar un valor COleDateTime de este objeto COleDateTime .
COleDateTime::operator =	Copia un valor COleDateTime .
DATE de COleDateTime::operator, COleDateTime::operator Date*	Convierte un valor COleDateTime en DATE o DATE*.

Miembros de datos públicos

Nombre	Descripción
COleDateTime::m_dt	Contiene fecha subyacente para este objeto COleDateTime .
COleDateTime::m_status	Contiene el estado de este objeto COleDateTime .

Comentarios

COleDateTime no tiene una clase base.

Es uno de los tipos posibles para el tipo de datos VARIANT de automatización OLE.Un valor COleDateTime representa un valor absoluto de fecha y hora.

Implementan el tipo DATE como valor de punto flotante.Los días se miden a partir del 30 de diciembre de 1899, en la medianoche.La tabla siguiente muestra algunas fechas y sus valores asociados:

Fecha	Valor
29 de diciembre de 1899, Medianoche	-1.0
29 de diciembre de 1899, 6 Mañanas	-1.25
30 de diciembre de 1899, Medianoche	0.0
31 de diciembre de 1899, Medianoche	1.0
1 de enero de 1900, 6..	2.25

Precaución
La nota en la tabla anterior que aunque los valores del día dejen de ser negativos antes de medianoche el 30 de diciembre de 1899, valores de hora no.Por ejemplo, las 6:00 se representa siempre por un valor fraccionario 0,25 independientemente de si el entero que representa el día es positivo (después del 30 de diciembre de 1899) o negativa (antes del 30 de diciembre de 1899).Esto significa que una comparación simple de punto flotante clasificaría erróneamente COleDateTime que representa las 6:00 en 12/29/1899 como later que un 7:00 de representación en el mismo día.

La nota en la tabla anterior que aunque los valores del día dejen de ser negativos antes de medianoche el 30 de diciembre de 1899, valores de hora no.Por ejemplo, las 6:00 se representa siempre por un valor fraccionario 0,25 independientemente de si el entero que representa el día es positivo (después del 30 de diciembre de 1899) o negativa (antes del 30 de diciembre de 1899).Esto significa que una comparación simple de punto flotante clasificaría erróneamente COleDateTime que representa las 6:00 en 12/29/1899 como later que un 7:00 de representación en el mismo día.

La clase COleDateTime controla las fechas a partir del 1 de enero, 100, hasta el 31 de diciembre, 9999.La clase COleDateTime utiliza el calendario gregoriano; no admite las fechas juliano.COleDateTime omite el horario de verano.(Vea Fecha y hora: Compatibilidad de automatización.)

[!NOTA]

Puede usar el formato %y para recuperar un año de dos dígitos sólo por fechas que empieza en 1900.Si utiliza el formato %y en una fecha antes de 1900, el código genera un error ASSERT.

Utilizan este tipo también para representar valores de fecha - solo o de Tiempo - únicamente.Por convención, la fecha 0 (30 de diciembre de 1899) se utiliza para los valores y las 00:00 de tiempo (medianoche) de Tiempo - sólo se utiliza para valores de fecha - únicamente.

Si crea un objeto COleDateTime mediante una fecha menor que 100, se acepta la fecha, pero las llamadas subsiguientes a GetYear, GetMonth, GetDay, GetHour, GetMinute, y el error y devuelva -1 GetSecond .Previamente, puede usar las fechas de dos dígitos, pero las fechas deben ser 100 o más grandes en MFC 4,2 y posterior.

Para evitar problemas, especifique una fecha de cuatro dígitos.Por ejemplo:

COleDateTime mytime(1996, 1, 1, 0, 0, 0);

Las operaciones aritméticas básicas por los valores COleDateTime utilizan la clase COleDateTimeSpancomplementarias.Los valores deCOleDateTimeSpan definen un intervalo de tiempo.La relación entre estas clases es similar a la que está entre CTime y CTimeSpan.

Para obtener más información sobre las clases COleDateTime y COleDateTimeSpan , vea el artículo Fecha y hora: Compatibilidad de automatización.