System::TimeSpan class

TimeSpan class

Αντιπροσωπεύει ένα χρονικό διάστημα. Αυτός ο τύπος πρέπει να κατανεμηθεί στη στοίβα και να περάσει σε συναρτήσεις με τιμή ή με αναφορά. Ποτέ μην χρησιμοποιείτε την κλάση System::SmartPtr για τη διαχείριση αντικειμένων αυτού του τύπου.

class TimeSpan

Μέθοδοι

ΜέθοδοςΠεριγραφή
Add(TimeSpan) constΕπιστρέφει μια νέα παρουσία της κλάσης TimeSpan που αντιπροσωπεύει ένα χρονικό διάστημα το οποίο είναι το άθροισμα των χρονικών διαστημάτων που αντιπροσωπεύονται από το τρέχον και το καθορισμένο αντικείμενο.
static Compare(TimeSpan, TimeSpan)Συγκρίνει δύο αντικείμενα TimeSpan.
CompareTo(TimeSpan) constΣυγκρίνει το τρέχον και το καθορισμένο αντικείμενο.
CompareTo(const SharedPtr<Object>&) constΣυγκρίνει το τρέχον και το καθορισμένο αντικείμενο.
Duration() constΕπιστρέφει ένα νέο στιγμιότυπο του αντικειμένου TimeSpan του οποίου η τιμή είναι η απόλυτη τιμή του τρέχοντος αντικειμένου.
Equals(TimeSpan) constΚαθορίζει εάν το χρονικό διάστημα που αντιπροσωπεύεται από το τρέχον αντικείμενο είναι ίσο με το χρονικό διάστημα που αντιπροσωπεύεται από το καθορισμένο αντικείμενο.
Equals(const SharedPtr<Object>&) constΚαθορίζει εάν το χρονικό διάστημα που αντιπροσωπεύεται από το τρέχον αντικείμενο είναι ίσο με το χρονικό διάστημα που αντιπροσωπεύεται από το καθορισμένο αντικείμενο.
static Equals(TimeSpan, TimeSpan)Επιστρέφει true εάν τα καθορισμένα αντικείμενα αντιπροσωπεύουν το ίδιο χρονικό διάστημα, διαφορετικά - false.
static FromDays(double)Επιστρέφει ένα νέο αντικείμενο TimeSpan που αντιπροσωπεύει το καθορισμένο διάστημα.
static FromHours(double)Επιστρέφει ένα νέο αντικείμενο TimeSpan που αντιπροσωπεύει το καθορισμένο διάστημα.
static FromMilliseconds(double)Επιστρέφει ένα νέο αντικείμενο TimeSpan που αντιπροσωπεύει το καθορισμένο διάστημα.
static FromMinutes(double)Επιστρέφει ένα νέο αντικείμενο TimeSpan που αντιπροσωπεύει το καθορισμένο διάστημα.
static FromSeconds(double)Επιστρέφει ένα νέο αντικείμενο TimeSpan που αντιπροσωπεύει το καθορισμένο διάστημα.
static FromTicks(int64_t)Επιστρέφει ένα νέο αντικείμενο TimeSpan που αντιπροσωπεύει το καθορισμένο διάστημα.
get_Days() constΕπιστρέφει το στοιχείο ημερών του χρονικού διαστήματος που αντιπροσωπεύεται από το τρέχον αντικείμενο TimeSpan.
get_Hours() constΕπιστρέφει το στοιχείο ωρών του χρονικού διαστήματος που αντιπροσωπεύεται από το τρέχον αντικείμενο TimeSpan.
get_Milliseconds() constΕπιστρέφει το στοιχείο χιλιοστών του χρονικού διαστήματος που αντιπροσωπεύεται από το τρέχον αντικείμενο TimeSpan.
get_Minutes() constΕπιστρέφει το στοιχείο λεπτών του χρονικού διαστήματος που αντιπροσωπεύεται από το τρέχον αντικείμενο TimeSpan.
get_Seconds() constΕπιστρέφει το στοιχείο δευτερολέπτων του χρονικού διαστήματος που αντιπροσωπεύεται από το τρέχον αντικείμενο TimeSpan.
get_Ticks() constΕπιστρέφει τον αριθμό των διαστημάτων 100-νανοδευτερολέπτων που αποτελούν το χρονικό διάστημα που αντιπροσωπεύεται από το τρέχον αντικείμενο TimeSpan.
get_TotalDays() constΕπιστρέφει την τιμή του τρέχοντος αντικειμένου TimeSpan εκφρασμένη σε ολόκληρες και κλασματικές ημέρες.
get_TotalHours() constΕπιστρέφει την τιμή του τρέχοντος αντικειμένου TimeSpan εκφρασμένη σε ολόκληρες και κλασματικές ώρες.
get_TotalMilliseconds() constΕπιστρέφει την τιμή του τρέχοντος αντικειμένου TimeSpan εκφρασμένη σε ολόκληρες και κλασματικές χιλιοστά του δευτερολέπτου.
get_TotalMinutes() constΕπιστρέφει την τιμή του τρέχοντος αντικειμένου TimeSpan εκφρασμένη σε ολόκληρα και κλασματικά λεπτά.
get_TotalSeconds() constΕπιστρέφει την τιμή του τρέχοντος αντικειμένου TimeSpan εκφρασμένη σε ολόκληρα και κλασματικά δευτερόλεπτα.
GetHashCode() constΕπιστρέφει έναν κωδικό κατακερματισμού για το τρέχον αντικείμενο.
IsNull() const
Negate() constΕπιστρέφει ένα νέο στιγμιότυπο του αντικειμένου TimeSpan που αντιπροσωπεύει την αρνητική τιμή που αντιπροσωπεύεται από το τρέχον αντικείμενο TimeSpan.
operator!=(TimeSpan) constΚαθορίζει εάν το χρονικό διάστημα που αντιπροσωπεύεται από το τρέχον αντικείμενο δεν είναι ίσο με το χρονικό διάστημα που αντιπροσωπεύεται από το καθορισμένο αντικείμενο.
operator!=(std::nullptr_t) const
operator+(TimeSpan) constΕπιστρέφει μια νέα παρουσία της κλάσης TimeSpan που αντιπροσωπεύει ένα χρονικό διάστημα το οποίο είναι το άθροισμα των χρονικών διαστημάτων που αντιπροσωπεύονται από το τρέχον και το καθορισμένο αντικείμενο.
operator+() constΕπιστρέφει τον εαυτό του.
operator+=(TimeSpan)Αναθέτει στο τρέχον αντικείμενο το χρονικό διάστημα που είναι το άθροισμα του χρονικού διαστήματος που αντιπροσωπεύεται από το τρέχον και τα καθορισμένα αντικείμενα.
operator-(TimeSpan) constΕπιστρέφει ένα νέο στιγμιότυπο της κλάσης TimeSpan που αντιπροσωπεύει ένα χρονικό διάστημα που είναι το αποτέλεσμα της αφαίρεσης του χρονικού διαστήματος που αντιπροσωπεύεται από το καθορισμένο αντικείμενο από το χρονικό διάστημα που αντιπροσωπεύεται από το τρέχον αντικείμενο.
operator-() constΕπιστρέφει ένα νέο στιγμιότυπο του αντικειμένου TimeSpan που αντιπροσωπεύει την αρνητική τιμή που αντιπροσωπεύεται από το τρέχον αντικείμενο TimeSpan.
operator-=(TimeSpan)Αναθέτει στο τρέχον αντικείμενο το χρονικό διάστημα που είναι το αποτέλεσμα της αφαίρεσης του χρονικού διαστήματος που αντιπροσωπεύεται από το καθορισμένο αντικείμενο από το χρονικό διάστημα που αντιπροσωπεύεται από το τρέχον αντικείμενο.
operator/(double) const
operator/(TimeSpan) const
operator/=(double)
operator<(TimeSpan) constΚαθορίζει εάν το χρονικό διάστημα που αντιπροσωπεύεται από το τρέχον αντικείμενο είναι μικρότερο από το χρονικό διάστημα που αντιπροσωπεύεται από το καθορισμένο αντικείμενο.
operator<(std::nullptr_t) const
operator<=(TimeSpan) constΚαθορίζει εάν το χρονικό διάστημα που αντιπροσωπεύεται από το τρέχον αντικείμενο είναι μικρότερο ή ίσο με το χρονικό διάστημα που αντιπροσωπεύεται από το καθορισμένο αντικείμενο.
operator<=(std::nullptr_t) const
operator=(const TimeSpan&)Ορίζει το χρονικό διάστημα που αντιπροσωπεύεται από το καθορισμένο αντικείμενο TimeSpan στο τρέχον αντικείμενο TimeSpan.
operator==(TimeSpan) constΚαθορίζει εάν το χρονικό διάστημα που αντιπροσωπεύεται από το τρέχον αντικείμενο είναι ίσο με το χρονικό διάστημα που αντιπροσωπεύεται από το καθορισμένο αντικείμενο.
operator==(std::nullptr_t) const
operator>(TimeSpan) constΚαθορίζει εάν το χρονικό διάστημα που αντιπροσωπεύεται από το τρέχον αντικείμενο είναι μεγαλύτερο από το χρονικό διάστημα που αντιπροσωπεύεται από το καθορισμένο αντικείμενο.
operator>(std::nullptr_t) const
operator>=(TimeSpan) constΚαθορίζει εάν το χρονικό διάστημα που αντιπροσωπεύεται από το τρέχον αντικείμενο είναι μεγαλύτερο ή ίσο με το χρονικό διάστημα που αντιπροσωπεύεται από το καθορισμένο αντικείμενο.
operator>=(std::nullptr_t) const
static Parse(const String&)Μετατρέπει τη συμβολοσειρά σε ισοδύναμο αντικείμενο TimeSpan.
static Parse(const String&, const SharedPtr<IFormatProvider>&)Μετατρέπει τη συμβολοσειρά σε ισοδύναμο αντικείμενο TimeSpan χρησιμοποιώντας τον καθορισμένο πάροχο μορφής.
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)Μετατρέπει τη συμβολοσειρά σε ισοδύναμο αντικείμενο TimeSpan χρησιμοποιώντας τις καθορισμένες μορφές, τον πάροχο μορφής και τα στυλ.
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)Μετατρέπει τη συμβολοσειρά σε ισοδύναμο αντικείμενο TimeSpan χρησιμοποιώντας τη καθορισμένη μορφή, τον πάροχο μορφής και τα στυλ.
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) constΕπιστρέφει ένα νέο στιγμιότυπο της κλάσης TimeSpan που αντιπροσωπεύει ένα χρονικό διάστημα που είναι το αποτέλεσμα της αφαίρεσης του χρονικού διαστήματος που αντιπροσωπεύεται από το καθορισμένο αντικείμενο από το χρονικό διάστημα που αντιπροσωπεύεται από το τρέχον αντικείμενο.
TimeSpan()Δημιουργεί ένα αντικείμενο TimeSpan που αντιπροσωπεύει ένα μηδενικό χρονικό διάστημα.
explicit TimeSpan(int64_t)Δημιουργεί μια παρουσία της κλάσης TimeSpan που αντιπροσωπεύει το καθορισμένο χρονικό διάστημα.
TimeSpan(int, int, int)Δημιουργεί μια παρουσία της κλάσης TimeSpan που αντιπροσωπεύει το χρονικό διάστημα ίσο με το άθροισμα του καθορισμένου αριθμού ωρών, λεπτών και δευτερολέπτων.
TimeSpan(int, int, int, int, int)Δημιουργεί μια παρουσία της κλάσης TimeSpan που αντιπροσωπεύει το χρονικό διάστημα ίσο με το άθροισμα του καθορισμένου αριθμού ωρών, λεπτών, δευτερολέπτων και χιλιοσκοδευτερόλεπτα.
TimeSpan(const TimeSpan&)Δημιουργεί ένα αντικείμενο TimeSpan που αντιπροσωπεύει το χρονικό διάστημα ίσο με το χρονικό διάστημα που αντιπροσωπεύεται από το καθορισμένο αντικείμενο TimeSpan.
ToString() constΕπιστρέφει την αναπαράσταση της συμβολοσειράς του χρονικού διαστήματος που αντιπροσωπεύεται από το τρέχον αντικείμενο.
ToString(const String&) constΜετατρέπει την τιμή του τρέχοντος αντικειμένου σε ισοδύναμη αναπαράσταση συμβολοσειράς, χρησιμοποιώντας τη καθορισμένη μορφή.
ToString(const String&, const SharedPtr<IFormatProvider>&) constΜετατρέπει την τιμή του τρέχοντος αντικειμένου σε ισοδύναμη αναπαράσταση συμβολοσειράς, χρησιμοποιώντας τη καθορισμένη μορφή και τον πάροχο μορφής.
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&)Μετατρέπει τη συμβολοσειρά σε ισοδύναμο αντικείμενο TimeSpan και επιστρέφει το αποτέλεσμα της μετατροπής.
static TryParse(const String&, const SharedPtr<IFormatProvider>&, TimeSpan&)Μετατρέπει τη συμβολοσειρά σε ισοδύναμο αντικείμενο TimeSpan χρησιμοποιώντας τον καθορισμένο πάροχο μορφής και επιστρέφει το αποτέλεσμα της μετατροπής.
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&)Μετατρέπει τη συμβολοσειρά σε ισοδύναμο αντικείμενο TimeSpan χρησιμοποιώντας τις καθορισμένες μορφές και τον πάροχο μορφής, και επιστρέφει το αποτέλεσμα της μετατροπής.
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&)Μετατρέπει τη συμβολοσειρά σε ισοδύναμο αντικείμενο TimeSpan χρησιμοποιώντας τη καθορισμένη μορφή, τον πάροχο μορφής και τα στυλ, και επιστρέφει το αποτέλεσμα της μετατροπής.
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&)Μετατρέπει τη συμβολοσειρά σε ισοδύναμο αντικείμενο TimeSpan χρησιμοποιώντας τις καθορισμένες μορφές, τον πάροχο μορφής και τα στυλ, και επιστρέφει το αποτέλεσμα της μετατροπής.
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&)Μετατρέπει τη συμβολοσειρά σε ισοδύναμο αντικείμενο TimeSpan χρησιμοποιώντας τη καθορισμένη μορφή και τον πάροχο μορφής, και επιστρέφει το αποτέλεσμα της μετατροπής.
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()Επιστρέφει ένα αντικείμενο TypeInfo που αντιπροσωπεύει τη δομή TimeSpan.

Πεδία

ΠεδίοΠεριγραφή
static MaxValueΤο αντικείμενο TimeSpan που αντιπροσωπεύει το μεγαλύτερο δυνατό διάστημα.
static MinValue/// Το αντικείμενο TimeSpan που αντιπροσωπεύει το μικρότερο δυνατό διάστημα.
static constexpr TicksPerDayΟ αριθμός των διαστημάτων των 100 νανοδευτερολέπτων σε μια ημέρα (διάστημα 24 ωρών).
static constexpr TicksPerHourΟ αριθμός των διαστημάτων των 100 νανοδευτερολέπτων σε μία ώρα.
static constexpr TicksPerMillisecondΟ αριθμός των διαστημάτων των 100 νανοδευτερολέπτων σε ένα χιλιοστό του δευτερολέπτου.
static constexpr TicksPerMinuteΟ αριθμός των διαστημάτων 100 νανοδευτερολέπτων σε ένα λεπτό.
static constexpr TicksPerSecondΟ αριθμός των διαστημάτων 100 νανοδευτερολέπτων σε ένα δευτερόλεπτο.
static ZeroΤο αντικείμενο TimeSpan που αντιπροσωπεύει το μηδενικό διάστημα.

Παρατηρήσεις

#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
*/

Δείτε επίσης