共用方式為


TimePicker.Time 屬性

定義

取得或設定目前在時間選擇器中設定的時間。

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" />

屬性值

目前在時間選擇器中設定的時間。

範例

在這裡, Time 屬性可用來比較選擇器中的時間與目前時間。

時間選擇器、按鈕和文字標籤。

<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);
    }
}

備註

時間選擇器控制項同時 Time/ 具有TimeChangedSelectedTime/SelectedTimeChanged API。 這兩者之間的差異是 Time 不可為 Null,而 SelectedTime 可為 Null。

的值 SelectedTime 是用來填入時間選擇器,預設為 null 。 如果 為 SelectedTimenull ,則 Time 屬性會設定為 0 的 TimeSpanTime 否則值會與 SelectedTime 值同步處理。 當 為 nullSelectedTime ,選擇器為 'unset' 並顯示功能變數名稱,而不是時間。

除非您提供程式碼系結至執行應用程式時追蹤目前時間的某些值,否則時間不會以即時方式遞增 (,例如時鐘會) 。

您可以將時間值設定為 XAML 中的屬性。 如果您已在 XAML 中宣告 TimePicker 物件,而且未針對時間值使用系結,則可能最容易。 使用 HhMm 格式的字串,其中 Hh 為小時,且介於 0 到 23 之間, 且 Mm 為分鐘數,且介於 0 到 59 之間。 「0」 可以是 HhMm 中的初始字元,而且通常會包含 ,以便清楚瞭解任何值 0 到 9。 例如,「9:5」 和 「09:05」 都是有效的,同時代表相同的時間,但 「09:05」 更容易在標記中讀取。

若要在程式碼中設定時間,您可以根據程式設計語言提供不同的技術。 此值以 System.TimeSpan for C# 和 Visual Basic 表示,或 Windows.Foundation.TimeSpan for Visual C++ 元件延伸模組 (C++/CX) 。 產生適合 Time的 System.TimeSpan值可能最簡單的方式是使用TimeSpan.Parse靜態方法。 使用 HhMm (小時:分鐘) 格式的字串。

無論是在程式碼或 XAML 中設定, TimePicker 類別都有它嘗試設定時所保留值的強制邏輯。 任何天數的值都會被忽略。 秒數會忽略 (例如,超過 30 秒的秒數不會進位到下一分鐘) 。 略過小數秒。 值不會包裝 (,例如 「24:00」 的值無效。) 內的 TimeSpan 最小值是 0 (00:00、午夜) ,最大值為 23:59。 超出範圍的值會擲回例外狀況,但視例外狀況的特定情況而定,例外狀況可能源自建構, TimeSpan 而不是來自 的 Time 驗證和強制。

若要在 Visual C++ 元件延伸模組中設定 Time 值, (C++/CX) ,您可以設定 DurationTimeSpan 結構的欄位。 Duration 指定以 100 奈秒為單位的時間;撰寫您自己的邏輯,以轉換到小時:分鐘標記法。

您在程式碼或 XAML 中設定 Time 的任何值,都是指定 控制項中顯示的初始值。 在執行時間的應用程式中,該值通常是由時間選擇器飛出視窗中的使用者所設定。 使用者選取的時間是設定的,而 TimeChanged 事件發生于使用者進行變更時,並按下時間選擇器飛出視窗中的核取記號按鈕來認可其選取範圍。

舊版的注意事項

在 Windows 10 版本 1809 (SDK 17763) 中引進 SelectedTime屬性的版本中, Time 預設值是 App 執行或載入該特定物件時,TimePicker物件具現化的時間。

適用於