DateTimePicker.CustomFormat Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

DateTimePicker.cs

Získá nebo nastaví vlastní řetězec formátu data a času.

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

Hodnota vlastnosti

String

Řetězec, který představuje vlastní formát data a času. Výchozí hodnota je null.

Příklady

Následující příklad kódu nastaví CustomFormat vlastnost tak, aby DateTimePicker se datum zobrazilo jako "01. června 2001 – pátek". Tento kód předpokládá, že instance DateTimePicker ovládacího prvku byla vytvořena v objektu 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

Poznámky

Chcete-li zobrazit řetězcové literály obsahující oddělovače data a času nebo formátovat řetězce, musíte v podřetězci použít řídicí znaky. Pokud chcete například zobrazit datum jako "Červen 15 v 12:00 PM", nastavte CustomFormat vlastnost na "MMMM dd 'at' t:mm tt". Pokud podřetězce "at" není uzavřeno řídicími znaky, výsledkem je "15. června aP 12:00PM", protože znak "t" je přečten jako řetězec formátu 1 písmena A.M./P.M. (viz tabulka formátovací řetězec níže).

Formátovací řetězce lze zkombinovat a formátovat datum a čas. Pokud chcete například zobrazit datum a čas jako 15. 6. 2001 12:00, měla by být tato vlastnost nastavená na "MM'/'dd'/'y hh':'mm tt". Další informace naleznete v tématu Vlastní řetězce formátu data a času.

Poznámka:

Vlastnost Format musí být nastavena tak, aby DateTimePickerFormat.Custom tato vlastnost ovlivnila formátování zobrazeného data a času.

V následující tabulce jsou uvedeny všechny platné řetězce formátu a jejich popisy.

Formát řetězce	Description
d	Jeden nebo dvouciferný den.
dd	Dvouciferný den. Jednociferné hodnoty dne předchází 0.
ddd	Tříznaková zkratka dne v týdnu.
dddd	Celý den v týdnu.
h	Jednociferná nebo dvouciferná hodina ve formátu 12 hodin.
hh	Dvouciferná hodina ve formátu 12 hodin. Jednociferné hodnoty předchází 0.
H	Jednociferná nebo dvouciferná hodina ve formátu 24 hodin.
HH	Dvouciferná hodina ve formátu 24 hodin. Jednociferné hodnoty předchází 0.
m	Jednociferná nebo dvouciferná minuta.
milimetr	Dvouciferná minuta. Jednociferné hodnoty předchází 0.
M	Jednociferné nebo dvouciferné číslo měsíce.
MILIMETR	Dvouciferné číslo měsíce. Jednociferné hodnoty předchází 0.
MMM	Zkratka měsíce se třemi znaky.
MMMM	Celý název měsíce.
s	Jednociferné nebo dvouciferné sekundy.
ss	Dvouciferné sekundy. Jednociferné hodnoty předchází 0.
t	Zkratka A.M./P.M. (A.M. se zobrazuje jako "A").
TT	Dvoumísmenná zkratka A.M./P.M. (A.M. se zobrazuje jako "AM").
y	Jednociferný rok (2001 se zobrazí jako "1").
yy	Poslední dvě číslice roku (2001 se zobrazí jako 01).
yyyy	Celý rok (2001 se zobrazuje jako "2001").

Viz také

• DateTimePickerFormat
• Format