Compartir a través de

Función VarDateFromUdate (oleauto.h)

  • Artículo

Convierte una hora y una fecha convertidas del formato MS-DOS al formato variant.

Sintaxis

HRESULT VarDateFromUdate(
  [in]  UDATE *pudateIn,
  [in]  ULONG dwFlags,
  [out] DATE  *pdateOut
);

Parámetros

[in] pudateIn

Fecha desempaquetada.

[in] dwFlags

VAR_VALIDDATE si la fecha es válida.

[out] pdateOut

Fecha empaquetada.

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, VarDateFromUdateEx y VarUdateFromDate. Representa una fecha desempaquetada.

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

La función VarDateFromUdate aceptará fechas no válidas e intentará corregirlas al resolver una hora VARIANT. Por ejemplo, una fecha no válida, como el 2/29/2001, se resolverá en 3/1/2001. Solo los días son fijos, 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, las fechas no válidas como 2/0/2001 se resolverán en 1/31/2001.

Llamar a VarDateFromUdate tiene el mismo efecto que llamar a VarDateFromUdateEx con el LCID 0x0409.

Requisitos

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