Класс 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 ==, | Сравнить два абсолютных значения времени. |
Сохранение
| operator | Вывести объект CTime в CArchive или CDumpContext. |
| operator >> | Получить объект CTime из CArchive. |