COleDateTime Class
Encapsula el tipo de datos DATE que se utiliza en la automatización OLE.
class COleDateTime
Members
Constructores públicos
Nombre |
Descripción |
---|---|
Crea un objeto COleDateTime. |
Métodos públicos
Nombre |
Descripción |
---|---|
Genera una representación de cadena con formato de un objeto COleDateTime . |
|
Llame a este método para obtener el tiempo en el objeto COleDateTime como estructura de datos DBTIMESTAMP . |
|
Llame a este método para obtener el tiempo en el objeto COleDateTime como estructura de datos SYSTEMTIME . |
|
Llame a este método para obtener el tiempo en COleDateTime como estructura de datos UDATE . |
|
Crea un objeto COleDateTime que representa la hora actual (función miembro estática). |
|
Devuelve el día que este objeto COleDateTime representa (1 – 31). |
|
Devuelve el día de la semana que este objeto COleDateTime representa (domingo = 1). |
|
Devuelve el día del año que este objeto COleDateTime representa (1 de enero = 1). |
|
Devuelve la hora que este objeto COleDateTime representa (0 – 23). |
|
Devuelve el minuto que este objeto COleDateTime representa (0 – 59). |
|
Devuelve el mes que este objeto COleDateTime representa (1 – 12). |
|
Devuelve el segundo este objeto COleDateTime representa (0 – 59). |
|
Obtiene el estado (validez) de este objeto COleDateTime . |
|
Devuelve el año que este objeto COleDateTime representa. |
|
Lee un valor de fecha u hora de una cadena y establece el valor COleDateTime. |
|
Establece el valor de este objeto COleDateTime al valor especificado de la fecha (sólo. |
|
Establece el valor de este objeto COleDateTime a fecha y el valor de tiempo especificados. |
|
Establece el estado (validez) de este objeto COleDateTime . |
|
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 . |
Agregue y reste los valores COleDateTime . |
|
Agregue y restar un valor COleDateTime de este objeto COleDateTime . |
|
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 |
---|---|
Contiene fecha subyacente para este objeto COleDateTime . |
|
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 |
Advertencia
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.
Requisitos
**Encabezado:**ATLComTime.h