Strings.FormatDateTime(DateTime, DateFormat) Метод

Определение

Пространство имен:
Microsoft.VisualBasic
Сборка:
Microsoft.VisualBasic.dll

Возвращает строковое выражение, представляющее значение даты и времени.

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

Параметры

Expression
DateTime

Обязательно. Date выражение для форматирования.

NamedFormat
DateFormat

Optional. Числовое значение, указывающее формат даты и времени. Если опущено, DateFormat.GeneralDate используется.

Возвращаемое значение

String

Строковое выражение, представляющее значение даты и времени.

Исключения

ArgumentException

NamedFormat Параметр недопустим.

Примеры

В этом примере показано использование FormatDateTime функции.

' 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)

Комментарии

Тип Date данных всегда содержит сведения о дате и времени. Для преобразования типов Visual Basic считает 1/1/1 (1 января 1 года 1) нейтральным значением для даты, а 00:00:00 (полночь) — нейтральным значением для времени. Если значение форматируются Date как строка даты и времени, FormatDateTime в результирующую строку не включаются нейтральные значения. Например, если вы преобразуете #1/1/0001 9:30:00# в строку, результатом является "9:30:00 AM"; Сведения о дате подавляются. Однако сведения о дате по-прежнему присутствуют в исходном Date значении и могут быть восстановлены с помощью таких функций, как DatePart.

Note

Если аргумент передается Expression в виде литерала, FormatDateTime он интерпретируется в соответствии с параметром StringCurrentCulture приложения. Однако если вы передаете его как Date литерал, используйте формат #mm/dd/гггг#, так как FormatDateTime всегда интерпретирует Date литерал в соответствии с языком языка и региональных параметров английского языка (США). Это необходимо, так как если приложение разрабатывается и закодировано с помощью Date литералов из одного языка и региональных параметров, но затем выполняется на платформе с другим языком и региональными параметрами, Date литералы могут быть проанализированы неправильно.

Аргумент NamedFormat имеет следующие параметры.

Константа Description
DateFormat.GeneralDate Отображение даты или времени. Отображение части даты в виде короткой даты. Если имеется часть времени, она отображается в полном формате. При наличии оба элемента отображаются.
DateFormat.LongDate Отображает дату, используя полный формат, заданный в региональных параметрах компьютера.
DateFormat.ShortDate Отображает дату, используя краткий формат, заданный в региональных параметрах компьютера.
DateFormat.LongTime Отображает время, используя формат, заданный в региональных параметрах компьютера.
DateFormat.ShortTime Отображает время, используя 24-часовой формат (чч:мм).

Применяется к

См. также раздел