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


DateTimePicker.CustomFormat Свойство

Определение

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

public:
 property System::String ^ CustomFormat { System::String ^ get(); void set(System::String ^ value); };
public string CustomFormat { get; set; }
public string? CustomFormat { get; set; }
member this.CustomFormat : string with get, set
Public Property CustomFormat As 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").

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

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