TimePicker.Time 属性

定义

命名空间:

Microsoft.UI.Xaml.Controls

获取或设置时间选取器中当前设置的时间。

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

属性值

TimeSpan TimeSpan

时间选取器中当前设置的时间。

示例

此处， 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/具有 TimeChanged 和 SelectedTimeSelectedTimeChanged/ API。 这两者的区别是，Time 不可为 null，而 SelectedTime 可以为 null。

SelectedTime 的值用于填充时间选取器，它默认为 null。 如果 SelectedTime 是 null，则 Time 属性设置为 TimeSpan 0；否则，Time 值与 SelectedTime 值同步。 当 SelectedTime 是 null时，不设置选取器，它显示字段名称而不是时间。

时间不会在实时 (递增，就像时钟会) 一样，除非你提供一个代码绑定，用于在应用运行时跟踪当前时间。

可在 XAML 中将时间值设置为特性。 如果已在 XAML 中声明 TimePicker 对象，并且未将绑定用于时间值，则这可能是最简单的方法。 使用 Hh：Mm 格式的字符串，其中 Hh 是小时，可以是 0 到 23，Mm 是分钟，并且可以介于 0 到 59 之间。 “0”可以是 Hh 或 Mm 中的初始字符，为了清楚了解从 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静态方法。 使用 Hh：Mm (小时：分钟) 形式的字符串。

无论是在代码中设置还是 XAML 中设置， TimePicker 类都具有强制逻辑，用于在尝试设置时保留的值。 忽略任何天数值。 忽略秒值 (例如，超过 30 秒的秒不会向上舍入到下一分钟) 。 忽略秒小数。 值不会环绕 (例如值“24：00”无效。) 中的 TimeSpan 最小值为 0 (00：00，午夜) ，最大值为 23：59。 超出范围的值会引发异常，但根据具体情况，异常可能源自 构造， TimeSpan 而不是来自 的验证和强制 Time。

若要在 Visual C++ 组件扩展 (C++/CX) 中设置 Time 值，请设置 DurationTimeSpan 结构的 字段。 Duration 指定以 100 纳秒为单位的时间;编写自己的逻辑，用于转换小时：分钟表示形式和从小时：分钟表示形式。

在代码或 XAML 中为 Time 设置的任何值都指定在 控件中显示的初始值。 在运行时的应用中，该值通常由用户在时间选取器浮出控件中设置。 设置用户选择的时间，当用户进行更改并按时间选取器浮出控件中的检查标记按钮提交其选择时，将发生 TimeChanged 事件。

另请参阅

• TimeChanged
• SelectedTime
• SelectedTimeChanged