TimePicker.Time 属性

定义

命名空间:

Windows.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 和 SelectedTime/SelectedTimeChanged 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” 以明确任何值 0 到 9。 例如，“9：5”和“09：05”均有效且表示同一时间，但“09：05”在标记中更易于阅读。

若要在代码中设置时间，可以使用不同的方法，具体取决于编程语言。 该值表示为适用于 C# 和 Visual Basic 的 System.TimeSpan ，或适用于 Visual C++ 组件扩展的 Windows.Foundation.TimeSpan (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 事件。

早期版本的说明

在 Windows 10 版本 1809 (SDK 17763) 中引入 SelectedTime 属性之前的版本中，的Time默认值是应用运行或加载该特定对象时 TimePicker 对象实例化的时间。