الفئة System::TimeSpan
محتويات
[
يخفي
]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
*/
انظر أيضًا
- Namespace System
- Library Aspose.Page for C++
