Поделиться через


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

Определение

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

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

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

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

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

Исключения

Параметр 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 года 1) нейтральным значением для даты, а 00:00:00 (полночь) — нейтральным значением времени. При форматировании Date значения в виде строки FormatDateTime даты и времени в результирующую строку не включаются нейтральные значения. Например, если преобразовать #1/1/0001 9:30:00# в строку, результатом будет "9:30:00 AM"; сведения о дате подавляются. Однако сведения о дате по-прежнему присутствуют в исходном Date значении и могут быть восстановлены с помощью таких функций, как DatePart.

Примечание

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

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

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

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

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