日期 QML 类型

提供日期函数。更多...

• 包括继承成员在内的所有成员列表

方法

• string fromLocaleDateString(locale, dateString, format)
• string fromLocaleString(locale, dateTimeString, format)
• string fromLocaleTimeString(locale, timeString, format)
• string timeZoneUpdated()
• string toLocaleDateString(locale, format)
• string toLocaleString(locale, format)
• string toLocaleTimeString(locale, format)

详细描述

QML 日期对象扩展了 JS 日期对象，增加了对本地化的函数。

接受 format 参数的函数可以接受 Locale.LongFormat, Locale.ShortFormat, Locale.NarrowFormat 枚举值，或一个指定格式的字符串。

支持的格式字符串的形式如 QDate::toString()、QTime::toString() 和 QDateTime::toString () 文档中所述。

如果日期无效，将返回一个空字符串。

格式枚举值

当您想要匹配本地偏好设置的格式时使用枚举值。

枚举表示的格式将取决于您的区域设置，并且还取决于枚举所用的方法。

例如，对于 en_US 区域设置，这些格式字符串被使用

进一步说明

使用区域感知函数执行日期或时间格式化可能会导致时间格式不正确，这是由于 Qt 和 JS 之间的规范不一致所致。ECMA-262 规定，历史上应将当前夏令时的规则扩展到过去的年份来解释日期，而 Qt 则使用历史数据（如果可用）来确定某个日期是否实行夏令时。因此，如果在夏令时期间，使用 JS 构造一个 Date 值并使用区域感知函数转换为字符串，与世界时指定的不同，或者相反，则可能得到错误的时间值。

存在不同的日期格式，对负年份有不同的理解。常见的人类语言没有年份 0。公元前 1 年之后是公元 1 年。这种理解体现在使用 ECMAScript 未标准化的某种格式打印或解析日期时。也就是说：toString()，toLocaleString()，toUTCString() 和类似方法。ECMAScript 标准化的一种格式是 ISO 8601。当你调用 toISOString() 时，你得到的就是这个格式。该格式包括年份 0，在其它格式中它是公元前 1 年。因此，使用 toISOString() 和 toString() 打印负日期时，你会得到不同的年份。

当使用 Date 构造函数或 set(UTC)FullYear() 设置年份时，使用的是 ISO 8601 规定的约定，0 是一个有效的年份。这意味着使用构造函数或 set(UTC)FullYear() 设置的负年份是以零为基础的，因此比 toString() 和其他类似方法打印出的年数少一年。解析任何一个 to*String() 方法输出的结果将与从它打印出的相同日期值。Date.parse() 将识别不同的格式及其对年份 0 的存在或不存在的规定。

请注意，这与其他 JavaScript 实现得到的结果不同，通常在其他所有字符串表示中都会将年份 0 视为有效。由于 ECMAScript 标准中将日期格式视为“实现相关”，这仍然是有效的。

另请参阅 Locale。

方法文档

import QtQml 2.0

QtObject {
    property var locale: Qt.locale()
    property date currentDate: new Date()
    property string dateString

    Component.onCompleted: {
        dateString = currentDate.toLocaleDateString();
        print(Date.fromLocaleDateString(dateString));
    }
}

import QtQml 2.0

QtObject {
    property var locale: Qt.locale()
    property string dateTimeString: "Tue 2013-09-17 10:56:06"

    Component.onCompleted: {
        print(Date.fromLocaleString(locale, dateTimeString, "ddd yyyy-MM-dd hh:mm:ss"));
    }
}

import QtQml 2.2

QtObject {
    property var locale: Qt.locale()
    property date currentTime: new Date()
    property string timeString

    Component.onCompleted: {
        timeString = currentTime.toLocaleTimeString(locale, Locale.ShortFormat);
        print(Date.fromLocaleTimeString(locale, timeString, Locale.ShortFormat));
    }
}

property string selectedTimeZone

onSelectedTimeZoneChanged: {
    MyFunctions.setSystemTimeZone(selectedTimeZone)
    Date.timeZoneUpdated()
}

import QtQuick 2.0

Text {
    text: "The date is: " + new Date().toLocaleDateString(Qt.locale("de_DE"))
}

import QtQuick 2.0

Text {
    text: "The date is: " + new Date().toLocaleString(Qt.locale("de_DE"))
}

import QtQuick 2.0

Text {
    text: "The date is: " + new Date().toLocaleTimeString(Qt.locale("de_DE"))
}