Класс CFileTimeSpan

Этот класс предоставляет методы управления относительными значениями даты и времени, связанными с файлом.

Синтаксис

class CFileTimeSpan

Участники

Открытые конструкторы

Имя	Описание
CFileTimeSpan::CFileTimeSpan	Конструктор.

Открытые методы

Имя	Описание
CFileTimeSpan::GetTimeSpan	Вызовите этот метод, чтобы получить интервал времени из CFileTimeSpan объекта.
CFileTimeSpan::SetTimeSpan	Вызовите этот метод, чтобы задать интервал CFileTimeSpan времени объекта.

Общедоступные операторы

Имя	Описание
CFileTimeSpan::operator -	Выполняет вычитание объекта CFileTimeSpan .
CFileTimeSpan::operator !=	Проверяет неравенство двух объектов CFileTimeSpan.
CFileTimeSpan::operator +	Выполняет добавление объекта CFileTimeSpan .
CFileTimeSpan::operator +=	Выполняет добавление CFileTimeSpan объекта и назначение результата текущему объекту.
CFileTimeSpan::operator <	Сравнивает два CFileTimeSpan объекта, чтобы определить меньшее.
CFileTimeSpan::operator <=	Сравнивает два CFileTimeSpan объекта для определения равенства или меньшего.
CFileTimeSpan::operator =	Оператор присваивания .
CFileTimeSpan::operator -=	Выполняет вычитание объекта CFileTimeSpan и назначает результат текущему объекту.
CFileTimeSpan::operator ==	Сравнивает два объекта CFileTimeSpan на равенство.
CFileTimeSpan::operator >	Сравнивает два CFileTimeSpan объекта для определения большего размера.
CFileTimeSpan::operator >=	Сравнивает два CFileTimeSpan объекта для определения равенства или большего размера.

Замечания

Класс CFileTimeSpan предоставляет методы для обработки относительных периодов времени в единицах, которые использует файловая система. Эти единицы часто используются в операциях с файлами, таких как при создании файла, последнем доступе или последнем изменении. Методы этого класса часто используются вместе с CFileTime объектами класса .

Пример

Пример см. в примере CFileTime::Millisecond.

Требования

Заголовок: atltime.h

CFileTimeSpan::CFileTimeSpan

Конструктор.

CFileTimeSpan() throw();
CFileTimeSpan(const CFileTimeSpan& span) throw();
CFileTimeSpan(LONGLONG nSpan) throw();

Параметры

span
Существующий объект CFileTimeSpan.

nSpan
Период времени в FILETIME единицах.

Замечания

Объект CFileTimeSpan можно создать с помощью существующего CFileTimeSpan объекта или выразить как 64-разрядное значение в 100-наносекундах FILETIME . Дополнительные сведения см. в разделе CFileTime. Конструктор по умолчанию задает интервал времени 0.

CFileTimeSpan::GetTimeSpan

Вызовите этот метод, чтобы получить интервал времени из CFileTimeSpan объекта.

LONGLONG GetTimeSpan() const throw();

Возвращаемое значение

Возвращает интервал времени в 100 единицах nanosecond FILETIME . Дополнительные сведения см. в разделе CFileTime.

CFileTimeSpan::operator -

Выполняет вычитание объекта CFileTimeSpan .

CFileTimeSpan operator-(CFileTimeSpan span) const throw();

Параметры

span
Объект CFileTimeSpan.

Возвращаемое значение

CFileTimeSpan Возвращает объект, представляющий результат разницы между двумя интервалами времени.

CFileTimeSpan::operator !=

Проверяет неравенство двух объектов CFileTimeSpan.

bool operator!=(CFileTimeSpan span) const throw();

Параметры

span
Сравниваемый объект CFileTimeSpan.

Возвращаемое значение

Возвращает значение TRUE , если сравниваемый элемент не равен объекту CFileTimeSpan ; в противном случае FALSE.

CFileTimeSpan::operator +

Выполняет добавление объекта CFileTimeSpan .

CFileTimeSpan operator+(CFileTimeSpan span) const throw();

Параметры

span
Объект CFileTimeSpan.

Возвращаемое значение

CFileTimeSpan Возвращает объект, содержащий сумму двух временных диапазонов.

CFileTimeSpan::operator +=

Выполняет добавление CFileTimeSpan объекта и назначает результат текущему объекту.

CFileTimeSpan& operator+=(CFileTimeSpan span) throw();

Параметры

span
Объект CFileTimeSpan.

Возвращаемое значение

Возвращает обновленный CFileTimeSpan объект, содержащий сумму двух временных диапазонов.

CFileTimeSpan::operator <

Сравнивает два CFileTimeSpan объекта, чтобы определить меньшее.

bool operator<(CFileTimeSpan span) const throw();

Параметры

span
Сравниваемый объект CFileTimeSpan.

Возвращаемое значение

Возвращает значение TRUE , если первый объект меньше (то есть представляет короткий период времени), чем второй, в противном случае FALSE.

CFileTimeSpan::operator <=

Сравнивает два CFileTimeSpan объекта для определения равенства или меньшего.

bool operator<=(CFileTimeSpan span) const throw();

Параметры

span
Сравниваемый объект CFileTimeSpan.

Возвращаемое значение

Возвращает значение TRUE , если первый объект меньше (т. е. представляет более короткий период времени) или равен второму, в противном случае FALSE.

CFileTimeSpan::operator =

Оператор присваивания .

CFileTimeSpan& operator=(const CFileTimeSpan& span) throw();

Параметры

span
Объект CFileTimeSpan.

Возвращаемое значение

Возвращает обновленный CFileTimeSpan объект.

CFileTimeSpan::operator -=

Выполняет вычитание объекта CFileTimeSpan и назначает результат текущему объекту.

CFileTimeSpan& operator-=(CFileTimeSpan span) throw();

Параметры

span
Объект CFileTimeSpan.

Возвращаемое значение

Возвращает обновленный CFileTimeSpan объект.

CFileTimeSpan::operator ==

Сравнивает два объекта CFileTimeSpan на равенство.

bool operator==(CFileTimeSpan span) const throw();

Параметры

span
Сравниваемый объект CFileTimeSpan.

Возвращаемое значение

Возвращает значение TRUE, если объекты равны. В противном случае — значение FALSE.

CFileTimeSpan::operator >

Сравнивает два CFileTimeSpan объекта для определения большего размера.

bool operator>(CFileTimeSpan span) const throw();

Параметры

span
Сравниваемый объект CFileTimeSpan.

Возвращаемое значение

Возвращает значение TRUE , если первый объект больше (т. е. представляет длительный период времени), чем второй, в противном случае FALSE.

CFileTimeSpan::operator >=

Сравнивает два CFileTimeSpan объекта для определения равенства или большего размера.

bool operator>=(CFileTimeSpan span) const throw();

Параметры

span
Сравниваемый объект CFileTimeSpan.

Возвращаемое значение

Возвращает значение TRUE , если первый объект больше (т. е. представляет длительный период времени) или равен второму, в противном случае FALSE.

CFileTimeSpan::SetTimeSpan

Вызовите этот метод, чтобы задать интервал CFileTimeSpan времени объекта.

void SetTimeSpan(LONGLONG nSpan) throw();

Параметры

nSpan
Новое значение для интервала времени в 100-наносекундных FILETIME единицах. Дополнительные сведения см. в разделе CFileTime.

См. также

FILETIME
Класс CFileTime
Диаграмма иерархии
Общие классы ATL/MFC