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". Дополнительные сведения см. в разделе "Строки настраиваемого формата даты и времени".

Note

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

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

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

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

• DateTimePickerFormat
• Format