Date QML Type

Bietet Datumsfunktionen. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Methoden

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

Detaillierte Beschreibung

Das QML-Date-Objekt erweitert das JS-Date-Objekt um Funktionen, die das jeweilige Gebietsschema berücksichtigen.

Funktionen, die ein format Argument akzeptieren, nehmen entweder Locale.LongFormat, Locale.ShortFormat, Locale.NarrowFormat Aufzählungswerte oder einen String, der das Format angibt.

Die Form der unterstützten Formatzeichenketten ist in der Dokumentation von QDate::toString(), QTime::toString() und QDateTime::toString() beschrieben.

Wenn das Datum ungültig ist, wird eine leere Zeichenkette zurückgegeben.

Format Aufzählungswerte

Verwenden Sie die Aufzählungswerte, wenn Sie ein Format wünschen, das den Einstellungen des Gebietsschemas entspricht.

Das Format, das die Aufzählungen darstellen, hängt von Ihrem Gebietsschema ab, aber auch von der Methode, für die die Aufzählung verwendet wird.

Zum Beispiel werden für das Gebietsschema en_US diese Formatzeichenfolgen verwendet:

Weitere Hinweise

Die Verwendung der ortsabhängigen Funktionen zur Datums- oder Zeitformatierung kann aufgrund einer Inkonsistenz in der Spezifikation zwischen Qt und JS zu falsch formatierten Zeiten führen. ECMA-262 spezifiziert, dass historische Daten durch Projektion der aktuellen Regeln für die Sommerzeit auf vergangene Jahre interpretiert werden sollten, während Qt historische Daten (sofern verfügbar) verwendet, um zu bestimmen, ob an einem bestimmten Datum die Sommerzeit in Kraft war. Daher kann die Konstruktion eines Datumswertes in JS und seine Konvertierung in einen String mit Hilfe der lokalisierten Funktionen ein um eine Stunde falsches Ergebnis liefern, wenn die Sommerzeit derzeit in Kraft ist, während sie für die angegebene Zeit nicht in Kraft war, oder andersherum.

Es gibt verschiedene Datumsformate mit unterschiedlichen Auffassungen von negativen Jahren. In der menschlichen Sprache gibt es kein Jahr 0. Das Jahr nach 1BC ist 1AD. Dieses Verständnis spiegelt sich beim Drucken oder Parsen von Datumsangaben in einem der Formate wider, die nicht von ECMAScript standardisiert sind. Das heißt: toString(), toLocaleString(), toUTCString() und Konsorten. ECMAScript standardisiert ein Format: ISO 8601. Dies ist das Format, das Sie erhalten, wenn Sie toISOString() aufrufen. Dieses Format enthält eine Jahreszahl 0, die in anderen Formaten 1BC ist. Daher erhalten Sie unterschiedliche Jahreszahlen, wenn Sie negative Daten mit toISOString() und toString() ausgeben.

Wenn das Jahr mit dem Date-Konstruktor oder set(UTC)FullYear() gesetzt wird, wird die von ISO 8601 festgelegte Konvention verwendet und 0 ist ein gültiges Jahr. Das bedeutet, dass negative Jahre, die mit dem Konstruktor oder set(UTC)FullYear() gesetzt werden, auf Null basieren und daher um ein Jahr von dem abweichen, was mit toString() und friends ausgegeben wird. Wenn Sie die Ausgabe einer der to*String()-Methoden analysieren, erhalten Sie denselben Datumswert, den Sie zuvor gedruckt haben. Date.parse() erkennt die verschiedenen Formate und ihre Konvention über das Vorhandensein des Jahres 0.

Beachten Sie, dass sich dies von anderen JavaScript-Implementierungen unterscheidet, die normalerweise das Jahr 0 in allen String-Darstellungen als gültig behandeln. Da die Datumsformate im ECMAScript-Standard "implementierungsabhängig" sind, ist dies jedoch immer noch gültig.

Siehe auch Locale.

Methode Dokumentation

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"))
}