فئة System::DateTime
محتويات
[
يخفي
]DateTime class
تمثل قيمة تاريخ ووقت محددة على استمرارية الزمن. يجب تخصيص هذا النوع على المكدس وتمريره إلى الدوال بالقيمة أو بالمرجع. لا تستخدم أبداً فئة System::SmartPtr لإدارة كائنات هذا النوع.
class DateTime
الطرق
| طريقة | الوصف |
|---|---|
| Add(TimeSpan) const | إرجاع نسخة جديدة من فئة DateTime تمثل قيمة تاريخ ووقت ناتجة عن إضافة الفاصل الزمني المحدد إلى قيمة التاريخ والوقت التي يمثلها الكائن الحالي. |
| AddDays(double) const | إرجاع نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي هي مجموع القيمة التي يمثلها الكائن الحالي والعدد المحدد من الأيام. |
| AddHours(double) const | إرجاع نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي هي مجموع القيمة التي يمثلها الكائن الحالي والعدد المحدد من الساعات. |
| AddMilliseconds(double) const | إرجاع نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي هي مجموع القيمة التي يمثلها الكائن الحالي والعدد المحدد من الملليثواني. |
| AddMinutes(double) const | إرجاع نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي هي مجموع القيمة التي يمثلها الكائن الحالي والعدد المحدد من الدقائق. |
| AddMonths(int) const | إرجاع نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي هي مجموع القيمة التي يمثلها الكائن الحالي والعدد المحدد من الشهور. |
| AddSeconds(double) const | إرجاع نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي هي مجموع القيمة التي يمثلها الكائن الحالي والعدد المحدد من الثواني. |
| AddTicks(int64_t) const | إرجاع نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي هي مجموع القيمة التي يمثلها الكائن الحالي والعدد المحدد من فواصل 100 نانوثانية. |
| AddYears(int) const | إرجاع نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي تساوي تلك التي يمثلها الكائن الحالي مع زيادة مكوّن السنة بالعدد المحدد. |
| static Compare(DateTime, DateTime) | يقارن قيمتين تم تمثيلهما بواسطة النسختين المحددتين من فئة DateTime ويعيد القيمة التي تشير إلى المواضع النسبية للقيم على خط الزمن. |
| CompareTo(DateTime) const | يقارن قيمتي تاريخ ووقت تم تمثيلهما بواسطة الكائن الحالي والنسخة المحددة من فئة DateTime ويعيد القيمة التي تشير إلى المواضع النسبية للقيم على خط الزمن. |
| DateTime() | ينشئ نسخة تمثل أصغر قيمة تاريخ ووقت ممكنة مساوية لـ MinValue. |
| DateTime(int, int, int) | ينشئ مثيلاً يمثل قيمة تاريخ ووقت محددة بسنة وشهر ويوم معينين. |
| DateTime(int, int, int, const SharedPtr<Globalization::Calendar>&) | ينشئ مثيلاً يمثل قيمة تاريخ ووقت محددة بسنة وشهر ويوم معينين في التقويم المحدد. |
| DateTime(int, int, int, int, int, int) | ينشئ مثيلاً يمثل قيمة تاريخ ووقت محددة بسنة وشهر ويوم وساعة ودقيقة وثانية معينة. |
| DateTime(int, int, int, int, int, int, DateTimeKind) | ينشئ مثيلاً يمثل قيمة تاريخ ووقت محددة بسنة وشهر ويوم وساعة ودقيقة وثانية معينة. |
| DateTime(int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&) | ينشئ مثيلاً يمثل قيمة تاريخ ووقت محددة بسنة وشهر ويوم وساعة ودقيقة وثانية معينة في التقويم المحدد. |
| DateTime(int, int, int, int, int, int, int, DateTimeKind) | ينشئ مثيلاً يمثل قيمة تاريخ ووقت محددة بسنة وشهر ويوم وساعة ودقيقة وثانية وملي ثانية معينة. |
| DateTime(int, int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&, DateTimeKind) | ينشئ مثيلاً يمثل قيمة تاريخ ووقت محددة بسنة وشهر ويوم وساعة ودقيقة وثانية وملي ثانية معينة في التقويم المحدد. |
| DateTime(int64_t, DateTimeKind) | أنشئ مثيلاً يمثل قيمة تاريخ ووقت محددة كعدد من النبضات. |
| DateTime(int64_t, DateTimeKind, bool) | أنشئ مثيلاً يمثل قيمة تاريخ ووقت محددة كعدد من النبضات. للاستخدام الداخلي. |
| DateTime(const DateTime&) | ينشئ نسخة من مثيل. |
| static DaysInMonth(int, int) | يعيد عدد الأيام في الشهر المحدد من السنة المحددة. |
| static Equals(DateTime, DateTime) | يحدد ما إذا كانت المثيلات المحددة من الفئة DateTime تمثل نفس قيمة التاريخ والوقت. |
| Equals(DateTime) const | يحدد ما إذا كانت المثيلة المحددة من الفئة DateTime تمثل نفس قيمة التاريخ والوقت مثل الكائن الحالي. |
| static FromBinary(int64_t) | يفك تسلسل قيمة التاريخ والوقت من العدد غير الموقّع 64‑بت المحدد ويعيّن المثيل الجديد من الفئة DateTime إلى تلك القيمة. |
| static FromFileTime(int64_t) | يحوّل وقت الملف المحدد إلى مثيل من الفئة DateTime يمثل نفس قيمة التاريخ والوقت كوقت محلي. |
| static FromFileTimeUtc(int64_t) | يحوّل وقت الملف المحدد إلى مثيل من الفئة DateTime يمثل نفس قيمة التاريخ والوقت كوقت UTC. |
| static FromOADate(double) | يعيد مثيلاً من الفئة DateTime يمثل قيمة التاريخ والوقت المكافئة لتاريخ OLE Automation المحدد. |
| static FromUnixTime(time_t) | يحوّل قيمة وقت Unix المحددة إلى مثيل من الفئة DateTime. للاستخدام الداخلي. |
| get_Date() const | يعيد مثيلاً جديداً من الفئة DateTime يمثل جزء التاريخ من التاريخ والوقت الممثلين بواسطة الكائن الحالي مع ضبط كل مكوّن من جزء الوقت إلى 0. |
| get_Day() const | يعيد الرقم الترتيبي لليوم في الشهر الممثل بواسطة الكائن الحالي. |
| get_DayOfWeek() const | يعيد قيمة تمثل يوم الأسبوع الممثل بواسطة الكائن الحالي. |
| get_DayOfYear() const | يعيد الرقم الترتيبي لليوم في السنة الممثلة بواسطة الكائن الحالي. |
| get_Hour() const | يعيد مكوّن الساعة من قيمة التاريخ والوقت الممثلة بواسطة الكائن الحالي. |
| get_Kind() const | يعيد القيمة التي تمثل ما إذا كان التاريخ والوقت الممثلان بواسطة الكائن الحالي تاريخًا ووقتًا محليًا أو UTC أو لا شيء منهما. |
| get_Millisecond() const | يعيد مكوّن الملي ثانية من قيمة التاريخ والوقت الممثلة بواسطة الكائن الحالي. |
| get_Minute() const | يعيد مكوّن الدقيقة من قيمة التاريخ والوقت الممثلة بواسطة الكائن الحالي. |
| get_Month() const | يعيد الرقم الترتيبي للشهر في السنة التي يمثلها الكائن الحالي. |
| static get_Now() | يعيد نسخة من فئة DateTime تمثل الوقت الحالي كوقت محلي. |
| get_Second() const | يعيد مكوّن الثواني لقيمة التاريخ والوقت التي يمثلها الكائن الحالي. |
| get_Ticks() const | يعيد عدد الفواصل الزمنية التي تبلغ 100 نانوثانية منذ 0:00:00 بتوقيت UTC، 1 يناير 0001، في التقويم الميلادي حتى التاريخ والوقت الذي يمثله الكائن الحالي. |
| get_TimeOfDay() const | يعيد القيمة التي تمثل الفاصل الزمني من بداية اليوم الذي يمثله الكائن الحالي حتى قيمة التاريخ والوقت التي يمثلها الكائن الحالي. |
| static get_Today() | يعيد نسخة من فئة DateTime تمثل التاريخ الحالي مع ضبط كل مكوّن من جزء الوقت للقيمة التي يمثلها الكائن إلى 0. |
| static get_UtcNow() | يعيد نسخة من فئة DateTime تمثل الوقت الحالي بتوقيت UTC. |
| get_Year() const | يعيد السنة التي يمثلها الكائن الحالي. |
| GetDateComponents(int&, int&, int&) const | يحصل على أجزاء التاريخ. للاستخدام الداخلي. |
| GetDateTimeFormats() const | يعيد مصفوفة من السلاسل حيث يكون كل عنصر هو تمثيل نصي للكائن الحالي مُنسّق بأحد محددات تنسيق التاريخ والوقت القياسية. |
| GetDateTimeFormats(char_t) const | يعيد مصفوفة من السلاسل حيث يكون كل عنصر هو تمثيل نصي للكائن الحالي مُنسّق بالمحدد القياسي المحدد لتنسيق التاريخ والوقت. |
| GetDateTimeFormats(const SharedPtr<IFormatProvider>&) const | يعيد مصفوفة من السلاسل حيث يكون كل عنصر هو تمثيل نصي للكائن الحالي مُنسّق بأحد محددات تنسيق التاريخ والوقت القياسية ومزود التنسيق المحدد. |
| GetDateTimeFormats(char_t, const SharedPtr<IFormatProvider>&) const | يعيد مصفوفة من السلاسل حيث يكون كل عنصر هو تمثيل نصي للكائن الحالي مُنسّق بالمحدد القياسي المحدد لتنسيق التاريخ والوقت ومزود التنسيق. |
| GetHashCode() const | يعيد رمز تجزئة للكائن الحالي. |
| IsDaylightSavingTime() const | يحدد ما إذا كانت قيمة التاريخ والوقت التي يمثلها الكائن الحالي تقع ضمن نطاق التوقيت الصيفي للمنطقة الزمنية الحالية. |
| static IsLeapYear(int) | يحدد ما إذا كانت السنة المحددة سنة كبيسة. |
| IsNull() const | |
| operator!=(DateTime) const | يحدد ما إذا كان الكائن الحالي والكائن DateTime المحدد يمثلان قيم تاريخ ووقت مختلفة. |
| operator!=(std::nullptr_t) const | |
| operator+(TimeSpan) const | يعيد نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي هي مجموع القيمة التي يمثلها الكائن الحالي والفترة الزمنية المحددة. |
| operator+=(TimeSpan) | يضبط الكائن الحالي على قيمة التاريخ والوقت التي هي مجموع القيمة التي يمثلها الكائن الحالي والفترة الزمنية المحددة. |
| operator-(TimeSpan) const | يعيد نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي هي نتيجة طرح الفترة الزمنية المحددة من القيمة التي يمثلها الكائن الحالي. |
| operator-(DateTime) const | يعيد مثيلاً من الفئة TimeSpan التي تمثل الفاصل الزمني بين قيم التاريخ والوقت التي يمثلها الكائنان الحالي والمحدد. |
| operator-=(TimeSpan) | يضبط الكائن الحالي على قيمة التاريخ والوقت التي هي نتيجة طرح الفترة الزمنية المحددة من قيمة التاريخ والوقت التي يمثلها الكائن الحالي. |
| operator<(DateTime) const | يحدد ما إذا كان الكائن الحالي يمثل قيمة التاريخ والوقت التي هي أسبق من القيمة التي يمثلها الكائن DateTime المحدد. |
| operator<(std::nullptr_t) const | |
| operator<=(DateTime) const | يحدد ما إذا كان الكائن الحالي يمثل قيمة التاريخ والوقت التي هي أسبق أو مساوية للقيمة التي يمثلها الكائن DateTime المحدد. |
| operator<=(std::nullptr_t) const | |
| operator=(const DateTime&) | يعين القيمة التي يمثلها الكائن DateTime المحدد إلى الكائن الحالي. |
| operator==(DateTime) const | يحدد ما إذا كان الكائن الحالي والكائن DateTime المحدد يمثلان نفس قيمة التاريخ والوقت. |
| operator==(std::nullptr_t) const | |
| operator>(DateTime) const | يحدد ما إذا كان الكائن الحالي يمثل قيمة التاريخ والوقت التي هي لاحقة للقيمة التي يمثلها الكائن DateTime المحدد. |
| operator>(std::nullptr_t) const | |
| operator>=(DateTime) const | يحدد ما إذا كان الكائن الحالي يمثل قيمة التاريخ والوقت التي تكون لاحقة أو مساوية للقيمة التي يمثلها كائن DateTime المحدد. |
| operator>=(std::nullptr_t) const | |
| static Parse(const String&) | يحوّل تمثيل السلسلة المحدد لقيمة التاريخ والوقت إلى كائن DateTime المكافئ. |
| static Parse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles) | يحوّل تمثيل السلسلة المحدد لقيمة التاريخ والوقت إلى كائن DateTime المكافئ باستخدام معلومات تنسيق خاصة بالثقافة. |
| static Parse(const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles) | |
| static Parse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles) | |
| static Parse(const String&, std::nullptr_t, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles) | يحوّل تمثيل السلسلة المحدد لقيمة التاريخ والوقت إلى كائن DateTime المكافئ باستخدام التنسيق المحدد ومعلومات تنسيق خاصة بالثقافة. يجب أن يتطابق تنسيق تمثيل السلسلة مع التنسيق المحدد تمامًا. يُطلق استثناءً إذا فشل التحويل. |
| static ParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const String&, std::nullptr_t, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles) | يحوّل تمثيل السلسلة المحدد لقيمة التاريخ والوقت إلى كائن DateTime المكافئ باستخدام التنسيقات المحددة ومعلومات تنسيق خاصة بالثقافة والنمط. يجب أن يتطابق تنسيق تمثيل السلسلة مع أحد أو أكثر من التنسيقات المحددة تمامًا. يُطلق استثناءً إذا فشل التحويل. |
| static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles) | |
| static ParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::DateTimeStyles) | |
| static SpecifyKind(DateTime, DateTimeKind) | ينشئ كائنًا جديدًا من نوع DateTime يمثل نفس عدد الـ ticks كما في كائن DateTime المحدد ويمثل الوقت المحلي أو وقت UTC أو لا شيء حسب ما يحدده الوسيط kind. |
| Subtract(TimeSpan) const | يعيد نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي هي نتيجة طرح الفترة الزمنية المحددة من القيمة التي يمثلها الكائن الحالي. |
| Subtract(DateTime) const | يرجع نسخة من فئة TimeSpan تمثل الفاصل الزمني بين قيم التاريخ والوقت التي يمثلها الكائن الحالي والكائن المحدد. |
| ToBinary() const | يسلسل الكائن الحالي. |
| ToFileTime() const | يرجع قيمة تمثل قيمة التاريخ والوقت التي يمثلها الكائن الحالي كوقت ملف. |
| ToFileTimeUtc() const | يحوّل قيمة التاريخ والوقت التي يمثلها الكائن الحالي إلى وقت ملف UTC. |
| ToLocalTime() const | يرجع نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي يمثلها الكائن الحالي كوقت محلي. |
| ToLongDateString() const | يرجع سلسلة تحتوي على تمثيل تاريخ طويل للكائن الحالي. |
| ToLongTimeString() const | يرجع سلسلة تحتوي على تمثيل وقت طويل للكائن الحالي. |
| ToOADate() const | يرجع قيمة التاريخ والوقت التي يمثلها الكائن الحالي كـ OLE Automation Date. |
| ToShortDateString() const | يرجع سلسلة تحتوي على تمثيل تاريخ قصير للكائن الحالي. |
| ToShortTimeString() const | يرجع سلسلة تحتوي على تمثيل وقت قصير للكائن الحالي. |
| ToString() const | يرجع تمثيل السلسلة لقيمة التاريخ والوقت التي يمثلها الكائن الحالي باستخدام قواعد التنسيق المحددة من قبل الثقافة الحالية. |
| ToString(const String&) const | يرجع تمثيلًا نصيًا لقيمة التاريخ والوقت التي يمثلها الكائن الحالي باستخدام التنسيق المحدد وقواعد التنسيق المحددة من قبل الثقافة الحالية. |
| ToString(const SharedPtr<IFormatProvider>&) const | يرجع تمثيلًا نصيًا لقيمة التاريخ والوقت التي يمثلها الكائن الحالي باستخدام معلومات التنسيق المحددة. |
| ToString(const SharedPtr<Globalization::CultureInfo>&) const | |
| ToString(const SharedPtr<Globalization::DateTimeFormatInfo>&) const | |
| ToString(std::nullptr_t) 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 | |
| ToUniversalTime() const | يرجع نسخة جديدة من فئة DateTime تمثل قيمة التاريخ والوقت التي يمثلها الكائن الحالي كوقت UTC. |
| ToUnixTime() const | يرجع قيمة تمثل قيمة التاريخ والوقت التي يمثلها الكائن الحالي كوقت Unix. للاستخدام الداخلي. |
| static TryParse(const String&, DateTime&) | يحوّل تمثيل السلسلة المحدد لقيمة التاريخ والوقت إلى كائن DateTime المكافئ. |
| static TryParse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&) | يحوّل تمثيل السلسلة المحدد لقيمة التاريخ والوقت إلى كائن DateTime المكافئ باستخدام معلومات تنسيق خاصة بالثقافة المحددة والنمط. |
| static TryParse(const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParse(const String&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&) | يحوّل تمثيل السلسلة المحدد لقيمة التاريخ والوقت إلى كائن DateTime المكافئ باستخدام التنسيق المحدد ومعلومات تنسيق خاصة بالثقافة والنمط. يجب أن يتطابق تنسيق تمثيل السلسلة مع التنسيق المحدد تمامًا. |
| static TryParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const String&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&) | يحوّل تمثيل السلسلة المحدد لقيمة التاريخ والوقت إلى كائن DateTime المكافئ باستخدام التنسيقات المحددة ومعلومات تنسيق خاصة بالثقافة والنمط. يجب أن يتطابق تنسيق تمثيل السلسلة مع أحد أو أكثر من التنسيقات المحددة تمامًا. |
| static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&) | |
| static TryParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&) | |
| static Type() | يرجع كائنًا من نوع TypeInfo يحتوي على معلومات حول هذه الفئة. |
الحقول
| حقل | الوصف |
|---|---|
| static constexpr MaxTicks | عدد الـ 100 نانوثانية في الفاصل الزمني بين القيمة الدنيا الممكنة والقيمة العليا الممكنة لـ DateTime. |
| static MaxValue | مثال من فئة DateTime يمثل القيمة العليا الممكنة للتاريخ والوقت. |
| static constexpr MinTicks | الحد الأدنى لعدد الـ ticks التي يمكن أن يمثلها مثال من فئة DateTime. |
| static MinValue | مثال من فئة DateTime يمثل القيمة الدنيا الممكنة للتاريخ والوقت. |
| static constexpr TicksPerDay | عدد الـ ticks في اليوم. |
| static constexpr TicksPerHour | عدد الـ ticks في الساعة. |
| static constexpr TicksPerMicrosecond | عدد الـ ticks في الميكروثانية. |
| static constexpr TicksPerMillisecond | عدد الـ ticks في المليثانية. |
| static constexpr TicksPerMinute | عدد الـ ticks في الدقيقة. |
| static constexpr TicksPerSecond | عدد الـ ticks في الثانية. |
| static UnixEpoch | مثال من فئة DateTime يمثل بداية حقبة يونكس (1970.01.01 00:00:00). |
ملاحظات
#include "system/console.h"
#include "system/date_time.h"
int main()
{
using namespace System;
// إنشاء مثال فئة 'DateTime'.
DateTime dateTime{1990, 10, 30};
// طباعة المثال بأشكال متعددة.
Console::WriteLine(dateTime.ToShortDateString());
Console::WriteLine(dateTime.ToShortTimeString());
Console::WriteLine(dateTime.ToString());
return 0;
}
/*
This code example produces the following output:
30.10.1990
0:00
30.10.1990 0:00:00
*/
انظر أيضًا
- Namespace System
- Library Aspose.Font for C++
