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

Определение

Пространство имен:

Microsoft.VisualBasic

Сборка:

Microsoft.VisualBasic.Core.dll

Исходный код:

Strings.vb

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

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.

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

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

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

• Format(Object, String)
• FormatCurrency(Object, Int32, TriState, TriState, TriState)
• FormatNumber(Object, Int32, TriState, TriState, TriState)
• FormatPercent(Object, Int32, TriState, TriState, TriState)
• ArgumentException
• DatePart(DateInterval, DateTime, FirstDayOfWeek, FirstWeekOfYear)
• Сводка по работе со строками