VarDateFromUdate, fonction (oleauto.h)

Convertit une heure et une date converties du format MS-DOS au format variant.

Syntaxe

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

Paramètres

[in] pudateIn

Date déballée.

[in] dwFlags

VAR_VALIDDATE si la date est valide.

[out] pdateOut

Date empaquetée.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Remarques

La structure UDATE est utilisée avec VarDateFromUdate, VarDateFromUdateEx et VarUdateFromDate. Il représente une date déballée.

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

La fonction VarDateFromUdate accepte les dates non valides et tente de les corriger lors de la résolution à une heure VARIANT. Par exemple, une date non valide telle que le 29/02/2001 sera résolue au 1/03/2001. Seuls les jours étant fixes, les valeurs de mois non valides entraînent le retour d’une erreur. Les jours sont vérifiés entre 1 et 31. Les jours négatifs et les jours supérieurs à 31 entraînent une erreur. Un jour inférieur à 31 mais supérieur au jour maximal de ce mois a le jour promu au jour approprié du mois suivant. Un jour égal à zéro est résolu comme le dernier jour du mois précédent. Par exemple, une date non valide telle que le 00/02/2001 sera résolue au 31/01/2001.

L’appel de VarDateFromUdate a le même effet que l’appel de VarDateFromUdateEx avec l'0x0409 LCID.

Configuration requise