QDateTime Class

멤버 함수 문서

QDateTime::QDateTime(QDate date, QTime time, const QTimeZone &timeZone, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

timeZone 에 설명된 시간 표기법을 사용하여, 주어진 date 및 time 를 바탕으로 datetime 객체를 생성합니다.

date 가 유효하고 time 가 유효하지 않은 경우, 시간은 자정으로 설정됩니다. timeZone 가 유효하지 않은 경우, datetime은 유효하지 않게 됩니다. date 및 time 가 timeZone 의 전환 시점에 가까운 순간을 나타내는 경우, resolve 는 해당 상황이 어떻게 해결될지를 제어합니다.

[noexcept] QDateTime::QDateTime()

명목상 현지 시간을 사용하여 null 날짜/시간을 생성합니다.

null 날짜/시간은 날짜와 시간이 유효하지 않으므로 유효하지 않습니다.

isValid(), setMSecsSinceEpoch(), setDate(), setTime(), setTimeZone()도 참조하십시오 .

[since 6.5] QDateTime::QDateTime(QDate date, QTime time, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

지정된 date 및 time 값을 사용하여 현지 시간을 기준으로 날짜/시간 객체를 생성합니다.

date 이 유효하고 time 이 유효하지 않은 경우, 자정이 시간으로 사용됩니다. date 과 time 이 현지 시간의 전환 시점과 가까운 순간을 나타내는 경우, resolve 는 해당 상황을 어떻게 해결할지 제어합니다.

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

[noexcept] QDateTime::QDateTime(const QDateTime &other)

other 의 날짜/시간 값의 복사본을 생성합니다.

[noexcept] QDateTime::QDateTime(QDateTime &&other)

임시 객체 other 의 datetime 내용을 이 객체로 옮기고, other 을 정의되지 않은(그러나 올바른) 상태로 남겨둡니다.

[noexcept] QDateTime::~QDateTime()

datetime를 삭제합니다.

QDateTime QDateTime::addDays(qint64 ndays) const

이 객체의 날짜/시간보다 ndays 일 후( ndays 가 음수인 경우 그 이전)의 날짜/시간을 포함하는 QDateTime 객체를 반환합니다.

timeSpec()의 값이 Qt::LocalTime 이거나 Qt::TimeZone 이고, 결과 날짜 및 시간이 표준시에서 일광 절약 시간으로 전환되는 시간에 해당할 경우, 결과는 변경 방향으로 이 간격을 약간 넘은 시점이 됩니다. 전환 시각이 오전 2시이고 시계가 오전 3시로 앞당겨지는 경우, 오전 2시와 오전 3시 사이를 목표로 한 결과는 오전 2시 이전( ndays < 0 인 경우) 또는 오전 3시 이후(그 외의 경우)로 조정됩니다.

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

[since 6.4] QDateTime QDateTime::addDuration(std::chrono::milliseconds msecs) const

이 객체의 날짜/시간보다 msecs 밀리초 늦은 ( msecs 가 음수인 경우 더 이른) 날짜/시간을 포함하는 QDateTime 객체를 반환합니다.

이 datetime이 유효하지 않은 경우, 유효하지 않은 datetime이 반환됩니다.

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

addMSecs(), msecsTo(), addDays(), addMonths() 및 addYears()도 참조하십시오 .

QDateTime QDateTime::addMSecs(qint64 msecs) const

이 객체의 날짜/시간보다 msecs 밀리초 늦은( msecs 가 음수인 경우 더 이른) 날짜/시간을 포함하는 QDateTime 객체를 반환합니다.

이 날짜/시간이 유효하지 않은 경우, 유효하지 않은 날짜/시간이 반환됩니다.

addSecs(), msecsTo(), addDays(), addMonths() 및 addYears()도 참조하십시오 .

QDateTime QDateTime::addMonths(int nmonths) const

이 객체의 날짜/시간보다 nmonths 개월 뒤의 날짜/시간( nmonths 가 음수인 경우 더 이른 시점)을 포함하는 QDateTime 객체를 반환합니다.

timeSpec()이 Qt::LocalTime 또는 Qt::TimeZone 이고, 결과 날짜 및 시간이 표준시에서 일광절약시간으로 전환되는 시간에 해당할 경우, 결과는 변경 방향으로 이 간격을 약간 넘어선 시점이 됩니다. 전환 시각이 오전 2시이고 시계가 오전 3시로 앞당겨진다면, 오전 2시와 오전 3시 사이를 목표로 한 결과는 오전 2시 이전( nmonths < 0 인 경우) 또는 오전 3시 이후(그 외의 경우)로 조정됩니다.

daysTo(), addDays(), addYears(), addSecs(), Timezone transitions도 참조하십시오 .

QDateTime QDateTime::addSecs(qint64 s) const

이 객체의 날짜/시간보다 s 초 후( s 가 음수인 경우 그 이전)의 날짜/시간을 포함하는 ` QDateTime ` 객체를 반환합니다.

이 datetime이 유효하지 않은 경우, 유효하지 않은 datetime이 반환됩니다.

addMSecs(), secsTo(), addDays(), addMonths() 및 addYears()도 참조하십시오 .

QDateTime QDateTime::addYears(int nyears) const

이 객체의 날짜/시간보다 nyears 년 후의 날짜/시간을 포함하는 QDateTime 객체를 반환합니다( nyears 가 음수인 경우 그 이전의 날짜/시간을 반환합니다).

timeSpec()이 Qt::LocalTime 또는 Qt::TimeZone 이고, 결과 날짜 및 시간이 표준시에서 일광 절약 시간으로 전환되는 시간에 해당할 경우, 결과는 변경 방향으로 이 간격을 약간 넘은 시점이 됩니다. 전환 시각이 오전 2시이고 시계가 오전 3시로 앞당겨진다면, 오전 2시와 오전 3시 사이를 목표로 한 결과는 ( nyears < 0 인 경우) 오전 2시 이전으로, 그렇지 않은 경우 오전 3시 이후로 조정됩니다.

daysTo(), addDays(), addMonths(), addSecs(), Timezone transitions도 참조하십시오 .

[static, since 6.5] QDateTime QDateTime::currentDateTime(const QTimeZone &zone)

zone 에 설명된 시간 표기법을 사용하여 시스템 시계의 현재 날짜 및 시간을 반환합니다. zone 를 생략하면 현지 시간이 사용됩니다.

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

currentDateTimeUtc(), QDate::currentDate(), QTime::currentTime(), toTimeZone()도 참조하십시오 .

[static] QDateTime QDateTime::currentDateTime()

[static] QDateTime QDateTime::currentDateTimeUtc()

시스템 시계의 현재 날짜와 시간을 UTC 형식으로 반환합니다.

currentDateTime(QTimeZone::UTC) 와 동일합니다.

currentDateTime(), QDate::currentDate(), QTime::currentTime(), toTimeZone()도 참조하십시오 .

[static noexcept] qint64 QDateTime::currentMSecsSinceEpoch()

1970년 UTC 기준 시작 시점부터 현재까지의 경과 시간을 밀리초 단위로 반환합니다.

이 숫자는 POSIX의 time_t 변수와 유사하지만, 초 대신 밀리초 단위로 표현됩니다.

currentDateTime(), currentDateTimeUtc(), toTimeZone()도 참조하십시오 .

[static noexcept] qint64 QDateTime::currentSecsSinceEpoch()

1970년 UTC 기준 시작 시점부터 경과한 초 수를 반환합니다.

이 숫자는 POSIX의 time_t 변수와 유사합니다.

currentMSecsSinceEpoch()도 참조하십시오 .

QDate QDateTime::date() const

datetime 객체의 날짜 부분을 반환합니다.

setDate(), time() 및 timeRepresentation()도 참조하십시오 .

qint64 QDateTime::daysTo(const QDateTime &other) const

현재 날짜 및 시간으로부터 ‘ other ’ 날짜 및 시간까지의 일수를 반환합니다.

일수는 이 날짜/시간과 other 날짜/시간 사이에 자정이 몇 번 도래했는지에 따라 계산됩니다. 즉, 23:55부터 다음 날 0:05까지의 10분 차이는 1일로 간주됩니다.

other 날짜/시간이 이 날짜/시간보다 이른 경우, 반환되는 값은 음수입니다. 두 날짜/시간 중 하나라도 유효하지 않은 경우, 반환되는 값은 0입니다.

예시:

QDateTime startDate(QDate(2012, 7, 6), QTime(8, 30, 0));
QDateTime endDate(QDate(2012, 7, 7), QTime(16, 30, 0));
qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

startDate = QDateTime(QDate(2012, 7, 6), QTime(23, 55, 0));
endDate = QDateTime(QDate(2012, 7, 7), QTime(0, 5, 0));
qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

qSwap(startDate, endDate); // Make endDate before startDate.
qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

addDays(), secsTo() 및 msecsTo()도 참조하십시오 .

[static] QDateTime QDateTime::fromCFDate(CFDateRef date)

CFDate date 의 복사본을 포함하는 새로운 QDateTime 객체를 생성합니다.

toCFDate()도 참조하십시오 .

[static] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs, const QTimeZone &timeZone)

timeZone 에 명시된 대로, 1970년 시작 시점(UTC 기준)으로부터 주어진 밀리초 수 msecs 가 지난 시점을 나타내는 날짜/시간을 반환합니다. 기본 시간 표기 방식은 현지 시간입니다.

msecs 에 대한 값 중에는 QDateTime 의 유효한 범위(양수 및 음수 모두)를 벗어난 값이 있을 수 있습니다. 이러한 값에 대해서는 이 함수의 동작이 정의되지 않습니다.

fromSecsSinceEpoch(), toMSecsSinceEpoch(), setMSecsSinceEpoch()도 참조하십시오 .

[static] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs)

[static] QDateTime QDateTime::fromNSDate(const NSDate *date)

date 의 복사본을 포함하는 새로운 QDateTime 객체를 생성합니다.

toNSDate()도 참조하십시오 .

[static] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs, const QTimeZone &timeZone)

timeZone 에 명시된 대로, 1970년 시작 시점(UTC 기준)으로부터 주어진 초 수 secs 만큼 지난 시점을 나타내는 날짜/시간을 반환합니다. 기본 시간 표기 방식은 현지 시간입니다.

secs 에 대한 값 중에는 QDateTime 의 유효한 범위(양수 및 음수 모두)를 벗어난 값이 있을 수 있습니다. 이러한 값에 대해서는 이 함수의 동작이 정의되지 않습니다.

fromMSecsSinceEpoch(), toSecsSinceEpoch(), setSecsSinceEpoch()도 참조하십시오 .

[static] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs)

[static, since 6.4] QDateTime QDateTime::fromStdLocalTime(const std::chrono::local_time<std::chrono::milliseconds> &time)

1970-01-01T00:00:00.000 (현지 시간 기준,Qt::LocalTime)부터 계산된, time 로 표현되는 밀리초 수를 날짜와 시간으로 갖는 datetime 객체를 생성합니다.

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

toStdSysMilliseconds() 및 fromMSecsSinceEpoch()도 참조하십시오 .

[static, since 6.4] template <typename Clock, typename Duration> QDateTime QDateTime::fromStdTimePoint(const std::chrono::time_point<Clock, Duration> &time) requires requires(const std::chrono::time_point<Clock, Duration> &t) { // the clock can be converted to system_clock std::chrono::clock_cast<std::chrono::system_clock>(t); // after the conversion to system_clock, the duration type // we get is convertible to milliseconds requires std::is_convertible_v< system_clock_cast_duration<Clock, Duration>, std::chrono::milliseconds >; }

Qt::UTC 를 시간 표현 방식으로 사용하여, time 와 동일한 시점을 나타내는 datetime 객체를 생성합니다.

time 의 시계는 std::chrono::system_clock 와 호환되어야 하며, 특히 std::chrono::clock_cast 에서 지원하는 변환이 존재해야 합니다. 변환 후, 결과의 기간(duration) 유형은 std::chrono::milliseconds 로 변환 가능해야 합니다.

그렇지 않은 경우, 호출자는 이 함수의 입력값이 위의 제약 조건을 충족하도록 std::chrono::system_clock 로 필요한 시계 변환과 지속 시간 유형에 대한 필요한 변환(형변환/반올림/하한값/상한값 등)을 수행해야 합니다.

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

toStdSysMilliseconds() 및 fromMSecsSinceEpoch()도 참조하십시오 .

[static, since 6.4] QDateTime QDateTime::fromStdTimePoint(const std::chrono::local_time<std::chrono::milliseconds> &time)

1970-01-01T00:00:00.000(현지 시간 기준,Qt::LocalTime)부터 계산된, time 로 표현되는 밀리초 수를 날짜와 시간으로 갖는 datetime 객체를 생성합니다.

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

toStdSysMilliseconds() 및 fromMSecsSinceEpoch()도 참조하십시오 .

[static, since 6.4] QDateTime QDateTime::fromStdTimePoint(std::chrono::time_point<std::chrono::system_clock, std::chrono::milliseconds> time)

` time`과 동일한 시점을 나타내는 datetime 객체를 생성하며, 이때 ` Qt::UTC `을 시간 표현식으로 사용합니다.

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

[static, since 6.4] QDateTime QDateTime::fromStdZonedTime(const std::chrono::zoned_time<std::chrono::milliseconds, const std::chrono::time_zone *> &time)

time 와 동일한 시점을 나타내는 datetime 객체를 생성합니다. 결과는 time 의 시간대 기준으로 표시됩니다.

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

QTimeZone, toStdSysMilliseconds() 및 fromMSecsSinceEpoch()도 참조하십시오 .

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

string 로 표현된 QDateTime 를, 주어진 format 를 사용하여 반환하거나, 해당 문자열을 구문 분석할 수 없는 경우 유효하지 않은 날짜 및 시간을 반환합니다.

달력( cal )이 제공된 경우 이를 사용하며, 그렇지 않으면 그레고리력을 사용합니다.

format 에 연도의 마지막 두 자리만 지정된 경우, baseYear 을 기점으로 한 100년 단위의 기간이 우선적으로 고려됩니다. 6.7 이전 버전에는 baseYear 매개변수가 없었으며, 항상 1900이 사용되었습니다. 이는 baseYear 의 기본값으로, 해당 연도부터 1999년까지의 연도 중 하나를 선택합니다. 경우에 따라, 제공된 모든 필드와 일관된 결과를 얻기 위해 다른 필드에 따라 다음 세기나 이전 세기가 선택될 수 있습니다. 자세한 내용은 QDate::fromString()를 참조하십시오.

QDate::fromString() 및 QTime::fromString()에서 날짜 및 시간의 각 부분을 나타내기 위해 형식 문자열에서 인식되는 표현식 외에도, 이 메서드는 다음을 지원합니다:

't' 형식 지정자가 없으면 시스템의 로컬 시간대가 사용됩니다. 다른 모든 필드의 기본값에 대해서는 QDate::fromString() 및 QTime::fromString()을 참조하십시오.

예를 들어:

QDateTime dateTime = QDateTime::fromString("1.30.1", "M.d.s");
// dateTime is January 30 in 1900 at 00:00:01.
dateTime = QDateTime::fromString("12", "yy");
// dateTime is January 1 in 1912 at 00:00:00.

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

QTime time1 = QTime::fromString("131", "HHh");
// time1 is 13:00:00
QTime time2 = QTime::fromString("1apA", "1amAM");
// time2 is 01:00:00

QDateTime dateTime2 = QDateTime::fromString("M1d1y9800:01:02",
                                            "'M'M'd'd'y'yyhh:mm:ss");
// dateTime is 1 January 1998 00:01:02

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

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

선두 0이 없는 표현(d, M, h, m, s, z)은 탐욕적인 방식을 따릅니다. 즉, 범위를 벗어나거나 다른 섹션에 할당할 자릿수가 너무 부족해지더라도 두 자리(z의 경우 세 자리)를 사용합니다.

QDateTime dateTime = QDateTime::fromString("130", "Mm"); // January, 30 mins

이로 인해 1월 1일 00:30.00이 될 수도 있었겠지만, M은 두 자릿수를 차지하게 됩니다.

string 의 필드가 잘못 지정되면 유효하지 않은 QDateTime 가 반환됩니다. 현지 시간 기준으로 100년 초부터 9999년 말까지의 날짜 및 시간만 지원됩니다. 다른 시간대(특히 UTC 포함)에서 이 범위의 끝부분에 가까운 날짜 및 시간은 현지 시간대에 따라 범위 밖으로 벗어날 수 있으며(따라서 유효하지 않은 것으로 처리될 수 있음) 이 점에 유의하십시오.

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

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

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

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

string 로 표현된 QDateTime 를, 지정된 format 를 사용하여 반환하며, 이것이 불가능할 경우 유효하지 않은 날짜/시간을 반환합니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

bool QDateTime::isDaylightTime() const

이 날짜 및 시간이 일광 절약 시간제에 해당하는지 여부를 반환합니다.

Qt::TimeSpec 가 Qt::LocalTime 또는 Qt::TimeZone 가 아닌 경우 항상 false를 반환합니다.

timeSpec()함수도 참조하십시오 .

bool QDateTime::isNull() const

날짜와 시간이 모두 null인 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다. null인 날짜/시간은 유효하지 않습니다.

QDate::isNull(), QTime::isNull(), isValid()도 참조하십시오 .

bool QDateTime::isValid() const

이 날짜/시간이 명확한 특정 시점을 나타내는 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

datetime은 날짜와 시간이 모두 유효하고, 사용된 시간 표현 방식이 이 둘의 조합에 유효한 의미를 부여할 때 유효합니다. 시간 표현이 특정 시간대 또는 현지 시간인 경우, 일광 절약 시간제 전환으로 인해 1시간이 건너뛰는 경우(일반적으로 봄철 밤)와 같이, 일부 날짜의 특정 시간대에 해당 시간대가 표현에서 건너뛰는 경우가 있을 수 있습니다. 예를 들어, 일광 절약 시간제가 오전 2시에 종료되어 시계가 오전 3시로 앞당겨지는 경우, 해당 날의 02:00:00부터 02:59:59.999까지의 날짜/시간은 유효하지 않습니다.

QDateTime::YearRange, QDate::isValid(), QTime::isValid()도 참조하십시오 .

qint64 QDateTime::msecsTo(const QDateTime &other) const

이 날짜/시간에서 ‘ other ’ 날짜/시간까지의 경과 시간을 밀리초 단위로 반환합니다.

비교 작업을 수행하기 전에, 두 날짜 및 시간 값은 모두 ' Qt::UTC ' 형식으로 변환됩니다. 이는 두 날짜 및 시간 중 하나에만 일광 절약 시간(DST)이 적용되고 다른 하나에는 적용되지 않는 경우에도 결과가 올바르게 산출되도록 하기 위함입니다.

other 날짜/시간이 이 날짜/시간보다 빠르면 반환되는 값은 음수입니다. 두 날짜/시간 중 하나라도 유효하지 않은 경우 0을 반환합니다.

addMSecs(), daysTo() 및 QTime::msecsTo()도 참조하십시오 .

int QDateTime::offsetFromUtc() const

이 날짜/시간의 UTC 기준 오프셋을 초 단위로 반환합니다.

결과는 ` timeSpec()`에 따라 달라집니다:

• Qt::UTC 오프셋은 0입니다.
• Qt::OffsetFromUTC 오프셋은 원래 설정된 값입니다.
• Qt::LocalTime UTC를 기준으로 한 현지 시간의 오프셋이 반환됩니다.
• Qt::TimeZone 시간대가 사용하는 오프셋이 반환됩니다.

마지막 두 가지의 경우, 일광 절약 시간제 오프셋을 고려하여 해당 날짜와 시간의 오프셋이 반환됩니다. 오프셋은 현지 시간 또는 지정된 시간대의 시간과 UTC 시간의 차이입니다. UTC보다 앞선 시간대(본초 자오선 동쪽)에서는 양수이고, UTC보다 뒤처진 시간대(본초 자오선 서쪽)에서는 음수입니다.

setTimeZone()도 참조하십시오 .

qint64 QDateTime::secsTo(const QDateTime &other) const

현재 날짜/시간에서 ‘ other ’ 날짜/시간까지의 초 수를 반환합니다.

비교를 수행하기 전에 두 날짜/시간은 모두 Qt::UTC 로 변환됩니다. 이는 두 날짜/시간 중 하나에만 일광 절약 시간(DST)이 적용되고 다른 하나에는 적용되지 않는 경우에도 결과가 정확하게 산출되도록 하기 위함입니다.

other 의 날짜/시간 값이 이 날짜/시간보다 이른 경우, 반환되는 값은 음수입니다. 두 날짜/시간 중 하나라도 유효하지 않은 경우 0을 반환합니다.

예시:

QDateTime now = QDateTime::currentDateTime();
QDateTime xmas(QDate(now.date().year(), 12, 25).startOfDay());
qDebug("There are %d seconds to Christmas", now.secsTo(xmas));

addSecs(), daysTo(), QTime::secsTo()도 참조하십시오 .

void QDateTime::setDate(QDate date, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

이 날짜/시간의 날짜 부분을 date 로 설정합니다.

아직 시간이 설정되지 않은 경우, 자정으로 설정됩니다. date 가 유효하지 않은 경우, 이 QDateTime 도 유효하지 않게 됩니다.

date 과 time()이 이 날짜 및 시간의 시간 표현에 있어 전환 시점에 가까운 순간을 나타내는 경우, resolve 는 해당 상황이 어떻게 해결될지를 제어합니다.

date(), setTime(), setTimeZone()도 참조하십시오 .

void QDateTime::setMSecsSinceEpoch(qint64 msecs)

1970년 UTC 기준 시작 시점으로부터 주어진 밀리초 수( msecs)만큼 지난 시점을 나타내는 날짜 및 시간을 설정합니다.

시간대를 지원하지 않는 시스템에서는 이 함수가 마치 현지 시간이 Qt::UTC 인 것처럼 동작합니다.

qint64 (std::numeric_limits<qint64>::min())의 최소값을 msecs 에 전달하면 정의되지 않은 동작이 발생한다는 점에 유의하십시오.

setSecsSinceEpoch(), toMSecsSinceEpoch() 및 fromMSecsSinceEpoch()도 참조하십시오 .

void QDateTime::setSecsSinceEpoch(qint64 secs)

1970년의 UTC 기준 시작 시점으로부터 지정된 초 수( secs)만큼 지난 시점을 나타내는 날짜 및 시간을 설정합니다.

시간대를 지원하지 않는 시스템에서는 이 함수가 마치 현지 시간이 Qt::UTC 인 것처럼 동작합니다.

setMSecsSinceEpoch(), toSecsSinceEpoch(), fromSecsSinceEpoch()도 참조하십시오 .

void QDateTime::setTime(QTime time, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

이 날짜/시간의 시간 부분을 time 로 설정합니다. time 가 유효하지 않은 경우, 이 함수는 이를 자정으로 설정합니다. 따라서 QDateTime 에 설정된 시간을 기본값인 QTime 로 설정함으로써 기존 시간을 지울 수 있습니다:

QDateTime dt = QDateTime::currentDateTime();
dt.setTime(QTime());

date()와 time 가 이 날짜 및 시간의 시간 표현에 있어 전환 시점에 가까운 순간을 나타내는 경우, resolve 는 해당 상황이 어떻게 해결될지 제어합니다.

또한 time(), setDate(), setTimeZone()도참조하십시오 .

void QDateTime::setTimeZone(const QTimeZone &toZone, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

이 날짜/시간에 사용되는 시간대를 toZone 로 설정합니다.

이 datetime은 다른 시점을 가리킬 수 있습니다. 이 datetime은 toZone 의 시간 표현 방식을 사용하며, 이로 인해 변경되지 않은 date() 및 time()의 의미가 달라질 수 있습니다.

toZone 가 유효하지 않은 경우, 해당 날짜/시간도 유효하지 않게 됩니다. 그렇지 않은 경우, 호출 후 이 날짜/시간의 timeSpec() 값은 toZone.timeSpec() 와 일치합니다.

date()과 time()이 toZone 의 전환 시점에 가까운 순간을 나타내는 경우, resolve 는 해당 상황이 어떻게 해결될지를 제어합니다.

timeRepresentation(), timeZone(), Qt::TimeSpec도 참조하십시오 .

[noexcept] void QDateTime::swap(QDateTime &other)

이 날짜 및 시간을 ` other`로 바꿉니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

QTime QDateTime::time() const

datetime의 시간 부분을 반환합니다.

setTime(), date() 및 timeRepresentation()도 참조하십시오 .

[since 6.5] QTimeZone QDateTime::timeRepresentation() const

이 날짜/시간이 시간을 어떻게 나타내는지 식별하는 ` QTimeZone `를 반환합니다.

반환된 ` QTimeZone `의 ` timeSpec()`는 이 datetime의 ` ()`와 일치합니다. 만약 ` Qt::TimeZone `가 아니라면, 반환된 ` QTimeZone `는 시간 표현입니다. 두 객체의 ` timeSpec()`가 ` Qt::OffsetFromUTC`인 경우, 반환된 ` QTimeZone`의 `fixedSecondsAheadOfUtc()`가 오프셋을 제공합니다. ` timeSpec()`가 ` Qt::TimeZone`인 경우, ` QTimeZone ` 객체 자체가 해당 시간대의 전체 표현입니다.

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

timeZone(), setTimeZone() 및 QTimeZone::asBackendZone()도 참조하십시오 .

Qt::TimeSpec QDateTime::timeSpec() const

datetime의 시간 표기법을 반환합니다.

이 메서드는 시간 표현을 현지 시간, UTC, UTC로부터의 고정 오프셋(오프셋을 명시하지 않음) 또는 시간대(해당 시간대의 세부 정보를 제공하지 않음)로 분류합니다. timeRepresentation().timeSpec() 와 동일합니다.

setTimeZone(), timeRepresentation(), date(), time()도 참조하십시오 .

QTimeZone QDateTime::timeZone() const

datetime의 시간대를 반환합니다.

결과는 timeRepresentation().asBackendZone() 와 동일합니다. 모든 경우에 결과의 timeSpec() 값은 Qt::TimeZone 입니다.

timeSpec()의 Qt::LocalTime 가 인 경우, 결과는 이 메서드가 호출된 시점의 현지 시간을 나타냅니다. 이 결과는 해당 값을 얻은 QDateTime 가 시스템 시간대의 후속 변경 사항을 반영하더라도, 그 변경 사항을 반영하지 않습니다.

timeRepresentation(), setTimeZone(), Qt::TimeSpec 및 QTimeZone::asBackendZone()도 참조하십시오 .

QString QDateTime::timeZoneAbbreviation() const

이 날짜 및 시간의 시간대 약어를 반환합니다.

반환되는 문자열은 ` timeSpec()`에 따라 달라집니다:

• Qt::UTC ()의 경우 "UTC"입니다.
• Qt::OffsetFromUTC 인 경우 형식은 "UTC±00:00"입니다.
• Qt::LocalTime 인 경우 호스트 시스템에 쿼리를 보냅니다.
• Qt::TimeZone 인 경우, 연관된 QTimeZone 객체를 조회합니다.

timeSpec() 및 QTimeZone::abbreviation()도 참조하십시오 .

CFDateRef QDateTime::toCFDate() const

QDateTime 에서 CFDate를 생성합니다.

호출자는 CFDate 객체를 소유하며, 이를 해제할 책임이 있습니다.

fromCFDate()도 참조하십시오 .

QDateTime QDateTime::toLocalTime() const

이 날짜 및 시간의 사본을 현지 시간으로 변환하여 반환합니다.

결과는 이 날짜 및 시간과 동일한 시점을 나타내며, 이 날짜 및 시간과 동일합니다.

예시:

QDateTime UTC(QDateTime::currentDateTimeUtc());
QDateTime local(UTC.toLocalTime());
qDebug() << "UTC time is:" << UTC;
qDebug() << "Local time is:" << local;
qDebug() << "No difference between times:" << UTC.secsTo(local);

toTimeZone(), toUTC(), toOffsetFromUtc()도 참조하십시오 .

qint64 QDateTime::toMSecsSinceEpoch() const

1970년 UTC 기준 시작 시점부터 경과한 밀리초 수로 날짜와 시간을 반환합니다.

시간대를 지원하지 않는 시스템에서는 이 함수가 현지 시간이 ` Qt::UTC`인 것처럼 동작합니다.

이 객체에 저장된 날짜 및 시간이 유효하지 않은 경우, 이 함수의 동작은 정의되지 않습니다. 그러나 유효한 모든 날짜에 대해 이 함수는 고유한 값을 반환합니다.

toSecsSinceEpoch(), setMSecsSinceEpoch(), fromMSecsSinceEpoch()도 참조하십시오 .

NSDate *QDateTime::toNSDate() const

QDateTime 를 사용하여 NSDate를 생성합니다.

NSDate 객체는 자동 해제됩니다.

fromNSDate()도 참조하십시오 .

QDateTime QDateTime::toOffsetFromUtc(int offsetSeconds) const

지정된 offsetSeconds 을 사용하여 이 datetime을 Qt::OffsetFromUTC 사양으로 변환한 사본을 반환합니다. toTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)) 와 동일합니다.

offsetSeconds 가 0인 경우, UTC 날짜 및 시간이 반환됩니다.

결과는 이 날짜/시간과 동일한 시점을 나타내며, 이 날짜/시간과 동일합니다.

offsetFromUtc() 및 toTimeZone()도 참조하십시오 .

qint64 QDateTime::toSecsSinceEpoch() const

1970년 UTC 기준 시작 시점부터 경과한 초 수로 날짜와 시간을 반환합니다.

시간대를 지원하지 않는 시스템에서는 이 함수가 마치 현지 시간이 ` Qt::UTC`인 것처럼 동작합니다.

이 객체에 저장된 날짜 및 시간이 유효하지 않은 경우, 이 함수의 동작은 정의되지 않습니다. 그러나 유효한 모든 날짜에 대해 이 함수는 고유한 값을 반환합니다.

toMSecsSinceEpoch(), fromSecsSinceEpoch() 및 setSecsSinceEpoch()도 참조하십시오 .

[since 6.4] std::chrono::sys_time<std::chrono::milliseconds> QDateTime::toStdSysMilliseconds() const

std::chrono::system_clock 를 시계로 사용하여 이 datetime 객체를 밀리초 단위로 표현된 해당 시간점으로 변환합니다.

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

fromStdTimePoint() 및 toMSecsSinceEpoch()도 참조하십시오 .

[since 6.4] std::chrono::sys_seconds QDateTime::toStdSysSeconds() const

std::chrono::system_clock 를 시계로 사용하여 이 datetime 객체를 초 단위로 표현된 해당 시점으로 변환합니다.

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

fromStdTimePoint() 및 toSecsSinceEpoch()도 참조하십시오 .

datetime를 문자열로 반환합니다. ` format ` 매개변수는 결과 문자열의 형식을 결정합니다. ` cal `가 지정되면, 날짜를 표현하는 데 사용되는 달력을 결정하며, 기본값은 그레고리력입니다. Qt 5.14 이전 버전에서는 ` cal ` 매개변수가 없었으며, 항상 그레고리력이 사용되었습니다. format 매개변수에서 각각 시간과 날짜에 대해 지원되는 지정자에 대해서는 QTime::toString() 및 QDate::toString()을 참조하십시오.

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

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

포맷 문자열 예시 ( QDateTime 가 2001년 5월 21일 14:13:09.120이라고 가정):

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

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

QString QDateTime::toString(QStringView format) const

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

지정된 format 에 따라 날짜 및 시간을 문자열로 반환합니다.

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

format 가 Qt::ISODate 인 경우, 문자열 형식은 날짜 및 시간 표기를 위한 ISO 8601 확장 사양에 따르며, QDateTime 의 timeSpec()에 따라 yyyy-MM-ddTHH:mm:ss[Z|±HH:mm] 형식을 취합니다. timeSpec()가 Qt::UTC 인 경우, 문자열 뒤에 Z가 추가됩니다. timeSpec()가 Qt::OffsetFromUTC 인 경우, UTC로부터의 시·분 단위 오프셋이 문자열 뒤에 추가됩니다. ISO 8601 날짜에 밀리초를 포함하려면, format Qt::ISODateWithMs 를 사용하십시오. 이는 yyyy-MM-ddTHH:mm:ss.zzz[Z|±HH:mm]에 해당합니다.

format 가 Qt::RFC2822Date 인 경우, 문자열은 RFC 2822에 따라 서식이 지정됩니다.

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

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

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

QDateTime QDateTime::toTimeZone(const QTimeZone &timeZone) const

지정된 ` timeZone`로 변환된 이 날짜 및 시간의 복사본을 반환합니다.

결과는 이 날짜 및 시간과 동일한 시점을 나타내며, 이 날짜 및 시간과 동일합니다.

결과는 timeZone 의 시간 표현 방식으로 해당 시점을 나타냅니다. 예를 들어:

QDateTime local(QDateTime::currentDateTime());
QDateTime UTC(local.toTimeZone(QTimeZone::UTC));
qDebug() << "Local time is:" << local;
qDebug() << "UTC time is:" << UTC;
qDebug() << "No difference between times represented:" << local.secsTo(UTC);

timeZone 가 유효하지 않은 경우, datetime도 유효하지 않게 됩니다. 그렇지 않은 경우, 반환된 datetime의 timeSpec() 값은 timeZone.timeSpec() 과 일치합니다.

timeRepresentation(), toLocalTime(), toUTC() 및 toOffsetFromUtc()도 참조하십시오 .

QDateTime QDateTime::toUTC() const

이 날짜 및 시간의 복사본을 UTC로 변환하여 반환합니다.

결과는 이 날짜 및 시간과 동일한 시점을 나타내며, 이 날짜 및 시간과 동일합니다.

예시:

QDateTime local(QDateTime::currentDateTime());
QDateTime UTC(local.toUTC());
qDebug() << "Local time is:" << local;
qDebug() << "UTC time is:" << UTC;
qDebug() << "No difference between times:" << local.secsTo(UTC);

toTimeZone(), toLocalTime() 및 toOffsetFromUtc()도 참조하십시오 .

[since 6.4] QDateTime &QDateTime::operator+=(std::chrono::milliseconds duration)

지정된 ‘ duration ’를 추가하여 이 datetime 객체를 수정합니다.

duration 가 양수이면 업데이트된 객체는 더 늦은 시점이 되고, 음수이면 더 이른 시점이 됩니다. 이 datetime 객체에 대한 참조를 반환합니다.

이 datetime이 유효하지 않은 경우, 이 함수는 아무런 효과도 없습니다.

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

addMSecs()도 참조하십시오 .

[since 6.4] QDateTime &QDateTime::operator-=(std::chrono::milliseconds duration)

지정된 ‘ duration ’ 값을 빼서 이 datetime 객체를 수정합니다.

duration 가 양수이면 업데이트된 객체의 시각은 더 이른 시점이 되고, 음수이면 더 늦은 시점이 됩니다. 이 datetime 객체에 대한 참조를 반환합니다.

이 datetime이 유효하지 않은 경우, 이 함수는 아무런 효과도 미치지 않습니다.

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

addMSecs도 참조하십시오 .

[noexcept] QDateTime &QDateTime::operator=(const QDateTime &other)

other 의 날짜/시간을 이 객체에 복사하고, 복사된 값을 반환합니다.