COleDateTime::ParseDateTime

Articolo
03/05/2013

Analizza una stringa per leggere un valore data/ora.

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

Parametri

lpszDate
Un puntatore alla stringa con terminazione null che deve essere analizzata.Per informazioni dettagliate, vedere i commenti.
dwFlags
Specifica i flag per le impostazioni locali e l'analisi.Uno o più dei seguenti flag:
- Utilizzo diLOCALE_NOUSEROVERRIDE le impostazioni locali predefinite di sistema, anziché le impostazioni utente personalizzate.
- VAR_TIMEVALUEONLY ignora la parte relativa alla data durante l'analisi.
- VAR_DATEVALUEONLY ignora la porzione di tempo durante l'analisi.
lcid
Indica l'id delle impostazioni locali da utilizzare per la conversione.

Valore restituito

Restituisce true se la stringa corretta è stata convertita in un valore data/ora in caso contrario, false.

Note

Se la stringa corretta è stata convertita in un valore data/ora, il valore di questo oggetto COleDateTime viene impostato il valore e nello stato a valido.

[!NOTA]

I valori dell'anno deve rientrare tra 100 e 9999, nel suo complesso.

Il parametro lpszDate può accettare diversi formati.Ad esempio, le stringhe seguenti contengono anche la data/ora formati:

"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

Si noti che l'id impostazioni locali anche su se il formato della stringa è accettabile di conversione a un valore data/ora.

Nel caso VAR_DATEVALUEONLY, il valore viene impostato per spostarsi 0, oppure la mezzanotte.Nel caso VAR_TIMEVALUEONLY, il valore della data viene impostato fino a quel momento 0, per il 30 dicembre 1899.

Se la stringa non può essere convertita in un valore data/ora o se fosse un overflow numerico, lo stato di questo oggetto COleDateTime non è valido.

Per ulteriori informazioni sui limiti e sull'implementazione per i valori COleDateTime, vedere l'articolo data e ora: supporto di automazione.