TimePicker.Time Properti

Definisi

Ruang nama:

Microsoft.UI.Xaml.Controls

Mendapatkan atau mengatur waktu yang saat ini diatur dalam pemilih waktu.

public:
 property TimeSpan Time { TimeSpan get(); void set(TimeSpan value); };

TimeSpan Time();

void Time(TimeSpan value);

public System.TimeSpan Time { get; set; }

var timeSpan = timePicker.time;
timePicker.time = timeSpan;

Public Property Time As TimeSpan

<TimePicker Time="timeSpanString" />

Nilai Properti

TimeSpan TimeSpan

Waktu yang saat ini diatur dalam pemilih waktu.

Contoh

Di sini, Time properti digunakan untuk membandingkan waktu dalam pemilih dengan waktu saat ini.

<StackPanel>
    <TimePicker x:Name="checkTimePicker"/>
    <Button Content="Check time" Click="{x:Bind CheckTime}"/>
    <TextBlock x:Name="resultText"/>
</StackPanel>

private void CheckTime()
{
    // Using the Time property.
    DateTime myTime = DateTime.Today + checkTimePicker.Time;
    if (DateTime.Now >= myTime)
    {
        resultText.Text = "Your selected time has already past.";
    }
    else
    {
        string hrs = (myTime - DateTime.Now).Hours.ToString();
        string mins = (myTime - DateTime.Now).Minutes.ToString();
        resultText.Text = string.Format("Your selected time is {0} hours, {1} minutes from now.", hrs, mins);
    }
}

Keterangan

Kontrol pemilih waktu memiliki Time/ API TimeChanged dan SelectedTime/SelectedTimeChanged. Perbedaan antara ini adalah yang Time tidak dapat diubah ke null, sementara SelectedTime dapat diubah ke null.

Nilai digunakan SelectedTime untuk mengisi pemilih waktu dan secara null default. Jika SelectedTime adalah null, Time properti diatur ke TimeSpan 0; jika tidak, nilai disinkronkan Time dengan SelectedTime nilai . Ketika SelectedTime adalah null, pemilih 'tidak diatur' dan menampilkan nama bidang alih-alih waktu.

Waktu tidak akan meningkat secara real-time (seperti jam) kecuali Anda memberikan kode yang mengikat ke beberapa nilai yang melacak waktu saat ini saat aplikasi sedang berjalan.

Anda dapat mengatur nilai waktu sebagai atribut di XAML. Ini mungkin paling mudah jika Anda sudah mendeklarasikan objek TimePicker di XAML dan tidak menggunakan pengikatan untuk nilai waktu. Gunakan string dalam bentuk Hh:Mm di mana Hh adalah jam dan dapat antara 0 dan 23 dan Mm adalah menit dan dapat antara 0 dan 59. "0" dapat menjadi karakter awal dalam Hh atau Mm dan biasanya disertakan untuk kejelasan nilai apa pun 0 sampai 9. Misalnya, "9:5" dan "09:05" valid dan mewakili waktu yang sama, tetapi "09:05" lebih mudah dibaca dalam markup.

Untuk mengatur waktu dalam kode, Anda memiliki teknik berbeda yang tersedia tergantung pada bahasa pemrograman Anda. Nilai direpresentasikan sebagai System.TimeSpan untuk C# dan Visual Basic, atau Windows.Foundation.TimeSpan untuk ekstensi komponen Visual C++ (C++/CX). Mungkin cara termampu untuk menghasilkan nilai System.TimeSpan yang sesuai Time adalah dengan menggunakan metode statis TimeSpan.Parse. Gunakan string dalam bentuk Hh:Mm (jam:menit).

Baik diatur dalam kode atau XAML, kelas TimePicker memiliki logika koersi untuk nilai yang dipertahankan saat Anda mencoba mengaturnya. Nilai hari apa pun diabaikan. Nilai detik diabaikan (misalnya detik di atas 30 tidak dibulatkan ke atas ke menit berikutnya). Detik pecahan diabaikan. Nilai tidak dibungkus (misalnya nilai "24:00" tidak valid.) Nilai minimum dalam TimeSpan adalah waktu 0 (00:00, tengah malam) dan nilai maksimum adalah 23:59. Nilai di luar rentang melempar pengecualian, tetapi tergantung pada spesifikasi pengecualian mungkin berasal dari TimeSpan konstruksi daripada dari validasi dan paksaan Time.

Untuk mengatur Time nilai dalam ekstensi komponen Visual C++ (C++/CX), Anda mengatur Duration bidang struktur TimeSpan . Duration menentukan waktu dalam 100 unit nanodetik; tulis logika Anda sendiri untuk mengonversi ke dan dari jam:menit representasi.

Nilai apa pun yang Anda tetapkan dalam Time kode atau XAML menentukan nilai awal yang ditampilkan dalam kontrol. Di aplikasi pada runtime yang nilainya biasanya diatur oleh pengguna di flyout pemilih waktu. Waktu yang dipilih oleh pengguna diatur dan peristiwa TimeChanged terjadi saat pengguna membuat perubahan dan menekan tombol tanda centang di flyout pemilih waktu untuk menerapkan pilihan mereka.

Lihat juga

• TimeChanged
• SelectedTime
• SelectedTimeChanged