Udostępnij przez

DateTimePicker.CustomFormat Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

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; }
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 data będzie wyświetlana jako "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ągu zawierające separatory daty i godziny lub w celu formatowania ciągów, należy użyć znaków ucieczki w podciągu. Na przykład, aby wyświetlić datę "15 czerwca o godzinie 12:00", 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 jeden litera A.M./P.M. ciąg formatu (zobacz poniższą tabelę ciągów formatu).

Ciągi formatu można połączyć, aby sformatować datę i godzinę. 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

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.

Ciąg formatu Opis
d Jeden lub dwucyfrowy dzień.
dd Dwucyfrowy dzień. Wartości dnia z jedną cyfrą są poprzedzone wartością 0.
ddd Trzy-znakowy 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 dwucyfrowa minuta.
mm Dwucyfrowa minuta. Wartości z jedną cyfrą są poprzedzone wartością 0.
M Jednocyfrowy numer miesiąca lub dwucyfrowy.
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 Dwucyfrowe sekundy. Wartości z jedną cyfrą są poprzedzone wartością 0.
t Jednoliterowa A.M./P.M. skrót (A.M. jest wyświetlany jako "A").
TT Dwuliterowa A.M./P.M. skrót (A.M. jest wyświetlany jako "AM").
Y Rok jednocyfrowy (rok 2001 jest wyświetlany jako "1").
RR Ostatnie dwie cyfry roku (2001 są wyświetlane jako "01").
yyyy Pełny rok (2001 jest wyświetlany jako "2001").

Dotyczy

Zobacz też