DateTimePicker.CustomFormat Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur string format tanggal/waktu kustom.
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
Nilai Properti
String yang mewakili format tanggal/waktu kustom. Defaultnya adalah null.
Contoh
Contoh kode berikut mengatur CustomFormat properti sehingga DateTimePicker akan menampilkan tanggal sebagai "01 Juni 2001 - Jumat". Kode ini mengasumsikan bahwa instans DateTimePicker kontrol telah dibuat pada 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
Keterangan
Untuk menampilkan literal string yang berisi pemisah tanggal dan waktu atau untuk memformat string, Anda harus menggunakan karakter escape di substring. Misalnya, untuk menampilkan tanggal sebagai "15 Juni pukul 12:00", atur CustomFormat properti ke "MMMM dd 'at' t:mm tt". Jika substring "at" tidak diapit oleh karakter escape, hasilnya adalah "15 Juni aP 12:00PM" karena karakter "t" dibaca sebagai string format A.M./P.M. satu huruf (lihat tabel string format di bawah).
String format dapat digabungkan untuk memformat tanggal dan waktu. Misalnya, untuk menampilkan tanggal dan waktu sebagai 15/06/2001 23:00, properti ini harus diatur ke "MM'/'dd'/'yyyy hh':'mm tt". Untuk informasi selengkapnya, lihat String Format Tanggal dan Waktu Kustom.
Nota
Properti Format harus diatur ke DateTimePickerFormat.Custom untuk properti ini agar memengaruhi pemformatan tanggal dan waktu yang ditampilkan.
Tabel berikut mencantumkan semua string format yang valid dan deskripsinya.
| Format string | Deskripsi |
|---|---|
| d | Hari satu atau dua digit. |
| dd | Hari dua digit. Nilai hari satu digit didahului oleh 0. |
| Ddd | Singkatan hari dalam seminggu tiga karakter. |
| dddd | Nama sehari penuh dalam seminggu. |
| h | Jam satu atau dua digit dalam format 12 jam. |
| hh | Jam dua digit dalam format 12 jam. Nilai digit tunggal didahului oleh 0. |
| H | Satu atau dua digit jam dalam format 24 jam. |
| HH | Jam dua digit dalam format 24 jam. Nilai digit tunggal didahului oleh 0. |
| m | Satu atau dua digit menit. |
| mm | Dua digit menit. Nilai digit tunggal didahului oleh 0. |
| M | Nomor bulan satu atau dua digit. |
| MM (milimeter) | Nomor bulan dua digit. Nilai digit tunggal didahului oleh 0. |
| MMM | Singkatan bulan tiga karakter. |
| MMMM | Nama bulan penuh. |
| s | Satu atau dua digit detik. |
| ss | Dua digit detik. Nilai digit tunggal didahului oleh 0. |
| t | Singkatan satu huruf A.M./P.M. (A.M. ditampilkan sebagai "A"). |
| tt | Singkatan dua huruf A.M./P.M. (A.M. ditampilkan sebagai "AM"). |
| y | Tahun satu digit (2001 ditampilkan sebagai "1"). |
| yy | Dua digit terakhir tahun ini (2001 ditampilkan sebagai "01"). |
| yyyy | Tahun penuh (2001 ditampilkan sebagai "2001"). |