Compartilhar via

Função VarUdateFromDate (oleauto.h)

  • Artigo

Converte uma hora e uma data convertidas do formato variante para o formato MS-DOS.

Sintaxe

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

Parâmetros

[in] dateIn

A data lotada.

[in] dwFlags

Definido para calendários alternativos, como Hijri, polonês e russo.

[out] pudateOut

A data desempacotar.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
E_INVALIDARG
 Um dos argumentos não é válido.
E_OUTOFMEMORY
 Memória insuficiente para concluir a operação.

Comentários

A estrutura UDATE é usada com VarDateFromUdate e VarUdateFromDate. Ele representa uma data "descompactada".

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

A função VarUdateFromDate aceitará datas inválidas e tentará corrigi-las ao resolver para uma hora VARIANT. Por exemplo, uma data inválida, como 29/02/2001, resolve para 1/3/2001. Somente os dias são fixos, portanto, os valores de mês inválidos resultam em um erro retornado. Os dias estão marcados para estar entre 1 e 31. Dias e dias negativos maiores que 31 resultam em um erro. Um dia menor que 31, mas maior que o dia máximo nesse mês tem o dia promovido para o dia apropriado do mês seguinte. Um dia igual a zero é resolvido como o último dia do mês anterior. Por exemplo, uma data inválida, como 0/2/2001, resolve a 31/1/2001.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho oleauto.h
Biblioteca OleAut32.lib
DLL OleAut32.dll