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

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

Zobacz też