DateTimePicker.CustomFormat Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

DateTimePicker.cs

Возвращает или задает строку настраиваемого формата даты и времени.

public:
 property System::String ^ CustomFormat { System::String ^ get(); void set(System::String ^ value); };

public string? CustomFormat { get; set; }

member this.CustomFormat : string with get, set

Public Property CustomFormat As String

Значение свойства

String

Строка, представляющая пользовательский формат даты и времени. Значение по умолчанию — null.

Примеры

В следующем примере кода задается CustomFormat свойство, чтобы DateTimePicker дата отображалось как "01 июня 2001 г. - пятница". В этом коде предполагается, что экземпляр DateTimePicker элемента управления был создан на объекте Form.

public:
   void SetMyCustomFormat()
   {
      // Set the Format type and the CustomFormat string.
      dateTimePicker1->Format = DateTimePickerFormat::Custom;
      dateTimePicker1->CustomFormat = "MMMM dd, yyyy - dddd";
   }

public void SetMyCustomFormat()
{
   // Set the Format type and the CustomFormat string.
   dateTimePicker1.Format = DateTimePickerFormat.Custom;
   dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd";
}

Public Sub SetMyCustomFormat()
    ' Set the Format type and the CustomFormat string.
    dateTimePicker1.Format = DateTimePickerFormat.Custom
    dateTimePicker1.CustomFormat = "MMMM dd, yyyy - dddd"
End Sub

Комментарии

Чтобы отобразить строковые литералы, содержащие разделители даты и времени или форматирования строк, необходимо использовать escape-символы в подстроке. Например, чтобы отобразить дату как "15 июня в 12:00", задайте CustomFormat для свойства значение MMMM dd "at"t:mm tt". Если подстрока "at" не заключена в escape-символы, результатом является "15 июня 12:00PM", так как символ "t" считывается как строка формата A.M.M./P.M. (см. таблицу строк формата ниже).

Строки формата можно объединить для форматирования даты и времени. Например, чтобы отобразить дату и время как 06.15.2001 12:00, это свойство должно иметь значение MM'/'dd'/'yyy hh':'mm tt". Дополнительные сведения см. в разделе "Строки настраиваемого формата даты и времени".

Замечание

Для Format этого свойства необходимо задать DateTimePickerFormat.Custom значение, чтобы повлиять на форматирование отображаемой даты и времени.

В следующей таблице перечислены все допустимые строки формата и их описания.

Форматная строка	Описание
d	Одно-или двухзначный день.
dd	Двухзначный день. Однозначные значения дня предшествуют 0.
ddd	Трехзначное сокращение дня недели.
dddd	Полное имя недели.
ч	Одно-или двухзначный час в формате 12-часового формата.
hh	Двухзначный час в формате 12-часового формата. Однозначные значения предшествуют 0.
H	Один или двухзначный час в 24-часовом формате.
ЧЧ	Двухзначный час в 24-часовом формате. Однозначные значения предшествуют 0.
m	Одна или две цифры минуты.
мм	Двухзначная минута. Однозначные значения предшествуют 0.
M	Номер одного или двухзначного месяца.
мм	Двухзначный номер месяца. Однозначные значения предшествуют 0.
МММ	Трехзначное сокращение месяца.
ММММ	Полное имя месяца.
s	Одно-или двухзначные секунды.
ss	Двухзначные секунды. Однозначные значения предшествуют 0.
т	Однобуквенное сокращение A.M./P.M. (A.M. отображается как "A").
tt	Двухбуквенное сокращение A.M./P.M. (A.M. отображается как "AM").
и	Однозначный год (2001 год отображается как "1").
yy	Последние две цифры года (2001 год отображается как "01").
yyyy	Полный год (2001 год отображается как "2001").

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

• DateTimePickerFormat
• Format