DateTimePicker.CustomFormat Свойство

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

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./P.M. (см. таблицу строк формата ниже).

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

Примечание

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

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

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

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

• DateTimePickerFormat
• Format