COleDateTime::ParseDateTime

Article
03/04/2013

Analyse une chaîne pour lire une valeur de date/d'heure.

bool ParseDateTime(
   LPCTSTR lpszDate,
   DWORD dwFlags = 0,
   LCID lcid = LANG_USER_DEFAULT 
) throw( );

Paramètres

lpszDate
Un pointeur vers une chaîne terminée par le caractère NULL qui doit être analysée.Pour plus d'informations, consultez les notes.
dwFlags
Spécifie des indicateurs pour les paramètres régionaux et l'analyse.Un ou plusieurs des indicateurs suivants :
- Utilisation deLOCALE_NOUSEROVERRIDE les paramètres régionaux par défaut du système, plutôt que les paramètres utilisateur personnalisés.
- VAR_TIMEVALUEONLY ignorent la partie de dates pendant l'analyse.
- VAR_DATEVALUEONLY ignorent la partie horaire pendant l'analyse.
lcid
Indique l'ID de paramètres régionaux à utiliser pour la conversion.

Valeur de retour

Retourne true si la chaîne a été correctement convertie en valeur de date/d'heure, sinon false.

Notes

Si la chaîne a été correctement convertie en valeur de date/d'heure, la valeur de cet objet d' COleDateTime est affectée à cette valeur et son état à valide.

[!REMARQUE]

Les années doit reposer entre 100 et 9999, inclusivement.

Le paramètre d' lpszDate peut prendre plusieurs formats.Par exemple, les chaînes suivantes contiennent des formats acceptables de date/heure :

"25 January 1996"

"8:30:00"

"20:30:00"

"January 25, 1996 8:30:00"

"8:30:00 Jan. 25, 1996"

"1/25/1996 8:30:00" // always specify the full year,

// even in a 'short date' format

Notez que l'ID de paramètres régionaux l'affecte également si le format de chaîne est acceptable pour la conversion en valeur de date/d'heure.

Dans le cas de VAR_DATEVALUEONLY, la valeur d'heure est définie pour chronométrer 0, ou minuit.Dans le cas de VAR_TIMEVALUEONLY, la valeur de date est définie jusqu'à présent 0, c'est-à-dire le 30 décembre 1899.

Si la chaîne ne peut pas être convertie en valeur de date/d'heure ou s'il y avait un dépassement numérique, l'état de cet objet d' COleDateTime est incorrect.

Pour plus d'informations sur les limites et l'implémentation des valeurs d' COleDateTime , consultez l'article date et heure : Prise en charge d'automation.