Объект 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.