Прочитать на английском

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


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

Определение

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

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

Параметры

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-часовом формате (чч:мм).

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

Продукт Версии
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

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