Strings.FormatDateTime(DateTime, DateFormat) Metoda

Definicja

Przestrzeń nazw:
Microsoft.VisualBasic
Zestaw:
Microsoft.VisualBasic.dll

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

To jest wymagane. Date wyrażenie do sformatowania.

NamedFormat
DateFormat

Optional. Wartość liczbowa wskazująca używany format daty/godziny. Jeśli pominięto, 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 Visual Basic uważa, że 1/1/1 (1 stycznia roku 1) jest neutralną wartością daty i 00:00:00 (północ) jako neutralną wartością czasu. Jeśli formatujesz Date wartość jako ciąg daty/godziny, FormatDateTime wartości neutralne nie są uwzględniane w wynikowym ciągu. Jeśli na przykład przekonwertujesz plik #1/1/0001 9:30:00# na ciąg, wynik to "9:30:00 AM"; 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.

Note

Jeśli argument zostanie przekazany Expression jako String literał, FormatDateTime zinterpretuje go zgodnie z CurrentCulture ustawieniem aplikacji. Jeśli jednak przekazujesz 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 następnie 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świetlanie daty i/lub godziny. Wyświetlanie części daty jako daty krótkiej. Jeśli istnieje część czasu, wyświetl ją jako długi czas. W przypadku obecności obie części są wyświetlane.
DateFormat.LongDate Wyświetlanie daty przy użyciu formatu daty długiej określonego w ustawieniach regionalnych komputera.
DateFormat.ShortDate Wyświetlanie daty przy użyciu formatu daty krótkiej określonego w ustawieniach regionalnych komputera.
DateFormat.LongTime Wyświetlanie godziny przy użyciu formatu czasu określonego w ustawieniach regionalnych komputera.
DateFormat.ShortTime Wyświetlanie godziny w formacie 24-godzinnym (gg:mm).

Dotyczy

Zobacz też