TimePicker.Time Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls

Ruft die aktuell in der Zeitauswahl festgelegte Zeit ab oder legt diese fest.

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

Eigenschaftswert

TimeSpan TimeSpan

Die aktuell in der Zeitauswahl festgelegte Zeit.

Beispiele

Hier wird die Time -Eigenschaft verwendet, um die Zeit in der Auswahl mit der aktuellen Zeit zu vergleichen.

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

Hinweise

Das Zeitauswahl-Steuerelement verfügt über Time/timeChanged - und SelectedTime/SelectedTimeChanged-APIs . Der Unterschied zwischen diesen besteht darin, dass Time keine NULL-Werte zulässt, während SelectedTime auf NULL festgelegt werden kann.

Der Wert von SelectedTime wird verwendet, um die Zeitauswahl aufzufüllen, und lautet standardmäßig null. Wenn SelectedTime den Wert null aufweist, wird die Time-Eigenschaft auf eine TimeSpan von 0 festgelegt. Andernfalls wird der Time-Wert mit dem SelectedTime-Wert synchronisiert. Wenn SelectedTime den Wert null aufweist, ist die Auswahl „nicht festgelegt“ und zeigt die Feldnamen anstelle einer Uhrzeit an.

Die Zeit wird nicht in Echtzeit erhöht (wie bei einer Uhr), es sei denn, Sie stellen eine Codebindung für einen Wert bereit, der die aktuelle Zeit während der Ausführung der App nachverfolgt.

Sie können den Uhrzeitwert als Attribut in XAML festlegen. Dies ist wahrscheinlich am einfachsten, wenn Sie bereits das TimePicker-Objekt in XAML deklarieren und keine Bindungen für den Zeitwert verwenden. Verwenden Sie eine Zeichenfolge in der Form Hh:Mm , wobei Hh stunden ist und zwischen 0 und 23 liegen kann, und Mm ist Minuten und kann zwischen 0 und 59 liegen. Ein "0" kann das Anfangszeichen in Hh oder Mm sein und wird in der Regel zur Übersichtlichkeit aller Werte 0 bis 9 eingeschlossen. Beispielsweise sind "9:5" und "09:05" gültig und stellen die gleiche Uhrzeit dar, aber "09:05" ist einfacher im Markup zu lesen.

Um die Zeit im Code festzulegen, stehen Ihnen je nach Programmiersprache verschiedene Techniken zur Verfügung. Der Wert wird als System.TimeSpan für C# und Visual Basic oder Windows.Foundation.TimeSpan für Visual C++-Komponentenerweiterungen (C++/CX) dargestellt. Die wahrscheinlich einfachste Möglichkeit, einen System.TimeSpan-Wert zu erzeugen, der für Time geeignet ist, ist die Verwendung der statischen TimeSpan.Parse-Methode. Verwenden Sie eine Zeichenfolge im Format Hh:Mm (stunden:minuten).

Unabhängig davon, ob sie in Code oder XAML festgelegt ist, verfügt die TimePicker-Klasse über eine Koersionslogik für den Wert, den sie beim Festlegen beibehalten wird. Alle Tageswerte werden ignoriert. Sekundenwerte werden ignoriert (z. B. werden Sekunden über 30 nicht auf die nächste Minute aufgerundet). Sekundenbruchteile werden ignoriert. Werte werden nicht umbrochen (beispielsweise ist ein Wert von "24:00" ungültig.) Der Mindestwert innerhalb von TimeSpan ist eine Zeit von 0 (00:00, Mitternacht), und der Höchstwert ist 23:59. Werte außerhalb des Bereichs lösen Ausnahmen aus, aber abhängig von den Besonderheiten können die Ausnahmen aus der TimeSpan Konstruktion stammen und nicht aus der Validierung und Koersion von Time.

Um den Time Wert in Visual C++-Komponentenerweiterungen (C++/CX) festzulegen, legen Sie das Duration Feld der TimeSpan-Struktur fest. Duration gibt eine Zeit in 100 Nanosekundeneinheiten an; Schreiben Sie Ihre eigene Logik für die Konvertierung in und von Stunden:Minuten-Darstellungen.

Jeder Wert, für Time den Sie im Code oder XAML festgelegt haben, gibt den im -Steuerelement angezeigten Anfangswert an. In der App zur Laufzeit wird dieser Wert in der Regel vom Benutzer im Flyout der Zeitauswahl festgelegt. Die vom Benutzer ausgewählte Zeit wird festgelegt, und das TimeChanged-Ereignis tritt auf, wenn der Benutzer eine Änderung vornimmt und die Häkchenschaltfläche im Flyout der Zeitauswahl drückt, um seine Auswahl zu committen.

Hinweise zu früheren Versionen

In Versionen vor der Einführung der SelectedTime-Eigenschaft in Windows 10, Version 1809 (SDK 17763) ist der Standardwert für Time die Zeit, zu der das TimePicker-Objekt instanziiert wird, wenn die App dieses bestimmte Objekt ausführt oder lädt.