Condividi tramite


Funzione DateValue (Visual Basic)

Aggiornamento: novembre 2007

Restituisce un valore Date contenente le informazioni relative alla data rappresentate da una stringa, con l'ora impostata su mezzanotte (00.00.00).

Public Function DateValue(ByVal StringDate As String) As DateTime

Parametri

  • StringDate
    Obbligatorio. Espressione String che rappresenta un valore di data/ora compreso tra le 00.00.00 dell'1 gennaio dell'anno 1 e le 23.59.59 del 31 dicembre 9999.

Eccezioni

Tipo di eccezione

Numero di errore

Condizione

InvalidCastException

13

StringDate include informazioni sull'ora non valide.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Se StringDate include solo i numeri compresi tra 1 e 12 delimitati da separatori di data validi, DateValue interpreta l'ordine di mese, giorno e anno in base al formato data breve specificato per il sistema in uso. DateValue utilizza le impostazioni correnti del calendario tratte dalla proprietà CurrentCulture della classe CultureInfo nello spazio dei nomi System.Globalization. I valori predefiniti di CurrentCulture vengono determinati dalle impostazioni del Pannello di controllo. Per eseguire l'override del formato data breve, impostare la proprietà ShortDatePattern della classe DateTimeFormatInfo nello spazio dei nomi System.Globalization.

DateValue riconosce i nomi dei mesi nel formato lungo, abbreviato e numerico. Oltre a riconoscere 30/12/1991 e 30/12/91, ad esempio, la funzione DateValue riconosce anche 30 dicembre 1991 e 30 dic 1991.

Se la parte di StringDate relativa all'anno viene omessa, DateValue utilizzerà l'anno corrente in base alla data di sistema.

Se l'argomento StringDate include informazioni sull'ora, queste non faranno parte del valore restituito da DateValue. Tuttavia, se StringDate include informazioni sull'ora non valide, ad esempio "89.98", si verificherà un errore InvalidCastException.

Esempio

Nell'esempio riportato di seguito la funzione DateValue viene utilizzata per convertire una stringa in una data. È inoltre possibile utilizzare valori letterali di data per assegnare direttamente una data a una variabile Object o Date, ad esempio oldDate = #2/12/69#.

Dim oldDate As Date
oldDate = DateValue("February 12, 1969")

Requisiti

Spazio dei nomi: Microsoft.VisualBasic

**Modulo:**DateAndTime

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Vedere anche

Riferimenti

Funzione DateSerial (Visual Basic)

Funzione Day (Visual Basic)

Funzione Month (Visual Basic)

Proprietà Now

Funzione TimeSerial (Visual Basic)

Funzione TimeValue (Visual Basic)

Funzione Weekday (Visual Basic)

Funzione Year (Visual Basic)

Tipo di dati Date (Visual Basic)

DateTime