QDateTime Class

멤버 함수 문서

날짜/시간을 문자열로 반환합니다. 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()도 참조하세요 .

[noexcept] QDateTime::QDateTime()

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

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

isValid(), setMSecsSinceEpoch(), setDate(), setTime() 및 setTimeZone()도 참조하세요 .

[until 6.9] QDateTime::QDateTime(QDate date, QTime time, Qt::TimeSpec spec, int offsetSeconds = 0)

이 기능은 버전 6.9에서 더 이상 사용되지 않을 예정입니다.

QDateTime(date, time) 또는 QDateTime(date, time, QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)) 을 사용합니다.

spec 및 offsetSeconds 초가 암시하는 시간 표현을 사용하여 주어진 date 및 time 으로 날짜 시간을 구성합니다.

date 가 유효하고 time 가 유효하지 않은 경우 시간은 자정으로 설정됩니다.

spec 가 Qt::OffsetFromUTC 이 아닌 경우 offsetSeconds 는 무시됩니다. spec 가 Qt::OffsetFromUTC 이고 offsetSeconds 가 0 인 경우 timeSpec()는 Qt::UTC 로 설정됩니다(즉, 오프셋 0 초).

spec 가 Qt::TimeZone 인 경우 사양은 Qt::LocalTime, 즉 현재 시스템 표준 시간대로 설정됩니다. Qt::TimeZone 날짜 시간을 생성하려면 올바른 생성자를 사용합니다.

date 이 QDateTime으로 표현할 수 있는 날짜 범위를 벗어나면 결과가 유효하지 않습니다. spec 이 Qt::LocalTime 이고 시스템의 표준 시간대가 지정된 날짜와 시간을 건너뛴 경우 결과는 유효하지 않습니다.

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

timeZone 에 설명된 시간 표현을 사용하여 주어진 date 및 time 으로 날짜 시간을 구성합니다.

date 가 유효하고 time 가 유효하지 않으면 시간은 자정으로 설정됩니다. timeZone 이 유효하지 않으면 날짜/시간이 유효하지 않습니다. date 와 time 이 timeZone 에 대한 전환에 가까운 순간을 설명하는 경우 resolve 이 해당 상황의 해결 방법을 제어합니다.

[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 날짜/시간의 콘텐츠를 이 객체로 이동하고 other 은 지정되지 않은(그러나 적절한) 상태로 유지합니다.

[noexcept] QDateTime::~QDateTime()

날짜 시간을 삭제합니다.

QDateTime QDateTime::addDays(qint64 ndays) const

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

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 날짜 시간이 포함된 QDateTime 객체를 반환합니다( msecs 가 음수인 경우 이보다 빠릅니다).

이 날짜/시간이 유효하지 않으면 유효하지 않은 날짜/시간이 반환됩니다.

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

addMSecs(), msecsTo(), addDays(), addMonths() 및 addYears()도 참조하세요 .

QDateTime QDateTime::addMSecs(qint64 msecs) const

이 객체의 날짜 시간보다 밀리초 늦은 msecs 날짜 시간이 포함된 QDateTime 객체를 반환합니다( msecs 가 음수인 경우 이보다 빠릅니다).

이 날짜/시간이 유효하지 않으면 유효하지 않은 날짜/시간이 반환됩니다.

addSecs(), msecsTo(), addDays(), addMonths() 및 addYears()도 참조하세요 .

QDateTime QDateTime::addMonths(int nmonths) const

이 객체의 날짜 시간보다 몇 달 늦은 nmonths 날짜 시간을 포함하는 QDateTime 객체를 반환합니다( nmonths 이 음수인 경우 이전).

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 객체를 반환합니다.

이 날짜/시간이 유효하지 않으면 유효하지 않은 날짜/시간이 반환됩니다.

addMSecs(), secsTo(), addDays(), addMonths() 및 addYears()도 참조하세요 .

QDateTime QDateTime::addYears(int nyears) const

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

timeSpec()가 Qt::LocalTime 또는 Qt::TimeZone 이고 결과 날짜와 시간이 표준시에서 서머타임으로 전환하는 시간에 해당하는 경우 결과는 이 간격 바로 너머의 변경 방향이 됩니다. 전환 시간이 오전 2시이고 시계가 오전 3시로 앞당겨지는 경우, 오전 2시와 오전 3시 사이를 조준한 결과는 오전 2시 이전( nyears < 0)이거나 오전 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() 및 toTimeSpec()도 참조하십시오 .

[static] QDateTime QDateTime::currentDateTime()

과부하가 걸린 기능입니다.

[static] QDateTime QDateTime::currentDateTimeUtc()

시스템 시계의 현재 날짜 시간을 UTC로 표시하여 반환합니다.

currentDateTime(QTimeZone::UTC) 에 해당합니다.

currentDateTime(), QDate::currentDate(), QTime::currentTime() 및 toTimeSpec()도 참조하세요 .

[static noexcept] qint64 QDateTime::currentMSecsSinceEpoch()

1970년 시작 이후 현재 밀리초(UTC 기준)를 반환합니다.

이 숫자는 POSIX time_t 변수와 비슷하지만 초 대신 밀리초로 표시됩니다.

currentDateTime(), currentDateTimeUtc() 및 toTimeSpec()도 참조하세요 .

[static noexcept] qint64 QDateTime::currentSecsSinceEpoch()

1970년 시작 이후의 시간(초, UTC 기준)을 반환합니다.

이 숫자는 POSIX time_t 변수와 같습니다.

currentMSecsSinceEpoch()도 참조하세요 .

QDate QDateTime::date() const

날짜/시간의 날짜 부분을 반환합니다.

setDate(), time() 및 timeRepresentation()도 참조하세요 .

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

이 날짜 시간에서 other 날짜 시간까지의 일 수를 반환합니다. 이 날짜 시간에서 other 날짜 시간 사이에 자정에 도달한 횟수만큼 일수가 계산됩니다. 즉, 23:55부터 다음 날 0:05까지 10분 차이가 나면 하루로 계산됩니다.

other 날짜 시간이 이 날짜 시간보다 빠르면 반환되는 값은 음수입니다.

예시:

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);

시작 날짜 = 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 복사본이 포함된 QDateTime 을 새로 만듭니다 date.

toCFDate()도 참조하세요 .

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

timeZone 에 지정된 대로 1970년 시작 후 주어진 숫자 msecs 밀리초(UTC 기준)를 나타내는 날짜/시간을 반환합니다. 기본 시간 표현은 현지 시간입니다.

msecs 의 유효한 범위인 QDateTime 을 벗어나는 음수 및 양수 값이 있을 수 있다는 점에 유의하세요. 이 함수의 동작은 이러한 값에 대해 정의되지 않았습니다.

fromSecsSinceEpoch(), toMSecsSinceEpoch() 및 setMSecsSinceEpoch()도 참조하세요 .

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

과부하가 걸린 기능입니다.

[static, until 6.9] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs, Qt::TimeSpec spec, int offsetSeconds = 0)

이 함수는 버전 6.9에서 더 이상 사용되지 않을 예정입니다.

이 함수는 과부하가 걸린 함수입니다.

대신 QTimeZone 를 전달하거나 spec 및 offsetSeconds 를 생략하세요.

spec 및 offsetSeconds 에 지정된 대로 1970년 시작 후 주어진 숫자 msecs 밀리초(UTC 기준)를 나타내는 날짜/시간을 반환합니다.

msecs 의 유효한 범위인 QDateTime 을 벗어나는 음수 및 양수 값이 있을 수 있다는 점에 유의하세요. 이 함수의 동작은 이러한 값에 대해 정의되지 않았습니다.

spec 가 Qt::OffsetFromUTC 이 아닌 경우 offsetSeconds 는 무시됩니다. spec 가 Qt::OffsetFromUTC 이고 offsetSeconds 가 0 인 경우 UTC 의 오프셋이 0 이므로 Qt::UTC 이 spec 로 사용됩니다.

spec 가 Qt::TimeZone 인 경우 Qt::LocalTime 가 대신 사용되며, 이는 현재 시스템 표준 시간대를 사용하는 것과 동일하지만 다르게 표시됩니다.

fromSecsSinceEpoch(), toMSecsSinceEpoch() 및 setMSecsSinceEpoch()도 참조하세요 .

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

NSDate date 의 복사본을 포함하는 QDateTime 를 새로 만듭니다.

toNSDate()도 참조하십시오 .

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

timeZone 에 지정된 대로 1970년 시작 후 주어진 숫자 secs 초(UTC 기준)를 나타내는 날짜/시간을 반환합니다. 기본 시간 표현은 현지 시간입니다.

secs 의 유효한 범위인 QDateTime 을 벗어나는 음수 및 양수 값이 있을 수 있습니다. 이 함수의 동작은 이러한 값에 대해 정의되지 않았습니다.

fromMSecsSinceEpoch(), toSecsSinceEpoch() 및 setSecsSinceEpoch()도 참조하세요 .

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

과부하가 걸린 기능입니다.

[static, until 6.9] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs, Qt::TimeSpec spec, int offsetSeconds = 0)

이 함수는 버전 6.9에서 더 이상 사용되지 않을 예정입니다.

이 함수는 과부하가 걸린 함수입니다.

대신 QTimeZone 를 전달하거나 spec 및 offsetSeconds 를 생략하세요.

spec 및 offsetSeconds 에 지정된 대로 1970년 시작 후 주어진 숫자 secs 초(UTC 기준)의 순간을 나타내는 날짜/시간을 반환합니다.

QDateTime 의 유효한 범위를 벗어나는 secs 값은 음수와 양수 모두 가능합니다. 이 함수의 동작은 이러한 값에 대해 정의되지 않았습니다.

spec 가 Qt::OffsetFromUTC 이 아닌 경우 offsetSeconds 는 무시됩니다. spec 가 Qt::OffsetFromUTC 이고 offsetSeconds 가 0 인 경우 UTC 의 오프셋이 0 이므로 Qt::UTC 이 spec 로 사용됩니다.

spec 가 Qt::TimeZone 인 경우 Qt::LocalTime 가 대신 사용되며, 이는 현재 시스템 표준 시간대를 사용하는 것과 동일하지만 다르게 표시됩니다.

fromMSecsSinceEpoch(), toSecsSinceEpoch() 및 setSecsSinceEpoch()도 참조하세요 .

[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)로 표시되는 날짜/시간을 생성합니다.

이 함수는 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)로 표시되는 날짜/시간을 생성합니다.

이 함수는 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)

Qt::UTC 을 시간 표현으로 사용하여 time 과 같은 시점을 나타내는 날짜 시간을 생성합니다.

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

그렇지 않은 경우, 호출자는 이 함수에 대한 입력이 위의 제약 조건을 만족하도록 std::chrono::system_clock 로 필요한 시계 변환과 지속 시간 유형(캐스트/원형/바닥/천정/...)의 필요한 변환을 수행해야 합니다.

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

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

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

이 함수는 오버로드된 함수입니다.

Qt::UTC 을 시간 표현으로 사용하여 time 과 같은 시점을 나타내는 날짜 시간을 생성합니다.

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

[static, since 6.4] QDateTime QDateTime::fromStdZonedTime(const int &time)

time 와 같은 시점을 나타내는 날짜 시간을 생성합니다. 결과는 time 의 표준 시간대로 표현됩니다.

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

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

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

주어진 format 을 사용하여 string 으로 표시되는 QDateTime 을 반환하거나 이것이 불가능한 경우 잘못된 날짜 시간을 반환합니다.

Qt::TextDate: 영어의 짧은 월 이름(예: 짧은 형식의 "Jan" 또는 긴 형식의 "January")만 인식됩니다.

toString() 및 QLocale::toDateTime()도 참조하세요 .

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

주어진 format 을 사용하여 string 으로 표시되는 QDateTime 을 반환하거나 문자열을 구문 분석할 수 없는 경우 잘못된 날짜/시간을 반환합니다.

달력이 제공된 경우 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 time1 = QTime::fromString("1apA", "1amAM");
// time1 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 이 반환됩니다. 형식은 만족하지만 string 이 잘못된 날짜 시간을 나타내는 경우(예: 시간대 전환으로 건너뛴 간격이 있는 경우) 유효한 QDateTime 이 반환되며, 이는 유효한 가까운 날짜 시간을 나타냅니다.

선행 0이 없는 표현식(d, M, h, m, s, z)은 욕심을 부리게 됩니다. 즉, 범위를 벗어나거나 다른 섹션에 너무 적은 숫자가 남더라도 두 자리(z의 경우 세 자리)를 사용하게 됩니다.

QDateTime dateTime = QDateTime::fromString("130", "Mm"); // invalid

예를 들어 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, 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 을 반환합니다.

날짜와 시간이 모두 유효하고 사용된 시간 표현이 그 조합에 유효한 의미를 부여하는 경우 날짜/시간은 유효합니다. 시간 표현이 특정 시간대 또는 현지 시간인 경우 서머타임 전환으로 인해 한 시간이 건너뛰는 경우(일반적으로 봄의 밤)와 같이 일부 날짜에는 해당 시간대가 건너뛰는 시간이 있을 수 있습니다. 예를 들어, 서머타임이 오전 2시에 끝나고 시계가 오전 3시로 넘어가는 경우 해당 날짜의 02:00:00~02:59:59.999 날짜는 유효하지 않습니다.

QDateTime::YearRange, QDate::isValid() 및 QTime::isValid()도 참조하세요 .

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

이 날짜 시간에서 other 날짜 시간까지의 시간(밀리초)을 반환합니다. other 날짜 시간이 이 날짜 시간보다 빠르면 반환되는 값은 음수입니다.

비교를 수행하기 전에 두 날짜 시간 중 하나에는 서머타임(DST)이 적용되지만 다른 날짜 시간에는 적용되지 않는 경우 결과가 올바른지 확인하기 위해 두 날짜 시간을 Qt::UTC 로 변환합니다.

두 날짜 시간 중 하나가 유효하지 않으면 0을 반환합니다.

addMSecs(), daysTo() 및 QTime::msecsTo()도 참조하세요 .

int QDateTime::offsetFromUtc() const

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

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

• Qt::UTC 오프셋은 0입니다.
• Qt::OffsetFromUTC 오프셋은 원래 설정된 값입니다.
• Qt::LocalTime UTC로부터의 현지 시간 오프셋이 반환됩니다.
• Qt::TimeZone 표준 시간대에서 사용하는 오프셋이 반환됩니다.

마지막 두 개의 경우 서머타임 오프셋을 고려하여 이 날짜 및 시간의 오프셋이 반환됩니다. 오프셋은 현지 시간 또는 지정된 시간대의 시간과 UTC 시간 간의 차이로, UTC보다 앞선 시간대(적도 동쪽)에서는 양수, UTC보다 뒤처진 시간대(적도 서쪽)에서는 음수입니다.

setOffsetFromUtc()도 참조하세요 .

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

이 날짜 시간에서 other 날짜 시간까지의 시간(초)을 반환합니다. other 날짜/시간이 이 날짜/시간보다 빠르면 반환되는 값은 음수입니다.

비교를 수행하기 전에 두 날짜 시간 중 하나에 서머타임(DST)이 적용되지만 다른 날짜 시간에는 적용되지 않는 경우 결과가 올바른지 확인하기 위해 두 날짜 시간을 Qt::UTC 로 변환합니다.

두 날짜 시간 중 하나가 유효하지 않으면 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년 시작 후 밀리초 단위의 지정된 숫자( msecs)를 나타내는 순간으로 설정합니다(UTC 기준).

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

최소값인 qint64 (std::numeric_limits<qint64>::min())을 msecs 에 전달하면 정의되지 않은 동작이 발생합니다.

setSecsSinceEpoch(), toMSecsSinceEpoch() 및 fromMSecsSinceEpoch()도 참조하세요 .

[until 6.9] void QDateTime::setOffsetFromUtc(int offsetSeconds)

이 함수는 버전 6.9에서 더 이상 사용되지 않을 예정입니다.

대신 setTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds))를 사용하세요.

timeSpec()를 Qt::OffsetFromUTC 으로, 오프셋을 offsetSeconds 으로 설정합니다. 날짜 시간은 다른 시점을 참조할 수 있습니다.

최대 및 최소 오프셋은 양수 또는 음수 14시간입니다. offsetSeconds 이 이보다 크거나 작으면 결과가 정의되지 않습니다.

offsetSeconds 가 0이면 timeSpec()는 Qt::UTC 로 설정됩니다.

setTimeZone(), isValid(), offsetFromUtc() 및 toOffsetFromUtc()도 참조하세요 .

void QDateTime::setSecsSinceEpoch(qint64 secs)

날짜 시간을 1970년 시작 후 초 단위로 주어진 숫자 secs 로 설정합니다(UTC 기준).

표준 시간대를 지원하지 않는 시스템에서는 이 함수가 현지 시간이 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()도 참조하세요 .

[until 6.9] void QDateTime::setTimeSpec(Qt::TimeSpec spec)

이 기능은 버전 6.9에서 더 이상 사용되지 않을 예정입니다.

대신 setTimeZone() 사용

이 날짜 시간에 사용되는 시간 사양을 spec 으로 설정합니다. 날짜 시간은 다른 시점을 참조할 수 있습니다.

spec 가 Qt::OffsetFromUTC 인 경우 timeSpec()는 Qt::UTC 로 설정됩니다(즉, 유효 오프셋은 0).

spec 가 Qt::TimeZone 인 경우 사양은 Qt::LocalTime, 즉 현재 시스템 표준 시간대로 설정됩니다.

예시:

QDateTime local(QDateTime::currentDateTime());qDebug() << "Local time is:" << local;

QDateTime UTC(local); UTC.setTimeSpec(Qt::UTC);qDebug() << "UTC time is:" << UTC;

qDebug() << "There are" << local.secsTo(UTC) << "seconds difference between the datetimes.";

setTimeZone(), timeSpec(), toTimeSpec(), setDate() 및 setTime()도 참조하세요 .

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

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

날짜 시간은 다른 시점을 나타낼 수 있습니다. 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

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

setTime(), date() 및 timeRepresentation()도 참조하세요 .

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

이 날짜/시간이 시간을 나타내는 방법을 식별하는 QTimeZone 을 반환합니다.

반환된 QTimeZone 의 timeSpec()는 이 날짜 시간의 ()와 일치하며, Qt::TimeZone 이 아닌 경우 반환된 QTimeZone 은 시간 표현입니다. timeSpec ()가 Qt::OffsetFromUTC 인 경우 반환된 QTimeZone 의 fixedSecondsAheadOfUtc()가 오프셋을 제공합니다. timeSpec ()가 Qt::TimeZone 인 경우 QTimeZone 객체 자체가 해당 시간대의 전체 표현입니다.

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

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

Qt::TimeSpec QDateTime::timeSpec() const

날짜 시간의 시간 사양을 반환합니다.

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

setTimeSpec(), timeRepresentation(), date() 및 time()도 참조하세요 .

QTimeZone QDateTime::timeZone() const

날짜 시간의 표준 시간대를 반환합니다.

결과는 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 을 사용하여 Qt::OffsetFromUTC 의 사양으로 변환된 이 날짜 시간의 사본을 반환합니다. toTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)) 에 해당합니다.

offsetSeconds 이 0이면 UTC 날짜 시간이 반환됩니다.

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

setOffsetFromUtc(), 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 을 시계로 사용하여 이 날짜/시간 객체를 밀리초로 표시되는 동등한 시점으로 변환합니다.

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

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

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

std::chrono::system_clock 을 시계로 사용하여 이 날짜/시간 객체를 초 단위로 표시되는 동등한 시점으로 변환합니다.

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

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

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

과부하가 걸린 기능입니다.

[until 6.9] QDateTime QDateTime::toTimeSpec(Qt::TimeSpec spec) const

이 기능은 버전 6.9에서 더 이상 사용되지 않을 예정입니다.

대신 toTimeZone()를 사용하세요.

주어진 시간으로 변환된 이 날짜/시간의 복사본을 반환합니다 spec.

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

spec 가 Qt::OffsetFromUTC 인 경우 Qt::UTC 로 설정됩니다. UTC에서 고정된 오프셋으로 설정하려면 toTimeZone() 또는 toOffsetFromUtc()를 사용합니다.

spec 가 Qt::TimeZone 인 경우 Qt::LocalTime, 즉 현지 표준 시간대로 설정됩니다. 지정된 시간대를 설정하려면 toTimeZone()를 사용합니다.

예:

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

setTimeSpec(), timeSpec() 및 toTimeZone()도 참조하세요 .

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

주어진 timeZone 으로 변환된 이 날짜/시간의 사본을 반환합니다.

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

결과는 timeZone 의 시간 표현에 따라 현재 시점을 설명합니다. 예를 들어

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

timeZone 이 유효하지 않은 경우 날짜/시간이 유효하지 않습니다. 그렇지 않으면 반환된 날짜/시간의 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 을 추가하여 이 날짜/시간 객체를 수정합니다. duration 이 양수이면 업데이트된 객체는 나중에, 음수이면 이전에 업데이트됩니다.

이 날짜/시간이 유효하지 않으면 이 함수는 효과가 없습니다.

이 날짜/시간 객체에 대한 참조를 반환합니다.

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

addMSecs()도 참조하세요 .

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

주어진 duration 을 빼서 이 날짜/시간 객체를 수정합니다. duration 이 양수이면 업데이트된 객체는 이전이 되고 음수이면 이후가 됩니다.

이 날짜/시간이 유효하지 않으면 이 함수는 아무런 영향을 미치지 않습니다.

이 날짜/시간 객체에 대한 참조를 반환합니다.

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

addMSecs 를참조하십시오 .

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

other 날짜 시간을 여기에 복사하고 이 복사본을 반환합니다.