DateAndTime.DateValue(String) Metodo

Definizione

Spazio dei nomi:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

DateAndTime.vb

Restituisce un valore Date contenente le informazioni sulla data rappresentate da una stringa e le informazioni sull'ora impostate sulla mezzanotte (00:00:00).

public:
 static DateTime DateValue(System::String ^ StringDate);

public static DateTime DateValue (string StringDate);

static member DateValue : string -> DateTime

Public Function DateValue (StringDate As String) As DateTime

Parametri

StringDate

String

Obbligatorio. Espressione String che rappresenta un valore di data/ora compreso tra le ore 00:00:00 del primo gennaio dell'anno 1 e le ore 23:59:59 del 31 dicembre 9999.

Restituisce

DateTime

Valore Date contenente le informazioni sulla data rappresentate da una stringa, con le informazioni sull'ora impostate sulla mezzanotte (00:00:00).

Eccezioni

InvalidCastException

StringDate include informazioni sull'ora non valide.

Esempio

In questo esempio viene usata la DateValue funzione per convertire una stringa in una data. È anche possibile usare valori letterali di data per assegnare direttamente una data a una Object o Date variabile, ad esempio oldDate = #2/12/69#.

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

Commenti

Se StringDate include solo numeri da 1 a 12 separati da separatori di data validi, DateValue riconosce l'ordine per mese, giorno e anno in base al formato Data breve specificato per il sistema. DateValueusa l'impostazione del CultureInfo calendario corrente dalla CurrentCulture proprietà della classe nello System.Globalization spazio dei nomi. I valori predefiniti CurrentCulture sono determinati dalle impostazioni di Pannello di controllo. È possibile eseguire l'override del formato Short Date impostando la ShortDatePattern proprietà della DateTimeFormatInfo classe nello System.Globalization spazio dei nomi.

DateValue riconosce i nomi dei mesi in forma lunga, abbreviata e numerica. Ad esempio, oltre a riconoscere 12/30/1991 e 12/30/91, DateValue riconosce anche il 30 dicembre 1991 e il 30 dicembre 1991.

Se la parte dell'anno di StringDate viene omessa, DateValue usa l'anno corrente dalla data di sistema del computer.

Se l'argomento StringDate include informazioni sul tempo, DateValue non lo include nel valore restituito. Tuttavia, se StringDate include informazioni sull'ora non valide, ad esempio "89:98", si verifica un InvalidCastException errore.

Vedi anche

• DateSerial(Int32, Int32, Int32)
• Day(DateTime)
• Month(DateTime)
• Now
• TimeSerial(Int32, Int32, Int32)
• TimeValue(String)
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• DateTime
• Riepilogo dei tipi di dati (Visual Basic)