Поделиться через

CTime::CTime

  • Статья

Создает новый объект CTime инициализированный заданным временем.

CTime( ) throw( ); 
CTime( 
   __time64_t time  
) throw( ); 
CTime( 
   int nYear, 
   int nMonth, 
   int nDay, 
   int nHour, 
   int nMin, 
   int nSec,
   int nDST = -1  
); 
CTime( 
   WORD wDosDate, 
   WORD wDosTime, 
   int nDST = -1  
); 
CTime( 
   const SYSTEMTIME& st, 
   int nDST = - 1  
) throw( ); 
CTime( 
   const FILETIME& ft, 
   int nDST = - 1  
); 
CTime( 
   const DBTIMESTAMP& dbts, 
   int nDST = -1 
) throw( );

Параметры

  • timeSrc
    Указывает объект CTime, который уже существует.

  • time
    Значение времени __time64_t, номер время в формате UTC секунд после 1-ого января 1970. Обратите внимание, что это будет изменяется в местное время. Например, если в Йорке new и создать объект CTime, передавая параметр равен 0, то CTime::GetMonth возвращает 12.

    В версиях Visual C++ 6,0 и более ранних версиях time было значением time_t. Visual C++ .NET и более поздних новообращенные параметр time_t к __time64_t.

  • nYear, nMonth, nDay, nHour, nMin, nSec
    Отображает дату и время для копирования в новый объект CTime.

  • nDST
    Указывает, является ли время сохранения дневного источника света в силу. Может иметь одно из значений: 3

    • nDST, для начала до 0.

    • nDST задает значение, большее 0 раз сохранении дневного источника света в силу.

    • nDST, для которых значение меньше 0 по умолчанию. Ли автоматически вычисляет стандартное время сохранения или дневного источника света в силу.

  • wDosDate, wDosTime
    Значения даты и времени, MS-DOS, которое необходимо преобразовать в значение даты-времени и скопированные в новый CTime объект.

  • st
    Структура SYSTEMTIME для преобразования в значение даты-времени и CTime скопированную в новый объект.

  • ft
    Структура FILETIME для преобразования в значение даты-времени и CTime скопированную в новый объект.

  • dbts
    Ссылка на структуру DBTimeStamp, содержащий текущее местное время.

Заметки

Каждый конструктор описан ниже.

  • CTime( ); Создает объект CTime неинициализированным. Этот конструктор позволяет указать массивы объектов CTime. Необходимо инициализировать такие массивы с допустимым временем перед использованием.

  • CTime( const CTime& ); Создает объект CTime из другого значения CTime.

  • CTime( __time64_t ); Создает объект CTime от типа __time64_t. Этот конструктор ожидает время в формате UTC в местное время и преобразовать результат перед сохранением результат.

  • CTime( int, int,...); Создает объект CTime из компонентов локального времени с каждым ограниченный компонент следующим диапазонам:

    Компонент

    Диапазон

    nYear

    1970–3000

    nMonth

    1–12

    nDay

    1–31

    nHour

    0-23

    nMin

    0-59

    nSec

    0-59

    Этот конструктор создает соответствующее преобразование во времени в формате UTC. Отладочная версия библиотеки Microsoft Foundation Class утверждает, если один или несколько из компонентов времени выходит за пределы допустимого диапазона. Необходимо проверять аргументы до вызова. Этот конструктор ожидает локальное время.

  • CTime( WORD, WORD ); создает объект CTime из заданных дат и значений времени MS-DOS. Этот конструктор ожидает локальное время.

  • CTime( const SYSTEMTIME& ); создает объект CTime из структуры SYSTEMTIME. Этот конструктор ожидает локальное время.

  • CTime( const FILETIME& ); создает объект CTime из структуры FILETIME. Наиболее вероятного вы не будете использовать инициализацию CTimeFILETIME напрямую. Если используется объект CFile управлять файл, то CFile::GetStatus извлекает отметка времени файла для пользователя через объект CTime инициализированный с использованием структуры FILETIME. Этот конструктор требует времени на основе времени в формате UTC и автоматически преобразует значение в местное время перед сохранением результат.

    Примечание

    Конструктор DBTIMESTAMP используя параметр доступен, только если OLEDB.h включается.

Дополнительные сведения см. в разделе макет SYSTEMTIME и FILETIME в Windows SDK. См. также запись Дата и время MS-DOS в Windows SDK.

Пример

time_t osBinaryTime;  // C run-time time (defined in <time.h>)
time(&osBinaryTime) ;  // Get the current time from the  
                         // operating system.
CTime time1; // Empty CTime. (0 is illegal time value.)
CTime time2 = time1; // Copy constructor.
CTime time3(osBinaryTime);  // CTime from C run-time time
CTime time4(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999

Требования

Header: atltime.h

См. также

Ссылки

CTime Class

Диаграмма иерархии

CTime::GetTime

CTime::GetCurrentTime

CTime::operator =