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

См. также