Strings.FormatDateTime(DateTime, DateFormat) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.VisualBasic

Zestaw:: Microsoft.VisualBasic.Core.dll

Zestaw:: Microsoft.VisualBasic.dll

Źródło:: Strings.vb

Źródło:: Strings.vb

Źródło:: Strings.vb

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zwraca wyrażenie ciągu reprezentujące wartość daty/godziny.

public static string FormatDateTime (DateTime Expression, Microsoft.VisualBasic.DateFormat NamedFormat = Microsoft.VisualBasic.DateFormat.GeneralDate);

static member FormatDateTime : DateTime * Microsoft.VisualBasic.DateFormat -> string

Public Function FormatDateTime (Expression As DateTime, Optional NamedFormat As DateFormat = Microsoft.VisualBasic.DateFormat.GeneralDate) As String

Parametry

Expression: DateTime

Wymagane. Date wyrażenie do sformatowania.

NamedFormat: DateFormat

Opcjonalny. Wartość liczbowa wskazująca używany format daty/godziny. W przypadku pominięcia DateFormat.GeneralDate jest używany.

Zwraca

String

Wyrażenie ciągu reprezentujące wartość daty/godziny.

Wyjątki

ArgumentException

NamedFormat ustawienie jest nieprawidłowe.

Przykłady

W tym przykładzie pokazano użycie FormatDateTime funkcji .

' English (US) format.
Dim testDate As DateTime = #3/12/1999#

' FormatDateTime returns "Friday, March 12, 1999".
' The time information is neutral (00:00:00) and therefore suppressed.
Dim testString As String = FormatDateTime(testDate, DateFormat.LongDate)

Uwagi

Typ Date danych zawsze zawiera informacje o dacie i godzinie. Na potrzeby konwersji typu język Visual Basic uznaje wartość 1/1/1 (1 stycznia roku 1) za neutralną wartość daty, a wartość 00:00:00 (północ) jako neutralną wartość czasu. W przypadku formatowania Date wartości jako ciągu FormatDateTime daty/godziny nie uwzględnia wartości neutralnych w wynikowym ciągu. Jeśli na przykład przekonwertujesz ciąg #1/1/0001 9:30:00#, wynikiem jest "9:30:00"; informacje o dacie są pomijane. Jednak informacje o dacie są nadal obecne w oryginalnej Date wartości i można je odzyskać za pomocą funkcji takich jak DatePart.

Uwaga

Jeśli argument zostanie przekazany Expression jako String literał, FormatDateTime zinterpretuje go zgodnie z CurrentCulture ustawieniem aplikacji. Jeśli jednak przekażesz go jako Date literał, użyj formatu #mm/dd/yyyy#, ponieważ FormatDateTime zawsze interpretuje literał zgodnie z kulturą Date języka angielskiego (USA). Jest to konieczne, ponieważ jeśli aplikacja jest opracowywana i kodowana przy użyciu Date literałów z jednej kultury, ale jest wykonywana na platformie z inną kulturą, Date literały mogą być analizowane niepoprawnie.

Argument NamedFormat ma następujące ustawienia.

Stała	Opis
`DateFormat.GeneralDate`	Wyświetl datę i/lub godzinę. Wyświetl część daty jako datę krótką. Jeśli istnieje część czasowa, wyświetl ją jako długi czas. Jeśli są obecne, obie części są wyświetlane.
`DateFormat.LongDate`	Wyświetl datę przy użyciu formatu daty długiej określonego w ustawieniach regionalnych komputera.
`DateFormat.ShortDate`	Wyświetl datę przy użyciu formatu daty krótkiej określonego w ustawieniach regionalnych komputera.
`DateFormat.LongTime`	Wyświetl czas przy użyciu formatu czasu określonego w ustawieniach regionalnych komputera.
`DateFormat.ShortTime`	Wyświetl godzinę przy użyciu formatu 24-godzinnego (hh:mm).

Dotyczy

Udostępnij za pośrednictwem