|
|
|
C/C++ Visual C++ >Статьи
Класс 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. |
|
