DateTimePicker.CustomFormat Vlastnost

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

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; }
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í formát 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 na 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ězdce "at" není uzavřen řídicími znaky, výsledek je "15. června aP 12:00PM", protože znak "t" je přečten jako jednopísmenné písmeno A.M./P.M.M. M. formátovací řetězec (viz tabulka řetězců formátu níže).

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

Poznámka

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

Následující tabulka uvádí všechny platné řetězce formátu a jejich popisy.

Formátovací řetězec 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á hodina ve formátu 12 hodin.
hh Dvouciferná hodina ve formátu 12 hodin. Hodnoty s jednou číslicí předchází 0.
H Jednociferná hodina ve formátu 24 hodin.
HH Dvouciferná hodina ve formátu 24 hodin. Hodnoty s jednou číslicí předchází 0.
m Jedna nebo dvoumístná minuta.
mm Dvouciferná minuta. Hodnoty s jednou číslicí předchází 0.
M Jednociferné číslo měsíce.
MM Dvouciferné číslo měsíce. Hodnoty s jednou číslicí předchází 0.
MMM Zkratka měsíce se třemi znaky.
MMMM Celé jméno měsíce.
s Jednociferné nebo dvoumístné sekundy.
ss Dvoumístné sekundy. Hodnoty s jednou číslicí předchází 0.
t Jedno písmeno A.M./P.M. zkratka (A.M. se zobrazí jako "A").
TT Dvoumísmenné písmeno A.M./P.M. zkratka (A.M. se zobrazí jako "AM").
y Jednociferný rok (2001 se zobrazí jako "1").
RR Poslední dvě číslice roku (2001 se zobrazí jako 01).
rrrr Celý rok (2001 se zobrazuje jako "2001").

Platí pro

Viz také