Класс QDate

Класс QDate предоставляет функции работы с датами. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Примечание: Все функции в этом классе являются реентерабельными.

Типы

Публичные функции

Статические публичные члены

Связанные нечлены

Подробное описание

Класс QDate предоставляет функции для работы с датами.

Объект QDate содержит календарную дату, т. е. год, месяц и день в григорианском календаре. Он может считывать текущую дату с системных часов. Он предоставляет функции для сравнения дат и для манипулирования датами. Например, можно прибавлять и вычитать дни, месяцы и годы к датам.

Объект QDate обычно создаётся, явно задавая год, месяц и день. Обратите внимание, что QDate интерпретирует двухзначные годы как есть, т. е. годы 0 - 99. Объект QDate также может быть создан статической функцией currentDate(), которая создаёт объект QDate, содержащий дату системных часов. Явную дату также можно установить с помощью setDate(). Функция fromString() возвращает QDate, заданную строкой и форматом даты, используемым для интерпретации даты в строке.

Функции year(), month() и day() предоставляют доступ к году, месяцу и дню. Также предоставляются функции dayOfWeek() и dayOfYear(). Та же информация предоставляется в текстовом формате функциями toString(), shortDayName(), longDayName(), shortMonthName() и longMonthName().

QDate предоставляет полный набор операторов для сравнения двух объектов QDate, где меньшее значение означает более раннюю дату, а большее — более позднюю.

Можно увеличить (или уменьшить) дату на заданное количество дней, используя addDays(). Аналогично, можно использовать addMonths() и addYears(). Функция daysTo() возвращает количество дней между двумя датами.

Функции daysInMonth() и daysInYear() возвращают количество дней в месяце и году текущей даты соответственно. Функция isLeapYear() указывает, является ли год високосным.

Год 0 отсутствует

Года 0 нет. Даты в этом году считаются недействительными. Год -1 — это год «до Рождества Христова» или «до текущей эры». День перед 1 января 1 года н. э. — 31 декабря 1 года до н. э.

Диапазон допустимых дат

Даты хранятся во внутреннем виде как число Джулиана, целочисленный счётчик каждого дня в непрерывном диапазоне, где 24 ноября 4714 года до нашей эры в григорианском календаре соответствует числу Джулиана 0 (1 января 4713 года до нашей эры в юлианском календаре). Это эффективный и точный способ хранения абсолютной даты, а также подходит для преобразования даты в другие календарные системы, такие как еврейская, исламская или китайская. Число Джулиана можно получить с помощью QDate::toJulianDay() и установить с помощью QDate::fromJulianDay().

Диапазон дат, которые может хранить QDate в виде числа Джулиана, по техническим причинам ограничен значениями от -784350574879 до 784354017364, что означает период времени от до 2 миллиардов лет до нашей эры до после 2 миллиардов лет нашей эры.

См. также QTime, QDateTime, QDateEdit, QDateTimeEdit и QCalendarWidget.

Документация по типам членов

enum QDate::MonthNameType

Этот перечисление описывает типы строкового представления для имени месяца.

Это перечисление было введено или изменено в Qt 4.5.

Документация по функциям членов

QDate::QDate()

Создаёт дату по умолчанию. Даты по умолчанию не являются валидными.

См. также isNull() и isValid().

QDate::QDate(int y, int m, int d)

Создаёт дату с годом y, месяцем m и днём d.

Если заданная дата некорректна, дата не устанавливается, и isValid() возвращает false.

Предупреждение: Годы от 1 до 99 интерпретируются непосредственно. Год 0 некорректен.

См. также isValid().

QDate QDate::addDays(qint64 ndays) const

Возвращает объект QDate с датой, отстоящей на ndays от текущей даты (или на более раннюю дату, если ndays отрицательно).

Возвращает дату по умолчанию, если текущая дата некорректна или новая дата выходит за пределы диапазона.

См. также addMonths(), addYears() и daysTo().

QDate QDate::addMonths(int nmonths) const

Возвращает объект QDate с датой, отстоящей на nmonths от текущей даты (или на более раннюю дату, если nmonths отрицательно).

Примечание: Если комбинация конечного дня/месяца не существует в полученном месяце/году, эта функция вернёт последнюю корректную дату.

См. также addDays() и addYears().

QDate QDate::addYears(int nyears) const

Возвращает объект QDate с датой, отстоящей на nyears от текущей даты (или на более раннюю дату, если nyears отрицательно).

Примечание: Если комбинация конечного дня/месяца не существует в полученном году (например, если дата была 29 февраля, а конечный год не високосный), эта функция вернёт последнюю корректную дату (то есть 28 февраля).

См. также addDays() и addMonths().

[static] QDate QDate::currentDate()

Возвращает текущую дату, согласно системным часам.

См. также QTime::currentTime() и QDateTime::currentDateTime().

int QDate::day() const

Возвращает день месяца (от 1 до 31) для этой даты.

Возвращает 0, если дата некорректна.

См. также year(), month() и dayOfWeek().

int QDate::dayOfWeek() const

Возвращает день недели (1 = понедельник, 7 = воскресенье) для этой даты.

Возвращает 0, если дата некорректна.

См. также day(), dayOfYear() и Qt::DayOfWeek.

int QDate::dayOfYear() const

Возвращает номер дня в году (от 1 до 365 или 366 в високосном году) для этой даты.

Возвращает 0, если дата некорректна.

См. также day() и dayOfWeek().

int QDate::daysInMonth() const

Возвращает количество дней в месяце (от 28 до 31) для этой даты.

Возвращает 0, если дата некорректна.

См. также day() и daysInYear().

int QDate::daysInYear() const

Возвращает количество дней в году (365 или 366) для этой даты.

Возвращает 0, если дата некорректна.

См. также day() и daysInMonth().

qint64 QDate::daysTo(const QDate &d) const

Возвращает количество дней от этой даты до даты d (отрицательное значение, если d раньше этой даты).

Возвращает 0, если одна из дат некорректна.

Пример:

QDate d1(1995, 5, 17);  // May 17, 1995
QDate d2(1995, 5, 20);  // May 20, 1995
d1.daysTo(d2);          // returns 3
d2.daysTo(d1);          // returns -3

См. также addDays().

[static] QDate QDate::fromJulianDay(qint64 jd)

Преобразует число Джулиана jd в QDate.

См. также toJulianDay().

[static] QDate QDate::fromString(const QString &string, Qt::DateFormat format = Qt::TextDate)

Возвращает QDate, представленную строкой string, используя заданный формат, или недействительную дату, если строку невозможно разобрать.

Примечание для Qt::TextDate: Рекомендуется использовать короткие английские имена месяцев (например, «Jan»). Хотя можно использовать и локализованные имена месяцев, они зависят от настроек локали пользователя.

См. также toString() и QLocale::toDate().

[static] QDate QDate::fromString(const QString &string, const QString &format)

Возвращает QDate, представленную строкой string, используя заданный формат, или недействительную дату, если строку невозможно разобрать.

Эти выражения могут использоваться для форматирования:

Все другие символы входных данных будут обрабатываться как текст. Любая последовательность символов, заключённая в одинарные кавычки, также будет обрабатываться как текст и не будет использоваться как выражение. Например:

QDate date = QDate::fromString("1MM12car2003", "d'MM'MMcaryyyy");
// date is 1 December 2003

Если формат не удовлетворён, возвращается некорректная QDate. Выражения, не ожидающие ведущих нулей (d, M), будут жадными. Это означает, что они будут использовать две цифры, даже если это выведет их за пределы допустимого диапазона значений и оставит недостаточно цифр для других разделов. Например, следующая строка форматирования могла означать 30 января, но M возьмёт две цифры, что приведёт к некорректной дате:

QDate date = QDate::fromString("130", "Md"); // invalid

Для любого поля, не представленного в формате, используются следующие значения по умолчанию:

Следующие примеры демонстрируют значения по умолчанию:

QDate::fromString("1.30", "M.d");           // January 30 1900
QDate::fromString("20000110", "yyyyMMdd");  // January 10, 2000
QDate::fromString("20000110", "yyyyMd");    // January 10, 2000

См. также toString(), QDateTime::fromString(), QTime::fromString(), и QLocale::toDate().

void QDate::getDate(int *year, int *month, int *day)

Извлекает год, месяц и день даты и присваивает их *year, *month и *day. Указатели могут быть нулевыми.

Возвращает 0, если дата недействительна.

Эта функция была введена в Qt 4.5.

См. также year(), month(), day(), и isValid().

[static] bool QDate::isLeapYear(int year)

Возвращает true, если указанный год year является високосным; в противном случае возвращает false.

bool QDate::isNull() const

Возвращает true, если дата пуста; в противном случае возвращает false. Пустая дата недействительна.

Примечание: Поведение этой функции эквивалентно isValid().

См. также isValid().

bool QDate::isValid() const

Возвращает true, если эта дата действительна; в противном случае возвращает false.

См. также isNull().

[static] bool QDate::isValid(int year, int month, int day)

Это перегруженная функция.

Возвращает true, если указанная дата (year, month и day) действительна; в противном случае возвращает false.

Пример:

QDate::isValid(2002, 5, 17);  // true
QDate::isValid(2002, 2, 30);  // false (Feb 30 does not exist)
QDate::isValid(2004, 2, 29);  // true (2004 is a leap year)
QDate::isValid(2000, 2, 29);  // true (2000 is a leap year)
QDate::isValid(2006, 2, 29);  // false (2006 is not a leap year)
QDate::isValid(2100, 2, 29);  // false (2100 is not a leap year)
QDate::isValid(1202, 6, 6);   // true (even though 1202 is pre-Gregorian)

См. также isNull() и setDate().

[static] QString QDate::longDayName(int weekday, MonthNameType type = DateFormat)

Возвращает полное название weekday для представления, заданного type.

Дни перечисляются по следующей схеме:

• 1 = "Понедельник"
• 2 = "Вторник"
• 3 = "Среда"
• 4 = "Четверг"
• 5 = "Пятница"
• 6 = "Суббота"
• 7 = "Воскресенье"

Названия дней будут локализованы в соответствии с настройками региональных параметров системы, т.е. с использованием QLocale::system().

Возвращает пустую строку, если дата недействительна.

Эта функция была введена в Qt 4.5.

См. также toString(), shortDayName(), shortMonthName(), и longMonthName().

[static] QString QDate::longMonthName(int month, MonthNameType type = DateFormat)

Возвращает полное название month для представления, заданного type.

Месяцы перечисляются по следующей схеме:

• 1 = "Январь"
• 2 = "Февраль"
• 3 = "Март"
• 4 = "Апрель"
• 5 = "Май"
• 6 = "Июнь"
• 7 = "Июль"
• 8 = "Август"
• 9 = "Сентябрь"
• 10 = "Октябрь"
• 11 = "Ноябрь"
• 12 = "Декабрь"

Названия месяцев будут локализованы в соответствии с настройками региональных параметров системы, т.е. с использованием QLocale::system().

Возвращает пустую строку, если дата недействительна.

Эта функция была введена в Qt 4.5.

См. также toString(), shortMonthName(), shortDayName(), и longDayName().

int QDate::month() const

Возвращает число, соответствующее месяцу этой даты, по следующей схеме:

• 1 = "Январь"
• 2 = "Февраль"
• 3 = "Март"
• 4 = "Апрель"
• 5 = "Май"
• 6 = "Июнь"
• 7 = "Июль"
• 8 = "Август"
• 9 = "Сентябрь"
• 10 = "Октябрь"
• 11 = "Ноябрь"
• 12 = "Декабрь"

Возвращает 0, если дата недействительна.

См. также year() и day().

bool QDate::setDate(int year, int month, int day)

Устанавливает год, месяц и день даты. Возвращает true если дата действительна; в противном случае возвращает false.

Если указанная дата недействительна, объект QDate устанавливается как недействительный.

Эта функция была введена в Qt 4.2.

См. также isValid().

[static] QString QDate::shortDayName(int weekday, MonthNameType type = DateFormat)

Возвращает короткое название weekday для представления, заданного type.

Дни перечисляются по следующей схеме:

• 1 = "Пн"
• 2 = "Вт"
• 3 = "Ср"
• 4 = "Чт"
• 5 = "Пт"
• 6 = "Сб"
• 7 = "Вс"

Названия дней будут локализованы в соответствии с настройками региональных параметров системы, т.е. с использованием QLocale::system().

Возвращает пустую строку, если дата недействительна.

Эта функция была введена в Qt 4.5.

См. также toString(), shortMonthName(), longMonthName(), и longDayName().

[static] QString QDate::shortMonthName(int month, MonthNameType type = DateFormat)

Возвращает короткое название month для представления, заданного type.

Месяцы перечисляются по следующей схеме:

• 1 = "Янв"
• 2 = "Фев"
• 3 = "Мар"
• 4 = "Апр"
• 5 = "Май"
• 6 = "Июн"
• 7 = "Июл"
• 8 = "Авг"
• 9 = "Сен"
• 10 = "Окт"
• 11 = "Ноя"
• 12 = "Дек"

Названия месяцев будут локализованы в соответствии с настройками региональных параметров системы, т.е. с использованием QLocale::system().

Возвращает пустую строку, если дата недействительна.

Эта функция была введена в Qt 4.5.

См. также toString(), longMonthName(), shortDayName(), и longDayName().

qint64 QDate::toJulianDay() const

Преобразует дату в юлианский день.

См. также fromJulianDay().

QString QDate::toString(const QString &format) const

Возвращает дату в виде строки. Параметр format определяет формат результирующей строки.

Можно использовать следующие выражения:

Все остальные символы будут проигнорированы. Любая последовательность символов, заключённых в одинарные кавычки, будет рассматриваться как текст, а не как выражение. Два последовательных одинарных кавычки ("''") заменяются одним в выводе. Форматы без разделителей (например, "ddMM") в настоящее время не поддерживаются.

Примеры форматов строк (предполагая, что QDate — 20 июля 1969 года):

Если дата недействительна, возвращается пустая строка.

См. также fromString(), QDateTime::toString(), QTime::toString(), и QLocale::toString().

QString QDate::toString(Qt::DateFormat format = Qt::TextDate) const

Это перегруженная функция.

Возвращает дату в виде строки. Параметр формат определяет формат строки.

Если формат равен Qt::TextDate, строка форматируется стандартным способом. QDate::shortDayName() и QDate::shortMonthName() используются для генерации строки, поэтому имена дней и месяцев будут локализованными, используя системную локаль, т.е. QLocale::system(). Пример такого форматирования: "Sat May 20 1995".

Если формат равен Qt::ISODate, формат строки соответствует расширенному спецификации ISO 8601 для представления дат и времени, имея вид YYYY-MM-DD, где YYYY — год, MM — месяц года (от 01 до 12), а DD — день месяца (от 01 до 31).

Если формат равен Qt::SystemLocaleShortDate или Qt::SystemLocaleLongDate, формат строки зависит от настроек локали системы. Идентично вызову QLocale::system().toString(date, QLocale::ShortFormat) или QLocale::system().toString(date, QLocale::LongFormat).

Если формат равен Qt::DefaultLocaleShortDate или Qt::DefaultLocaleLongDate, формат строки зависит от локали по умолчанию приложения. Это локаль, установленная с помощью QLocale::setDefault(), или системная локаль, если локаль по умолчанию не установлена. Идентично вызову QLocale().toString(date, QLocale::ShortFormat) или QLocale().toString(date, QLocale::LongFormat).

Если формат равен Qt::RFC2822Date, строка форматируется в формате, совместимом с RFC 2822. Пример такого форматирования: "20 May 1995".

Если дата недействительна, возвращается пустая строка.

Предупреждение: Формат Qt::ISODate действителен только для годов в диапазоне от 0 до 9999. Это ограничение может также применяться к локальным форматам, в зависимости от настроек локали.

См. также fromString(), shortDayName(), shortMonthName() и QLocale::toString().

int QDate::weekNumber(int *yearNumber = Q_NULLPTR) const

Возвращает номер недели (от 1 до 53) и сохраняет год в *yearNumber, если yearNumber не равен null (по умолчанию).

Возвращает 0, если дата недействительна.

В соответствии с ISO 8601, недели начинаются с понедельника, а первая четверг года всегда находится в неделе 1 этого года. Большинство лет имеют 52 недели, но некоторые — 53.

*yearNumber не всегда совпадает с year(). Например, 1 января 2000 года имеет номер недели 52 в году 1999, а 31 декабря 2002 года имеет номер недели 1 в году 2003.

См. также isValid().

int QDate::year() const

Возвращает год этой даты. Отрицательные числа указывают на годы до 1 года н.э. таким образом, год -44 — 44 до н.э.

Возвращает 0, если дата недействительна.

См. также month() и day().

bool QDate::operator!=(const QDate &d) const

Возвращает true если эта дата отличается от d; в противном случае возвращает false.

bool QDate::operator<(const QDate &d) const

Возвращает true если эта дата предшествует d; в противном случае возвращает false.

bool QDate::operator<=(const QDate &d) const

Возвращает true если эта дата предшествует или равна d; в противном случае возвращает false.

bool QDate::operator==(const QDate &d) const

Возвращает true если эта дата равна d; в противном случае возвращает false.

bool QDate::operator>(const QDate &d) const

Возвращает true если эта дата следует за d; в противном случае возвращает false.

bool QDate::operator>=(const QDate &d) const

Возвращает true если эта дата следует за или равна d; в противном случае возвращает false.