Función VarUdateFromDate (oleauto.h)

  • Artículo

Convierte una hora y una fecha convertidas de formato variant a formato MS-DOS.

Sintaxis

HRESULT VarUdateFromDate(
  [in]  DATE  dateIn,
  [in]  ULONG dwFlags,
  [out] UDATE *pudateOut
);

Parámetros

[in] dateIn

Fecha empaquetada.

[in] dwFlags

Se establece para calendarios alternativos, como Hijri, polaco y ruso.

[out] pudateOut

Fecha desempaquetada.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 Correcto.
E_INVALIDARG
 Uno de los argumentos no es válido.
E_OUTOFMEMORY
 Memoria insuficiente para completar la operación.

Comentarios

La estructura UDATE se usa con VarDateFromUdate y VarUdateFromDate. Representa una fecha "desempaquetada".

typedef struct {
    SYSTEMTIME st;
    USHORT  wDayOfYear;
} UDATE;

La función VarUdateFromDate aceptará fechas no válidas e intentará corregirlas al resolver en una hora VARIANT. Por ejemplo, una fecha no válida como 29/29/2001 se resolverá en 3/1/2001. Solo se han corregido los días, por lo que los valores de mes no válidos producen un error que se devuelve. Se comprueba que los días estén comprendidos entre 1 y 31. Los días negativos y los días mayores que 31 producen un error. Un día menor que 31 pero mayor que el día máximo de ese mes tiene el día promocionado al día adecuado del mes siguiente. Un día igual a cero se resuelve como el último día del mes anterior. Por ejemplo, una fecha no válida, como el 0/2/2001, se resolverá en 31/1/2001.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado oleauto.h
Library OleAut32.lib
Archivo DLL OleAut32.dll