DateAndTime.DateValue(String) Metod

Definition

Returnerar ett Date värde som innehåller datuminformationen som representeras av en sträng, med tidsinformationen inställd på midnatt (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

Parametrar

StringDate
String

Required. stränguttryck som representerar ett datum/tid-värde från 00:00:00 den 1 januari i år 1 till 23:59:59 den 31 december 9999.

Returer

Ett Date värde som innehåller datuminformationen som representeras av en sträng, med tidsinformationen inställd på midnatt (00:00:00).

Undantag

StringDate innehåller ogiltig tidsinformation.

Exempel

I det DateValue här exemplet används funktionen för att konvertera en sträng till ett datum. Du kan också använda datumliteraler för att direkt tilldela ett datum till en Object eller Date en variabel, till exempel oldDate = #2/12/69#.

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

Kommentarer

Om StringDate endast innehåller tal från 1 till 12 avgränsade med giltiga datumavgränsare, DateValue identifierar ordern för månad, dag och år enligt det kort datumformat som angetts för systemet. DateValue använder den aktuella kalenderinställningen CurrentCulture från -egenskapen för CultureInfo klassen i System.Globalization namnområdet. Standardvärdena CurrentCulture bestäms av inställningarna ovládací panel. Du kan åsidosätta formatet Kort datum genom att ange ShortDatePattern egenskapen för DateTimeFormatInfo klassen i System.Globalization namnområdet.

DateValue identifierar månadsnamn i långt, förkortat och numeriskt format. Förutom att känna igen 12/30/1991 och 12/30/91, DateValue identifieras även 30 december 1991 och 30 dec 1991.

Om årdelen av StringDate utelämnas DateValue använder du det aktuella året från datorns systemdatum.

Om argumentet StringDate innehåller tidsinformation DateValue inkluderar det inte i det returnerade värdet. Men om StringDate innehåller ogiltig tidsinformation, till exempel "89:98", uppstår ett InvalidCastException fel.

Gäller för

Se även