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

Ссылка

Определение

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

Сборка:: Microsoft.VisualBasic.Core.dll

Сборка:: Microsoft.VisualBasic.dll

Исходный код:: Strings.vb

Исходный код:: Strings.vb

Исходный код:: 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-часовом формате (чч:мм).

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

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