System::TimeSpan class

TimeSpan class

Stellt ein Zeitintervall dar. Dieser Typ sollte auf dem Stack alloziert und an Funktionen per Wert oder Referenz übergeben werden. Verwenden Sie niemals die System::SmartPtr Klasse, um Objekte dieses Typs zu verwalten.

class TimeSpan

Methoden

MethodeBeschreibung
Add(TimeSpan) constGibt eine neue Instanz der TimeSpan Klasse zurück, die ein Zeitintervall darstellt, das die Summe der von dem aktuellen und dem angegebenen Objekt dargestellten Zeitintervalle ist.
static Compare(TimeSpan, TimeSpan)Vergleicht zwei TimeSpan-Objekte.
CompareTo(TimeSpan) constVergleicht das aktuelle und das angegebene Objekt.
CompareTo(const SharedPtr<Object>&) constVergleicht das aktuelle und das angegebene Objekt.
Duration() constGibt eine neue Instanz des TimeSpan-Objekts zurück, dessen Wert der absolute Wert des aktuellen Objekts ist.
Equals(TimeSpan) constBestimmt, ob das vom aktuellen Objekt dargestellte Zeitintervall dem vom angegebenen Objekt dargestellten Zeitintervall entspricht.
Equals(const SharedPtr<Object>&) constBestimmt, ob das vom aktuellen Objekt dargestellte Zeitintervall dem vom angegebenen Objekt dargestellten Zeitintervall entspricht.
static Equals(TimeSpan, TimeSpan)Gibt true zurück, wenn die angegebenen Objekte dasselbe Zeitintervall darstellen, andernfalls false.
static FromDays(double)Gibt ein neues TimeSpan-Objekt zurück, das das angegebene Intervall darstellt.
static FromHours(double)Gibt ein neues TimeSpan-Objekt zurück, das das angegebene Intervall darstellt.
static FromMilliseconds(double)Gibt ein neues TimeSpan-Objekt zurück, das das angegebene Intervall darstellt.
static FromMinutes(double)Gibt ein neues TimeSpan-Objekt zurück, das das angegebene Intervall darstellt.
static FromSeconds(double)Gibt ein neues TimeSpan-Objekt zurück, das das angegebene Intervall darstellt.
static FromTicks(int64_t)Gibt ein neues TimeSpan-Objekt zurück, das das angegebene Intervall darstellt.
get_Days() constGibt die Tageskomponente des vom aktuellen TimeSpan-Objekt dargestellten Zeitintervalls zurück.
get_Hours() constGibt die Stundenkomponente des vom aktuellen TimeSpan-Objekt dargestellten Zeitintervalls zurück.
get_Milliseconds() constGibt die Millisekundenkomponente des vom aktuellen TimeSpan-Objekt dargestellten Zeitintervalls zurück.
get_Minutes() constGibt die Minutenkomponente des vom aktuellen TimeSpan-Objekt dargestellten Zeitintervalls zurück.
get_Seconds() constGibt die Sekundenkomponente des vom aktuellen TimeSpan-Objekt dargestellten Zeitintervalls zurück.
get_Ticks() constGibt die Anzahl der 100‑Nanosekunden‑Intervalle zurück, aus denen das vom aktuellen TimeSpan-Objekt dargestellte Zeitintervall besteht.
get_TotalDays() constGibt den Wert des aktuellen TimeSpan-Objekts zurück, ausgedrückt in ganzen und Bruchteil‑Tagen.
get_TotalHours() constGibt den Wert des aktuellen TimeSpan-Objekts zurück, ausgedrückt in ganzen und Bruchteil‑Stunden.
get_TotalMilliseconds() constGibt den Wert des aktuellen TimeSpan-Objekts zurück, ausgedrückt in ganzen und Bruchteil‑Millisekunden.
get_TotalMinutes() constGibt den Wert des aktuellen TimeSpan-Objekts zurück, ausgedrückt in ganzen und Bruchteil‑Minuten.
get_TotalSeconds() constGibt den Wert des aktuellen TimeSpan-Objekts zurück, ausgedrückt in ganzen und Bruchteil‑Sekunden.
GetHashCode() constGibt einen Hashcode für das aktuelle Objekt zurück.
IsNull() const
Negate() constGibt eine neue Instanz des TimeSpan-Objekts zurück, das den negierten Wert des aktuellen TimeSpan-Objekts darstellt.
operator!=(TimeSpan) constBestimmt, ob das vom aktuellen Objekt dargestellte Zeitintervall nicht dem vom angegebenen Objekt dargestellten Zeitintervall entspricht.
operator!=(std::nullptr_t) const
operator+(TimeSpan) constGibt eine neue Instanz der TimeSpan Klasse zurück, die ein Zeitintervall darstellt, das die Summe der von dem aktuellen und dem angegebenen Objekt dargestellten Zeitintervalle ist.
operator+() constGibt sich selbst zurück.
operator+=(TimeSpan)Weist dem aktuellen Objekt das Zeitintervall zu, das die Summe der vom aktuellen und vom angegebenen Objekt dargestellten Zeitintervalle ist.
operator-(TimeSpan) constGibt eine neue Instanz der TimeSpan-Klasse zurück, die ein Zeitintervall darstellt, das sich aus der Subtraktion des vom angegebenen Objekt dargestellten Zeitintervalls vom vom aktuellen Objekt dargestellten Zeitintervall ergibt.
operator-() constGibt eine neue Instanz des TimeSpan-Objekts zurück, das den negierten Wert des aktuellen TimeSpan-Objekts darstellt.
operator-=(TimeSpan)Weist dem aktuellen Objekt das Zeitintervall zu, das das Ergebnis der Subtraktion des vom angegebenen Objekt dargestellten Zeitintervalls vom vom aktuellen Objekt dargestellten Zeitintervall ist.
operator/(double) const
operator/(TimeSpan) const
operator/=(double)
operator<(TimeSpan) constBestimmt, ob das vom aktuellen Objekt dargestellte Zeitintervall kürzer ist als das vom angegebenen Objekt dargestellte Zeitintervall.
operator<(std::nullptr_t) const
operator<=(TimeSpan) constBestimmt, ob das vom aktuellen Objekt dargestellte Zeitintervall kürzer oder gleich dem vom angegebenen Objekt dargestellten Zeitintervall ist.
operator<=(std::nullptr_t) const
operator=(const TimeSpan&)Setzt das Zeitintervall, das vom angegebenen TimeSpan-Objekt repräsentiert wird, auf das aktuelle TimeSpan-Objekt.
operator==(TimeSpan) constBestimmt, ob das vom aktuellen Objekt dargestellte Zeitintervall dem vom angegebenen Objekt dargestellten Zeitintervall entspricht.
operator==(std::nullptr_t) const
operator>(TimeSpan) constBestimmt, ob das vom aktuellen Objekt dargestellte Zeitintervall länger ist als das vom angegebenen Objekt dargestellte Zeitintervall.
operator>(std::nullptr_t) const
operator>=(TimeSpan) constBestimmt, ob das vom aktuellen Objekt dargestellte Zeitintervall länger oder gleich dem vom angegebenen Objekt dargestellten Zeitintervall ist.
operator>=(std::nullptr_t) const
static Parse(const String&)Konvertiert eine Zeichenkette in ein entsprechendes TimeSpan-Objekt.
static Parse(const String&, const SharedPtr<IFormatProvider>&)Konvertiert eine Zeichenkette in ein entsprechendes TimeSpan-Objekt unter Verwendung des angegebenen Formatproviders.
static Parse(const String&, const SharedPtr<Globalization::CultureInfo>&)
static Parse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&)
static Parse(const String&, std::nullptr_t)
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::TimeSpanStyles)Konvertiert eine Zeichenkette in ein entsprechendes TimeSpan-Objekt unter Verwendung der angegebenen Formate, des Formatproviders und der Stile.
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::TimeSpanStyles)
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::TimeSpanStyles)
static ParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::TimeSpanStyles)
static ParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::TimeSpanStyles)Konvertiert eine Zeichenkette in ein entsprechendes TimeSpan-Objekt unter Verwendung des angegebenen Formats, des Formatproviders und der Stile.
static ParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::TimeSpanStyles)
static ParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::TimeSpanStyles)
static ParseExact(const String&, const String&, std::nullptr_t, Globalization::TimeSpanStyles)
Subtract(TimeSpan) constGibt eine neue Instanz der TimeSpan-Klasse zurück, die ein Zeitintervall darstellt, das sich aus der Subtraktion des vom angegebenen Objekt dargestellten Zeitintervalls vom vom aktuellen Objekt dargestellten Zeitintervall ergibt.
TimeSpan()Erstellt ein TimeSpan-Objekt, das ein Nullzeitintervall darstellt.
explicit TimeSpan(int64_t)Erstellt eine Instanz der TimeSpan-Klasse, die das angegebene Zeitintervall darstellt.
TimeSpan(int, int, int)Erstellt eine Instanz der TimeSpan-Klasse, die das Zeitintervall darstellt, das der Summe der angegebenen Anzahl von Stunden, Minuten und Sekunden entspricht.
TimeSpan(int, int, int, int, int)Erstellt eine Instanz der TimeSpan-Klasse, die das Zeitintervall darstellt, das der Summe der angegebenen Anzahl von Stunden, Minuten, Sekunden und Millisekunden entspricht.
TimeSpan(const TimeSpan&)Erstellt ein TimeSpan-Objekt, das das Zeitintervall darstellt, das dem vom angegebenen TimeSpan-Objekt dargestellten Zeitintervall entspricht.
ToString() constGibt die Zeichenkettenrepräsentation des vom aktuellen Objekt dargestellten Zeitintervalls zurück.
ToString(const String&) constKonvertiert den Wert des aktuellen Objekts in eine entsprechende Zeichenkettenrepräsentation unter Verwendung des angegebenen Formats.
ToString(const String&, const SharedPtr<IFormatProvider>&) constKonvertiert den Wert des aktuellen Objekts in eine entsprechende Zeichenkettenrepräsentation unter Verwendung des angegebenen Formats und des Formatproviders.
ToString(const String&, const SharedPtr<Globalization::CultureInfo>&) const
ToString(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&) const
ToString(const String&, std::nullptr_t) const
static TryParse(const String&, TimeSpan&)Konvertiert eine Zeichenkette in ein entsprechendes TimeSpan-Objekt und gibt das Ergebnis der Konvertierung zurück.
static TryParse(const String&, const SharedPtr<IFormatProvider>&, TimeSpan&)Konvertiert eine Zeichenkette in ein entsprechendes TimeSpan-Objekt unter Verwendung des angegebenen Formatproviders und gibt das Ergebnis der Konvertierung zurück.
static TryParse(const String&, const SharedPtr<Globalization::CultureInfo>&, TimeSpan&)
static TryParse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, TimeSpan&)
static TryParse(const String&, std::nullptr_t, TimeSpan&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, TimeSpan&)Konvertiert eine Zeichenkette in ein entsprechendes TimeSpan-Objekt unter Verwendung der angegebenen Formate und des Formatproviders und gibt das Ergebnis der Konvertierung zurück.
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, TimeSpan&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, TimeSpan&)
static TryParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, TimeSpan&)
static TryParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::TimeSpanStyles, TimeSpan&)Konvertiert eine Zeichenkette in ein entsprechendes TimeSpan-Objekt unter Verwendung des angegebenen Formats, des Formatproviders und der Stile und gibt das Ergebnis der Konvertierung zurück.
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::TimeSpanStyles, TimeSpan&)
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::TimeSpanStyles, TimeSpan&)
static TryParseExact(const String&, const String&, std::nullptr_t, Globalization::TimeSpanStyles, TimeSpan&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::TimeSpanStyles, TimeSpan&)Konvertiert eine Zeichenkette in ein entsprechendes TimeSpan-Objekt unter Verwendung der angegebenen Formate, des Formatproviders und der Stile und gibt das Ergebnis der Konvertierung zurück.
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::TimeSpanStyles, TimeSpan&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::TimeSpanStyles, TimeSpan&)
static TryParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::TimeSpanStyles, TimeSpan&)
static TryParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, TimeSpan&)Konvertiert eine Zeichenkette in ein entsprechendes TimeSpan-Objekt unter Verwendung des angegebenen Formats und des Formatproviders und gibt das Ergebnis der Konvertierung zurück.
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, TimeSpan&)
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, TimeSpan&)
static TryParseExact(const String&, const String&, std::nullptr_t, TimeSpan&)
static Type()Gibt ein TypeInfo-Objekt zurück, das die TimeSpan-Struktur repräsentiert.

Felder

FeldBeschreibung
static MaxValueDas TimeSpan-Objekt, das das längstmögliche Intervall darstellt.
static MinValue/// Das TimeSpan-Objekt, das das kürzestmögliche Intervall darstellt.
static constexpr TicksPerDayDie Anzahl der 100‑Nanosekunden‑Intervalle in einem Tag (24‑Stunden‑Intervall).
static constexpr TicksPerHourDie Anzahl der 100‑Nanosekunden‑Intervalle in einer Stunde.
static constexpr TicksPerMillisecondDie Anzahl der 100‑Nanosekunden‑Intervalle in einer Millisekunde.
static constexpr TicksPerMinuteDie Anzahl der 100‑Nanosekunden‑Intervalle in einer Minute.
static constexpr TicksPerSecondDie Anzahl der 100‑Nanosekunden‑Intervalle in einer Sekunde.
static ZeroDas TimeSpan-Objekt, das ein Null‑Intervall darstellt.

Hinweise

#include "system/datetime.h"
#include "system/timespan.h"
#include <iostream>

int main()
{
  const auto date1 = System::DateTime(2021, 01, 01);
  const auto date2 = System::DateTime(2021, 10, 30);

  const auto interval = date2 - date1;

  std::cout << "Number of ticks: " << interval.get_Ticks() << std::endl;
  std::cout << "Number of milliseconds: " << interval.get_Milliseconds() << std::endl;
  std::cout << "Total number of milliseconds: " << interval.get_TotalMilliseconds() << std::endl;
  std::cout << "Number of minutes: " << interval.get_Minutes() << std::endl;
  std::cout << "Total number of minutes: " << interval.get_TotalMinutes() << std::endl;
  std::cout << "Number of hours: " << interval.get_Hours() << std::endl;
  std::cout << "Total number of hours: " << interval.get_Hours() << std::endl;
  std::cout << "Number of days: " << interval.get_Days() << std::endl;
  std::cout << "Total number of days: " << interval.get_TotalDays() << std::endl;

  return 0;
}
/*
This code example produces the following output:
Number of ticks: 260928000000000
Number of milliseconds: 0
Total number of milliseconds: 2.60928e+10
Number of minutes: 0
Total number of minutes: 434880
Number of hours: 0
Total number of hours: 0
Number of days: 302
Total number of days: 302
*/

Siehe auch