DateTimePicker.CustomFormat Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Źródło:

DateTimePicker.cs

Pobiera lub ustawia niestandardowy ciąg formatu daty/godziny.

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

Wartość właściwości

String

Ciąg reprezentujący niestandardowy format daty/godziny. Wartość domyślna to null.

Przykłady

Poniższy przykład kodu ustawia CustomFormat właściwość tak, aby DateTimePicker wyświetlała datę "01 czerwca 2001 r. — piątek". W tym kodzie przyjęto założenie, że wystąpienie kontrolki DateTimePicker zostało utworzone w obiekcie 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

Uwagi

Aby wyświetlić literały ciągów, które zawierają separatory daty i godziny lub w celu formatowania ciągów, należy użyć znaków ucieczki w podciąg. Na przykład, aby wyświetlić datę jako "15 czerwca o 12:00 pm", ustaw CustomFormat właściwość na "MMMM dd 'at' t:mm tt". Jeśli podciąg "at" nie jest ujęty przez znaki ucieczki, wynik to "15 czerwca aP 12:00PM", ponieważ znak "t" jest odczytywany jako jednoliterowy ciąg formatu A.M./P.M. (zobacz tabelę ciągów formatu poniżej).

Ciągi formatu można łączyć w celu formatowania daty i godziny. Na przykład, aby wyświetlić datę i godzinę jako 06/15/2001 12:00 PM, ta właściwość powinna być ustawiona na "MM'/'dd'/'yyy hh':'mm tt". Aby uzyskać więcej informacji, zobacz Niestandardowe ciągi formatu daty i godziny.

Uwaga / Notatka

Właściwość musi być ustawiona Format na DateTimePickerFormat.Custom wartość , aby ta właściwość wpływała na formatowanie wyświetlanej daty i godziny.

W poniższej tabeli wymieniono wszystkie prawidłowe ciągi formatu i ich opisy.

Formatowanie ciągu	Opis
d	Jeden lub dwucyfrowy dzień.
dd	Dwucyfrowy dzień. Wartości dnia jednocyfrowego są poprzedzone wartością 0.
Ddd	Trzyznaczny skrót dnia tygodnia.
dddd	Pełna nazwa dnia tygodnia.
h	Godzina jedno- lub dwucyfrowa w formacie 12-godzinnym.
hh	Dwucyfrowa godzina w formacie 12-godzinnym. Wartości z jedną cyfrą są poprzedzone wartością 0.
H	Godzina jedno- lub dwucyfrowa w formacie 24-godzinnym.
HH	Dwucyfrowa godzina w formacie 24-godzinnym. Wartości z jedną cyfrą są poprzedzone wartością 0.
m	Jedna lub dwie cyfry minuty.
mm	Dwucyfrowa minuta. Wartości z jedną cyfrą są poprzedzone wartością 0.
M	Jeden lub dwucyfrowy numer miesiąca.
MM	Dwucyfrowy numer miesiąca. Wartości z jedną cyfrą są poprzedzone wartością 0.
MMM	Trzyznaczny skrót miesiąca.
MMMM	Pełna nazwa miesiąca.
s	Jedna lub dwie cyfry sekund.
ss	Dwie cyfry sekund. Wartości z jedną cyfrą są poprzedzone wartością 0.
t	Jednoliterowy skrót A.M./P.M. (A.M. jest wyświetlany jako "A").
TT	Dwuliterowy skrót A.M./P.M. (A.M. jest wyświetlany jako "AM").
y	Rok jednocyfrowy (2001 jest wyświetlany jako "1").
yy	Ostatnie dwie cyfry roku (2001 są wyświetlane jako "01").
yyyy	Pełny rok (rok 2001 jest wyświetlany jako "2001").

Zobacz też

• DateTimePickerFormat
• Format