QDate Class

멤버 함수 문서

[constexpr] QDate::QDate()

null 날짜를 생성합니다. null 날짜는 유효하지 않습니다.

isNull() 및 isValid()도 참조하십시오 .

QDate date 와 동일한 날짜를 나타내는 객체를 생성합니다. 이를 통해 표준 라이브러리의 캘린더 클래스와 Qt의 datetime 클래스 간에 손쉽게 상호 운용이 가능합니다.

예를 들어:

// 23 April 2012:
QDate date = std::chrono::year_month_day(std::chrono::year(2012),
                                        std::chrono::month(4),
                                        std::chrono::day(23));

// Same, under `using std::chrono` convenience:
QDate dateWithLiterals1 = 23d / April / 2012y;
QDate dateWithLiterals2 = 2012y / April / 23;

// Last day of February 2000
QDate lastDayFeb2020 = 2000y / February / last;

// First Monday of January 2020:
QDate firstMonday = 2020y / January / Monday[0];

// Last Monday of January 2020:
QDate lastMonday = 2020y / January / Monday[last];

이 함수들은 Qt 6.4에서 도입되었습니다.

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

연도 y, 월 m, 일 d 을 가진 날짜를 생성합니다.

이 날짜는 그레고리력을 기준으로 해석됩니다. 지정된 날짜가 유효하지 않은 경우, 날짜는 설정되지 않으며 isValid()은 false 를 반환합니다.

isValid() 및 QCalendar::dateFromParts()도 참조하십시오 .

QDate QDate::addDays(qint64 ndays) const

이 객체의 날짜보다 늦은 날짜 ndays 를 포함하는 ` QDate ` 객체를 반환합니다( ndays 가 음수인 경우 더 이른 날짜를 반환합니다).

현재 날짜가 유효하지 않거나 새 날짜가 허용 범위를 벗어난 경우 null 날짜를 반환합니다.

addMonths(), addYears(), daysTo()도 참조하십시오 .

[since 6.4] QDate QDate::addDuration(std::chrono::days ndays) const

이 객체의 날짜보다 늦은 날짜 ndays 를 포함하는 ` QDate ` 객체를 반환합니다( ndays 가 음수인 경우 더 이른 날짜).

현재 날짜가 유효하지 않거나 새 날짜가 범위를 벗어난 경우 null 날짜를 반환합니다.

이 함수는 Qt 6.4에서 도입되었습니다.

addMonths(), addYears(), daysTo()도 참조하십시오 .

QDate QDate::addMonths(int nmonths, QCalendar cal) const

이 객체의 날짜보다 늦은 날짜 nmonths 를 포함하는 QDate 객체를 반환합니다( nmonths 가 음수인 경우 더 이른 날짜).

cal 가 지정된 경우 이를 달력으로 사용하며, 그렇지 않으면 그레고리력을 사용합니다.

addDays() 및 addYears()도 참조하십시오 .

QDate QDate::addMonths(int nmonths) const

QDate QDate::addYears(int nyears, QCalendar cal) const

이 객체의 날짜보다 늦은 날짜 nyears 를 포함하는 QDate 객체를 반환합니다( nyears 가 음수인 경우 더 이른 날짜).

cal 가 지정된 경우 이를 달력으로 사용하며, 그렇지 않으면 그레고리력을 사용합니다.

addDays() 및 addMonths()도 참조하십시오 .

QDate QDate::addYears(int nyears) const

[static] QDate QDate::currentDate()

시스템 시계의 현재 날짜를 반환합니다.

QTime::currentTime() 및 QDateTime::currentDateTime()도 참조하십시오 .

int QDate::day(QCalendar cal) const

이 날짜의 월 내 일수를 반환합니다.

cal 가 지정된 경우 이를 달력으로 사용하며, 그렇지 않으면 그레고리력(반환 값은 1부터 31까지)을 사용합니다. 날짜가 유효하지 않은 경우 0을 반환합니다.

year(), month(), dayOfWeek(), QCalendar::partsFromDate()도 참조하십시오 .

int QDate::day() const

int QDate::dayOfWeek(QCalendar cal) const

이 날짜에 해당하는 요일(1 = 월요일 ~ 7 = 일요일)을 반환합니다.

cal 가 지정된 경우 이를 달력으로 사용하며, 그렇지 않으면 그레고리력을 사용합니다. 날짜가 유효하지 않은 경우 0을 반환합니다. 일부 달력에서는 7보다 큰 값에 특별한 의미(예: 윤일)를 부여할 수 있습니다.

day(), dayOfYear(), QCalendar::dayOfWeek(), Qt::DayOfWeek도 참조하십시오 .

int QDate::dayOfWeek() const

int QDate::dayOfYear(QCalendar cal) const

이 날짜에 해당하는 연중 일수(첫째 날은 1)를 반환합니다.

cal 가 지정된 경우 이를 달력으로 사용하며, 그렇지 않으면 그레고리력을 사용합니다. 날짜나 해당 연도의 첫 번째 날이 유효하지 않은 경우 0을 반환합니다.

day(), dayOfWeek(), QCalendar::daysInYear()도 참조하십시오 .

int QDate::dayOfYear() const

int QDate::daysInMonth(QCalendar cal) const

이 날짜가 속한 달의 일수를 반환합니다.

cal 가 지정된 경우 이를 달력으로 사용하며, 그렇지 않으면 그레고리력(이 경우 결과 값은 28에서 31 사이)을 사용합니다. 날짜가 유효하지 않은 경우 0을 반환합니다.

day(), daysInYear(), QCalendar::daysInMonth(), QCalendar::maximumDaysInMonth(), QCalendar::minimumDaysInMonth()도 참조하십시오 .

int QDate::daysInMonth() const

int QDate::daysInYear(QCalendar cal) const

이 날짜가 속한 해의 일수를 반환합니다.

cal 가 지정된 경우 이를 달력으로 사용하며, 그렇지 않으면 그레고리력(이 경우 결과는 365 또는 366입니다)을 사용합니다. 날짜가 유효하지 않은 경우 0을 반환합니다.

day(), daysInMonth(), QCalendar::daysInYear(), QCalendar::maximumMonthsInYear()도 참조하십시오 .

int QDate::daysInYear() const

qint64 QDate::daysTo(QDate d) const

현재 날짜부터 d 까지의 일수를 반환합니다.

이는 ` d.toJulianDay() - toJulianDay()`와 동일합니다. ` 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()도 참조하십시오 .

QDateTime QDate::endOfDay(const QTimeZone &zone) const

해당 날의 종료 시각을 반환합니다.

하루가 끝나는 시점은 시간 표현 방식에 따라 달라집니다. 서쪽 시간대에 있는 사용자에게는 하루가 더 일찍 시작하고 끝나며, 동쪽 시간대에 있는 사용자에게는 더 늦게 시작하고 끝납니다. 사용할 시간 표현 방식은 선택적 시간 zone 을 통해 지정할 수 있습니다. 기본 시간 표현 방식은 시스템의 현지 시간입니다.

일반적으로 하루의 끝은 자정 24:00보다 1밀리초 앞선 시각입니다. 그러나 시간대 변경으로 인해 지정된 날짜가 해당 시점을 건너뛰는 경우(예: 23:00과 그 다음 시간을 건너뛰는 일광 절약 시간제(DST) 봄 시간 조정), 해당 날의 실제 가장 늦은 시간이 반환됩니다. 이는 시간 표현 방식이 시간대 또는 현지 시간일 때만 발생할 수 있습니다.

zone 의 timeSpec()이 Qt::OffsetFromUTC 또는 Qt::UTC 인 경우, 시간 표현에는 전환이 없으므로 하루의 끝은 QTime(23, 59, 59, 999)입니다.

드물게 날짜가 완전히 건너뛴 경우(이는 국제 날짜 변경선 동쪽에 있던 시간대가 서쪽으로 바뀌는 경우 발생함), 반환된 결과는 유효하지 않습니다. zone 와 같이 유효하지 않은 시간대를 전달하거나, QDateTime 로 표현할 수 있는 범위 밖에서 끝나는 날짜를 전달하는 경우에도 유효하지 않은 결과가 반환됩니다.

startOfDay()도 참조하십시오 .

[since 6.5] QDateTime QDate::endOfDay() const

이 함수는 Qt 6.5에서 도입되었습니다.

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

율리우스일 jd 을 QDate 로 변환합니다.

toJulianDay()도 참조하십시오 .

[static constexpr noexcept, since 6.4] QDate QDate::fromStdSysDays(const std::chrono::sys_days &days)

1970년 1월 1일(유닉스 에포크)로부터 days 일 후의 날짜를 ` QDate ` 형식으로 반환합니다. ` days `가 음수인 경우, 반환되는 날짜는 에포크 이전이 됩니다.

이 함수는 Qt 6.4에서 도입되었습니다.

toStdSysDays()도 참조하십시오 .

[static] QDate QDate::fromString(const QString &string, const QString &format, int baseYear, QCalendar cal)

string 로 표현된 QDate 를, 지정된 format 를 사용하여 반환하며, 문자열을 파싱할 수 없는 경우에는 유효하지 않은 날짜를 반환합니다.

cal 가 제공된 경우 이를 달력으로 사용하며, 그렇지 않으면 그레고리력을 사용합니다. 아래 형식 설명에 명시된 값의 범위는 그레고리력에 대한 것이며, 다른 달력의 경우 다를 수 있습니다.

다음 표현식을 형식에 사용할 수 있습니다:

작은 따옴표로 묶인 비어 있지 않은 문자열은 (따옴표를 제거한 후) 표현식으로 해석되지 않고 텍스트로 처리됩니다. 연속된 두 개의 작은 따옴표("''")는 문자 그대로의 시퀀스를 시작하거나 끝내는 것이 아니라, 입력과 일치해야 할 작은 따옴표 하나로 인식됩니다. 그 외의 모든 입력 문자는 입력 문자열에서 일치해야 할 문자 그대로의 텍스트로 처리됩니다. 예:

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

형식이 충족되지 않으면 무효한 ` QDate `가 반환됩니다.

숫자 필드가 나란히 배치되어 있고, 숫자 시퀀스를 구분하는 구분자가 없는 경우, 한 자릿수로 허용되는 일부 필드가 두 자릿수를 사용하는지(표현할 값이 9보다 크기 때문)에 대한 모호성이 발생할 수 있습니다. 이러한 필드에 두 자릿수를 할당할 경우 다른 필드에 할당할 자릿수가 너무 부족해지고, 한 자릿수 표기가 다른 필드들과 일관성이 있다면 이 모호성을 해소할 수 있습니다. 그렇지 않은 경우(하나 이상의 필드가 한 자리수만 허용되지만 각 필드에 한 자리수만 할당해도 여분의 자릿수가 남는 경우), 데이터의 일관성이 유지된다는 전제 하에, 뒤쪽 필드보다 앞쪽 필드에 여분의 자릿수를 할당하는 해결 방식이 선호됩니다. 예를 들어:

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

해당 형식으로 표현되지 않는 필드의 경우 다음 기본값이 사용됩니다:

format 가 연도의 마지막 두 자리만 지정하는 경우, baseYear 부터 시작하는 100년 단위가 우선적으로 고려되는 후보입니다. 6.7 버전 이전에는 ` baseYear ` 매개변수가 없었으며, 항상 1900년이 사용되었습니다. 이는 ` baseYear`의 기본값으로, 해당 연도부터 1999년까지의 연도를 선택합니다. 예를 들어, ` baseYear `로 1976을 전달하면 1976년부터 2075년까지의 연도가 선택됩니다. 형식에 월, 일(월 내 날짜), 요일도 포함된 경우, 이 정보만으로도 세기를 암시하기에 충분합니다. 이러한 경우, baseYear 로 지정한 세기와 가장 가까운 세수에서 일치하는 날짜가 선택되며, 더 이른 시기보다는 더 늦은 시기가 우선적으로 고려됩니다. 자세한 내용은 QCalendar::matchCenturyToWeekday() 및 Date ambiguities 를 참조하십시오.

다음 예제는 기본값을 보여줍니다:

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

날짜의 모호성

문화에 따라 날짜 형식이 다르기 때문에, 사용자가 날짜 필드의 순서를 혼동할 수 있습니다. 예를 들어, "Wed 28-Nov-01" 는 2028년 11월 1일 또는 2001년 11월 28일(둘 다 수요일입니다)을 의미할 수 있습니다. "ddd yy-MMM-dd" 형식을 사용하면 첫 번째 방식으로 해석되고, "ddd dd-MMM-yy" 형식을 사용하면 두 번째 방식으로 해석됩니다. 그러나 사용자가 의도한 바는 코드가 예상한 형식보다는 사용자가 평소 날짜를 표기하는 방식에 따라 달라질 수 있습니다.

위에서 살펴본 예시에서는 월의 날짜와 두 자리 연도가 혼동되었습니다. 월과 날짜가 모두 숫자로 표기될 때, 이 둘이 뒤바뀌는 것과 유사한 혼동이 발생할 수 있습니다. 이러한 경우, 날짜 형식에 요일 필드를 포함하면 일정한 중복성을 제공하여 이러한 종류의 오류를 포착하는 데 도움이 될 수 있습니다. 그러나 위 예시에서 보듯이, 이것이 항상 효과적인 것은 아닙니다. 두 필드(또는 그 의미)가 서로 바뀐다고 해도 요일이 동일한 날짜가 생성될 수 있기 때문입니다.

날짜 형식에 요일을 포함하면 연도의 마지막 두 자리만 사용하여 지정된 날짜의 세기를 명확히 할 수도 있습니다. 안타깝게도, 사용자(또는 다른 데이터 출처)가 두 필드를 혼동하여 입력한 날짜와 결합될 경우, 이러한 해결 방식은 형식의 해석과는 일치하지만 작성자가 의도한 날짜와는 다른 날짜를 찾아내는 결과를 초래할 수 있습니다. 마찬가지로, 사용자가 그 외에는 올바른 날짜에서 단순히 요일을 잘못 입력한 경우에도 다른 세기의 날짜로 해석될 수 있습니다. 두 경우 모두, 다른 세기의 날짜를 찾아내는 것은 잘못 입력된 날짜를 완전히 다른 날짜로 바꿔버릴 수 있습니다.

날짜의 모호성을 피하는 가장 좋은 방법은 4자리 연도와 월명을(전체 또는 약어 형태로) 사용하는 것이며, 이상적으로는 사용자가 날짜의 어느 부분을 선택하고 있는지 명확히 알 수 있도록 설계된 사용자 인터페이스 관례를 통해 데이터를 수집하는 것입니다. 요일을 포함하는 것도 데이터의 일관성을 확인할 수 있는 수단을 제공함으로써 도움이 될 수 있습니다. 데이터가 사용자로부터 제공되고, 사용자가 선택한 로케일에 따라 형식이 지정되는 경우, 짧은 형식은 연도를 두 자리로 표기할 가능성이 높으므로 긴 형식을 사용하는 것이 가장 좋습니다. 물론 형식을 항상 제어할 수 있는 것은 아닙니다. 예를 들어, 데이터가 제어할 수 없는 출처에서 제공될 수도 있습니다.

이러한 혼란의 원인이 될 수 있는 요소들, 특히 모호하지 않은 형식이 사용되고 있는지 확신할 수 없는 경우, 문자열을 날짜로 해석한 결과가 단순히 유효할 뿐만 아니라 제공된 목적에 부합하는지 확인하는 것이 중요합니다. 결과가 합리적인 값의 범위를 벗어난다면, 사용자가 오류를 쉽게 파악할 수 있도록 문자열에서 읽은 날짜를 월명과 4자리 연도가 포함된 긴 형식으로 표시하여 날짜 선택을 확인하도록 요청하는 것이 좋습니다.

toString(), QDateTime::fromString(), QTime::fromString(), QLocale::toDate()도 참조하십시오 .

[static, since 6.0] QDate QDate::fromString(QStringView string, Qt::DateFormat format = Qt::TextDate)

이 함수는 Qt 6.0에서 도입되었습니다.

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

string 로 표현된 QDate 를, 지정된 format 를 사용하여 반환하며, 문자열을 구문 분석할 수 없는 경우에는 유효하지 않은 날짜를 반환합니다.

Qt::TextDate 에 대한 참고 사항: 영어 월 이름(예: 약식 "Jan" 또는 장식형 "January")만 인식됩니다.

toString() 및 QLocale::toDate()도 참조하십시오 .

[static, since 6.0] QDate QDate::fromString(QStringView string, QStringView format, QCalendar cal)

이 함수는 Qt 6.0에서 도입되었습니다.

[static, since 6.7] QDate QDate::fromString(QStringView string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

기본 생성된 ` QCalendar`를 사용합니다.

이 함수는 Qt 6.7에서 도입되었습니다.

[static, since 6.0] QDate QDate::fromString(const QString &string, QStringView format, QCalendar cal)

이 함수는 Qt 6.0에서 도입되었습니다.

[static, since 6.7] QDate QDate::fromString(const QString &string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

기본 생성된 ` QCalendar`를 사용합니다.

이 함수는 Qt 6.7에서 도입되었습니다.

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

[static, since 6.7] QDate QDate::fromString(const QString &string, const QString &format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

기본 생성된 ` QCalendar`를 사용합니다.

이 함수는 Qt 6.7에서 도입되었습니다.

[static, since 6.7] QDate QDate::fromString(QStringView string, QStringView format, int baseYear, QCalendar cal)

이 함수는 Qt 6.7에서 도입되었습니다.

[static, since 6.0] QDate QDate::fromString(const QString &string, QStringView format, int baseYear, QCalendar cal)

이 함수는 Qt 6.0에서 도입되었습니다.

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

날짜의 연도, 월, 일을 추출하여 각각 *year, *month, *day 에 할당합니다. 포인터는 NULL일 수 있습니다.

날짜가 유효하지 않은 경우 0을 반환합니다.

참조: year(), month(), day(), isValid() 및 QCalendar::partsFromDate().

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

지정된 날짜( year )가 그레고리력에서 윤년인 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

QCalendar::isLeapYear()도 참조하십시오 .

[constexpr] bool QDate::isNull() const

날짜가 null인 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다. null인 날짜는 유효하지 않습니다.

참조: isValid()도 참조하십시오 .

[constexpr] bool QDate::isValid() const

이 날짜가 유효하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

isNull() 및 QCalendar::isDateValid()도 참조하십시오 .

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

지정된 날짜(year, month, day)가 그레고리력에서 유효한 경우 true 를 반환하고, 그렇지 않은 경우 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() 및 QCalendar::isDateValid()도 참조하십시오 .

int QDate::month(QCalendar cal) const

지정된 날짜의 월 번호를 반환합니다.

연도의 월 번호는 첫 번째 달부터 1로 시작합니다. cal 가 지정된 경우 해당 달력을 사용하며, 그렇지 않으면 그레고리력을 사용합니다. 그레고리력의 월 번호 체계는 다음과 같습니다:

• 1 = "1월"
• 2 = "2월"
• 3 = "3월"
• 4 = "4월"
• 5 = "5월"
• 6 = "6월"
• 7 = "7월"
• 8 = "8월"
• 9 = "9월"
• 10 = "10월"
• 11 = "11월"
• 12 = "12월"

날짜가 유효하지 않은 경우 0을 반환합니다. 일부 달력에서는 특정 연도에 12개월 이상이 포함될 수 있다는 점에 유의하십시오.

year(), day(), QCalendar::partsFromDate()도 참조하십시오 .

int QDate::month() const

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

이 함수는 주어진 year, month 및 day 값을 사용하여 그레고리력 기준의 날짜를 나타내도록 설정합니다. 결과 날짜가 유효하면 true를 반환하고, 그렇지 않으면 이 변수를 유효하지 않은 날짜를 나타내도록 설정하고 false를 반환합니다.

isValid() 및 QCalendar::dateFromParts()도 참조하십시오 .

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

이 메서드는 주어진 달력 cal 에서, 주어진 year, month 및 day 값을 사용하여 날짜를 표현하도록 이 객체를 설정합니다. 결과 날짜가 유효하면 true를 반환하고, 그렇지 않으면 이 객체를 유효하지 않은 날짜를 표현하도록 설정하고 false를 반환합니다.

isValid() 및 QCalendar::dateFromParts()도 참조하십시오 .

QDateTime QDate::startOfDay(const QTimeZone &zone) const

해당 날의 시작 시점을 반환합니다.

하루가 언제 시작되는지는 시간 표기 방식에 따라 달라집니다. 서쪽 시간대에 있는 사람들에게는 하루가 더 일찍 시작되고 끝나며, 동쪽 시간대에 있는 사람들에게는 더 늦게 시작되고 끝납니다. 사용할 시간 표기 방식은 선택적 시간 zone 로 지정할 수 있습니다. 기본 시간 표기 방식은 시스템의 현지 시간입니다.

일반적으로 하루의 시작은 자정인 00:00입니다. 그러나 시간대 변경으로 인해 지정된 날짜가 해당 자정을 건너뛰는 경우(예: 일광 절약 시간제(DST)의 봄철 시간 조정으로 인해 하루의 첫 번째 시간을 건너뛰는 경우), 해당 날의 실제 가장 이른 시간이 반환됩니다. 이는 시간 표현이 시간대 또는 현지 시간인 경우에만 발생할 수 있습니다.

zone 의 timeSpec()이 Qt::OffsetFromUTC 또는 Qt::UTC 인 경우, 시간 표현에는 전환이 없으므로 하루의 시작은 QTime(0, 0)입니다.

날짜가 완전히 건너뛴 드문 경우(이는 국제 날짜 변경선 동쪽에 있던 시간대가 서쪽으로 바뀌는 경우 발생함)에는 반환값이 유효하지 않습니다. zone 에 유효하지 않은 시간대를 전달하거나, QDateTime 로 표현 가능한 범위 밖에서 시작하는 날짜를 전달하는 경우에도 유효하지 않은 결과가 반환됩니다.

endOfDay()도 참조하십시오 .

[since 6.5] QDateTime QDate::startOfDay() const

이 함수는 Qt 6.5에서 도입되었습니다.

[constexpr] qint64 QDate::toJulianDay() const

날짜를 율리우스일로 변환합니다.

fromJulianDay()도 참조하십시오 .

[constexpr noexcept] std::chrono::sys_days QDate::toStdSysDays() const

1970년 1월 1일(유닉스 에포크)과 이 날짜 사이의 일수를 ` std::chrono::sys_days ` 객체로 반환합니다. 이 날짜가 에포크 이전인 경우, 일수는 음수가 됩니다.

fromStdSysDays() 및 daysTo()도 참조하십시오 .

날짜를 문자열로 반환합니다. ` format ` 매개변수는 결과 문자열의 형식을 결정합니다. ` cal `가 지정되면, 날짜를 표현하는 데 사용되는 달력을 결정하며, 기본값은 그레고리력입니다. Qt 5.14 이전 버전에서는 ` cal ` 매개변수가 없었으며, 항상 그레고리력이 사용되었습니다.

format 매개변수에는 다음 표현식을 사용할 수 있습니다:

작은 따옴표로 묶인 비어 있지 않은 문자열은 서식 지정 문자가 포함되어 있더라도 출력 문자열에 그대로 포함됩니다(따옴표는 제거됨). 연속된 두 개의 작은따옴표("''")는 출력 시 리터럴 시퀀스의 시작이나 끝을 나타내는 것이 아니라, 하나의 작은따옴표로 대체됩니다. 서식 문자열에 포함된 그 외의 모든 문자는 출력 문자열에 그대로 포함됩니다.

구분 기호가 없는 형식(예: "ddMM")도 지원되지만, 결과 문자열이 항상 명확하게 읽히지는 않으므로 주의해서 사용해야 합니다(예: "dM"이 "212"를 생성하는 경우, 이는 12월 2일을 의미할 수도 있고 2월 21일을 의미할 수도 있습니다).

포맷 문자열 예시( QDate 가 1969년 7월 20일이라고 가정할 경우):

날짜 및 시간이 유효하지 않은 경우, 빈 문자열이 반환됩니다.

fromString(), QDateTime::toString(), QTime::toString(), QLocale::toString()도 참조하십시오 .

QString QDate::toString(QStringView format) const

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

날짜를 문자열로 반환합니다. ‘ format ’ 매개변수는 문자열의 서식을 결정합니다.

format 가 ` Qt::TextDate`인 경우, 문자열은 기본 형식으로 표시됩니다. 요일 및 월 이름은 영어로 표시됩니다. 이 형식의 예로는 "Sat May 20 1995"가 있습니다. 지역화된 형식에 대해서는 ` QLocale::toString()`를 참조하십시오.

format 가 Qt::ISODate 인 경우, 문자열 형식은 날짜 및 시간 표기를 위한 ISO 8601 확장 사양에 따르며, yyyy-MM-dd 형식을 취합니다. 여기서 yyyy는 연도, MM은 해당 연도의 월(01에서 12 사이), dd는 01에서 31 사이의 월 내 일수를 나타냅니다.

format 가 Qt::RFC2822Date 인 경우, 문자열은 RFC 2822와 호환되는 방식으로 포맷팅됩니다. 이 포맷의 예로는 "20 May 1995"가 있습니다.

날짜가 유효하지 않은 경우, 빈 문자열이 반환됩니다.

fromString() 및 QLocale::toString()도 참조하십시오 .

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

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

ISO 8601 주 번호(1~53)를 반환합니다.

날짜가 유효하지 않은 경우 0을 반환합니다. 그렇지 않으면 해당 날짜의 주 번호를 반환합니다. ` yearNumber `가 ` nullptr `(기본값)가 아닌 경우, 연도를 `*yearNumber` 형식으로 저장합니다.

ISO 8601에 따라, 각 주는 그레고리력에서 해당 주의 날짜 대부분이 속하는 해에 포함됩니다. ISO 8601의 주는 월요일부터 시작하므로, 이는 해당 주의 목요일이 속하는 해를 의미합니다. 대부분의 해는 52주이지만, 일부 해는 53주입니다.

isValid()항목도 참조하십시오 .

int QDate::year(QCalendar cal) const

이 날짜의 연도를 반환합니다.

cal 가 지정된 경우 이를 달력으로 사용하며, 그렇지 않으면 그레고리력을 사용합니다.

날짜가 유효하지 않은 경우 0을 반환합니다. 일부 달력의 경우, 첫 해 이전의 날짜는 모두 유효하지 않을 수 있습니다.

연도 0이 있는 달력을 사용하는 경우, 반환값이 0이면 isValid()을 사용하여 확인하십시오. 이러한 달력은 연도 1 앞에 연도 0이 오고, 그 앞에 연도 -1이 오는 등, 명백한 방식으로 음수 연도 번호를 사용합니다.

일부 달력은 0년이 없음에도 불구하고, 첫 해 이전의 연도를 1부터 거꾸로 세는 관례적인 번호 체계를 따릅니다. 예를 들어, 프로레프틱 그레고리력에서는 서기 1년(첫 해) 이전의 연도를 차례로 서기 전 1년, 서기 전 2년, 서기 전 3년 등으로 표기합니다. 이러한 달력에서는 1년 이전의 연도를 나타내기 위해 음수 연도 번호를 사용하며, -1은 1년 전을 의미합니다.

month(), day(), QCalendar::hasYearZero(), QCalendar::isProleptic(), QCalendar::partsFromDate()도 참조하십시오 .

int QDate::year() const