Класс CTime
CTime не имеет базового класса.
Объект CTime представляет абсолютное время и дату. Класс CTime объединяет тип данных ANSI time_t и ассоциированные run-time функции (функции периода выполнения), включая способность конвертировать из и в Григорианскую дату и 24-часовое время.
Значение CTime базируется на UTC (coordinated universal time -универсальные координаты времени), которые эквивалентны GMT (Greenwich mean time - значение времени по Гринвичу). Местная временная зона контролируется переменной среды окружения - TZ.
При создании CТime установите параметр nDST равным 0 для сообщения что действует стандартное представление времени, или равным некоторому значению большем 0 для сообщения что действует время в формате daylight savings, или равным некоторому значению меньше нуля для того чтобы код C run-time библиотеки сам определял какой формат времени применять - стандартное время или daylight savings. tm_isdst - необходимое поле. Если оно не установлено, то данное значение считается не определенным и значение, возвращаемое функцией mktime не предсказуемо. Если timeptr указывает на структуру tm, возвращенную предыдущим вызовов функций asctime, gmtime, или localtime, то поле tm_isdst содержит правильное значение.
Для получения более подробной информации о типе данных time_t и run-time функциях, которые использует CTime смотри Run-Time Library Reference.
Дружественный класс CTimeSpan, представляет промежуток времени - разницу между двумя объектами CTime.
Классы CTime и CTimeSpan не предназначены для наследования, так как они не имеют виртуальных функций. Размер объектов CTime и CTimeSpan обычно - 4 байта. Большинство функций-членов - встроенные (inline).
Для получения более подробной информации смотри статью Date and Time в Visual C++ Programmer's Guide и Time Management в Run-Time Library Reference.
Члены класса CTime
Конструкторы
|
CTime
|
Различные конструкторы объекта CТime.
|
|
GetCurrentTime
|
Создание объекта CTime содержащего текущее время (статическая член-функция).
|
Методы доступа
|
GetTime
|
Возвращает time_t соответствующее объекту CТime.
|
|
GetYear
|
Возвращает год, который содержит данный объект CTime.
|
|
GetMonth
|
Возвращает месяц, который содержит данный объект CTime. (от 1 до 12).
|
|
GetDay
|
Возвращает день, который содержит данный объект CTime. (от 1 до 31).
|
|
GetHour
|
Возвращает час, который содержит данный объект CTime. (от 0 до 23).
|
|
GetMinute
|
Возвращает минуты, которые содержит данный объект CTime. (от 0 до 59).
|
|
GetSecond
|
Возвращает секунды, которые содержит данный объект CTime. (от 0 до 61).
|
|
GetDayOfWeek
|
Возвращает день недели (1 - воскресенье, 2 - понедельник, и т.д.).
|
Конверторы
|
GetGmtTm
|
Разбивает объект CТime на компоненты - основываясь на UTC.
|
|
GetLocalTm
|
Разбивает объект CTime на компоненты - основываясь на локальной временной зоне (local time zone).
|
|
GetAsSystemTime
|
Переводит информацию о времени сохраненную в объекте CТime в Win32-совместимую SYSTEMTIME структуру
|
|
Format
|
Переводит объект CТime в форматированную строку - основываясь на локальной временной зоне (local time zone).
|
|
FormatGmt
|
Переводит объект CТime в форматированную строку - основываясь на UTC.
|
Операторы
|
operator =
|
Присвоить новое значение.
|
|
operator + -
|
Добавить или вычисть объекты CТimeSpan или CТime.
|
|
operator +=, -=
|
Добавить или вычисть объект CТimeSpan к или из данного объекта CТime.
|
|
operator ==, < , etc.
|
Сравнить два абсолютных значения времени.
|
Сохранение
|
operator <<
|
Вывести объект CTime в CArchive или CDumpContext.
|
|
operator >>
|
Получить объект CTime из CArchive.
|
|
