Dieses Plugin Ruft Informationen und führt durch spezifisch für des Benutzers Gebietsschema, Sprache und Zeitzone. Beachten Sie den Unterschied zwischen Sprache und Gebietsschema: Gebietsschema Steuerelemente wie Zahlen, Datumsangaben und Zeiten werden angezeigt für eine Region, während die Sprache bestimmt, welcher Text in Sprache erscheint als, unabhängig von den Einstellungen des Gebietsschemas. Häufig Entwickler verwenden Gebietsschema verwenden, setzen Sie beide Einstellungen aber es gibt keinen Grund, die ein Benutzer ihre Sprache auf “Englisch” eingestellt konnte nicht aber Gebietsschema “Französisch”, damit Text angezeigt wird, in Englisch, aber Termine, Zeiten, usw. werden angezeigt wie in Frankreich. Leider machen die meisten mobile Plattformen derzeit keine Unterscheidung zwischen diesen Einstellungen.
cordova plugin add org.apache.cordova.globalization
Erhalten Sie das BCP 47-Sprachtag für aktuelle Sprache des Clients.
navigator.globalization.getPreferredLanguage(successCallback, errorCallback);
Gibt den BCP-47-kompatiblen Sprache-Bezeichner-Tag für die successCallback mit einem properties -Objekt als Parameter. Dieses Objekt muss eine value Eigenschaft mit einer String Wert.
Wenn ein Fehler immer die Sprache der errorCallback führt mit ein GlobalizationError -Objekt als Parameter. Die erwarteten Fehlercode istGlobalizationError.UNKNOWN_ERROR.
Wenn der Browser auf festgelegt ist die en-US Sprache, dies sollte einen Popup-Dialog mit dem Text angezeigt language: en-US :
navigator.globalization.getPreferredLanguage(
function (language) {alert('language: ' + language.value + '\n');},
function () {alert('Error getting language\n');}
);
Gibt das BCP 47 kompatible Tag für aktuelle Gebietsschema-Einstellung des Clients zurück.
navigator.globalization.getLocaleName(successCallback, errorCallback);
Gibt die BCP 47 kompatible Gebietsschemabezeichner-Zeichenfolge, die successCallback mit einem properties -Objekt als Parameter. Dieses Objekt muss eine value Eigenschaft mit einer String Wert. Das Gebietsschema-Tag besteht aus ein Sprachcode zwei Buchstaben in Kleinbuchstaben und Großbuchstaben Zweibuchstaben-Ländercode (nicht spezifiziert) Variantencode, durch einen Bindestrich getrennt.
Wenn es ist ein Fehler, der immer des Gebietsschemas, dann die errorCallback führt mit einem GlobalizationError -Objekt als Parameter. Die erwarteten Fehlercode istGlobalizationError.UNKNOWN_ERROR.
Wenn der Browser auf festgelegt ist die en-US Gebietsschema, das zeigt einen Popup-Dialog mit dem Textlocale: en-US.
navigator.globalization.getLocaleName(
function (locale) {alert('locale: ' + locale.value + '\n');},
function () {alert('Error getting locale\n');}
);
navigator.globalizatin.getPreferredLanguage().Gibt ein Datum formatiert als Zeichenfolge gemäß der Client Gebietsschema und Zeitzone.
navigator.globalization.dateToString(date, successCallback, errorCallback, options);
Gibt das formatierte Datum String über eine value -Eigenschaft zugänglich aus dem Objekt übergeben als Parameter für diesuccessCallback.
Die eingehende date -Parameter des Typs sein sollteDate.
Wenn ein Fehler, die Formatierung des Datums vorliegt dann die errorCallback führt mit einem GlobalizationError -Objekt als Parameter. Die erwarteten Fehlercode istGlobalizationError.FORMATTING_ERROR.
Die options Parameter ist optional, und die Standardwerte sind:
{FormatLength: 'kurz', Selektor: "Datum und Uhrzeit"}
Die options.formatLength kann short , medium , long , oderfull.
Die options.selector kann date , time oderdate and time.
Wenn der Browser so, dass eingestellt ist die en_US Gebietsschema, das zeigt einen Popup-Dialog mit Text ähnlich wie date: 9/25/2012 4:21PM mit den Standardoptionen:
navigator.globalization.dateToString(
new Date(),
function (date) { alert('date: ' + date.value + '\n'); },
function () { alert('Error getting dateString\n'); },
{ formatLength: 'short', selector: 'date and time' }
);
formatLength option unterstützt nur short und full Werte.formatLengthist keine Unterscheidung long undfulllong oder full Version)Gibt eine Musterzeichenfolge zum Formatieren und Analysieren von Währungsangaben nach Benutzereinstellungen und ISO 4217 Währungscode des Kunden.
navigator.globalization.getCurrencyPattern(currencyCode, successCallback, errorCallback);
Gibt das Muster auf der successCallback mit einem properties -Objekt als Parameter. Das Objekt sollte die folgenden Eigenschaften enthalten:
Muster: das Währung-Muster zur Formatierung und zum Analysieren von Währungswerten. Die Muster folgen Unicode Technical Standard #35. (String)
Code: der ISO-4217-Währungscode für das Muster. (String)
Bruch: die Anzahl von Bruchziffern zum analysieren und Formatieren einer Währung verwendet. (Anzahl)
Rundung: die Rundung erhöhen wenn analysieren und formatieren verwenden. (Anzahl)
Dezimal: das Dezimaltrennzeichen für analysieren und formatieren. (String)
Gruppieren: das Symbol für Zifferngruppierung zum analysieren und formatieren verwenden. (String)
Die eingehende currencyCode Parameter sollte eine String eines der ISO 4217 Währungscodes, z. B. ‘USD’.
Wenn es einen Fehler erhalten das Muster, dann die errorCallback führt mit einem GlobalizationError -Objekt als Parameter. Die erwarteten Fehlercode istGlobalizationError.FORMATTING_ERROR.
Wenn der Browser auf festgelegt ist die en_US Gebietsschema und die gewählte Währung US-Dollar, in diesem Beispiel wird einen Popup-Dialog mit Text ähnlich wie die Ergebnisse, die Folgen:
navigator.globalization.getCurrencyPattern(
'USD',
function (pattern) {
alert('pattern: ' + pattern.pattern + '\n' +
'code: ' + pattern.code + '\n' +
'fraction: ' + pattern.fraction + '\n' +
'rounding: ' + pattern.rounding + '\n' +
'decimal: ' + pattern.decimal + '\n' +
'grouping: ' + pattern.grouping);
},
function () { alert('Error getting pattern\n'); }
);
Erwartete Ergebnis:
pattern: $#,##0.##;($#,##0.##) code: USD fraction: 2 rounding: 0 decimal: . grouping: ,
Gibt ein Array der Namen der Monate oder Tage der Woche, abhängig von dem Client Benutzereinstellungen und Kalender.
navigator.globalization.getDateNames(successCallback, errorCallback, options);
Gibt das Array von Namen der successCallback mit einem properties -Objekt als Parameter. Dieses Objekt enthält eine value -Eigenschaft mit einer Array der String Werte. Die Namen von Array-Funktionen, entweder der erste Monat im Jahr oder der erste Tag der Woche, je nach der ausgewählten Option ab.
Wenn ein Fehler auftritt erhalten die Namen, dann die errorCallback führt mit einem GlobalizationError -Objekt als Parameter. Die erwarteten Fehlercode istGlobalizationError.UNKNOWN_ERROR.
Die options Parameter ist optional, und die Standardwerte sind:
{type:'wide', item:'months'}
Der Wert des options.type kann narrow oderwide.
Der Wert des options.item kann months oderdays.
Wenn der Browser auf festgelegt ist die en_US Gebietsschema, in diesem Beispiel wird eine Reihe von zwölf Popup-Dialoge, eine pro Monat, mit Text ähnlich month: January :
navigator.globalization.getDateNames(
function (names) {
for (var i = 0; i < names.value.length; i++) {
alert('month: ' + names.value[i] + '\n');
}
},
function () { alert('Error getting names\n'); },
{ type: 'wide', item: 'months' }
);
options.typeunterstützt einen genitive Wert, wichtig für einige SprachenGibt eine Musterzeichenfolge zum Formatieren und Analysieren von Daten entsprechend der Client-Benutzer-Einstellungen.
navigator.globalization.getDatePattern(successCallback, errorCallback, options);
Gibt das Muster auf der successCallback . Das als Parameter übergebene Objekt enthält die folgenden Eigenschaften:
Muster: das Datum und die Uhrzeit-Muster zur Formatierung und zum Analysieren von Daten. Die Muster folgen Unicode Technical Standard #35. (String)
Zeitzone: der abgekürzte Name der Zeitzone auf dem Client. (String)
Utc_offset: die aktuelle Differenz in Sekunden zwischen dem Client Zeitzone und koordinierte Weltzeit. (Anzahl)
Dst_offset: der aktuelle Sommerzeit-Offset in Sekunden zwischen der Client-Sommerzeit der Zeitzone und der Client Tageslicht Speichern der Zeitzone. (Anzahl)
Wenn es einen Fehler erhalten das Muster der errorCallback führt mit einem GlobalizationError -Objekt als Parameter. Die erwarteten Fehlercode istGlobalizationError.PATTERN_ERROR.
Die options Parameter ist optional und wird standardmäßig auf folgende Werte:
{FormatLength: 'kurz', Selektor: "Datum und Uhrzeit"}
Die options.formatLength kann short , medium , long , oder full . Die options.selector kann date , time oderdate and time.
Wenn der Browser auf festgelegt ist die en_US Gebietsschema, in diesem Beispiel wird einen Popup-Dialog mit Text wie z. B. pattern: M/d/yyyy h:mm a :
function checkDatePattern() {
navigator.globalization.getDatePattern(
function (date) { alert('pattern: ' + date.pattern + '\n'); },
function () { alert('Error getting pattern\n'); },
{ formatLength: 'short', selector: 'date and time' }
);
}
Die formatLength unterstützt nur short und full Werte.
Die pattern für date and time Muster kehrt nur volle Datetime-Format.
Die timezone gibt den Namen des Vollzeit-Zone zurück.
Die dst_offset -Eigenschaft wird nicht unterstützt, und gibt immer NULL.
Den ersten Tag der Woche laut dem Client Benutzereinstellungen und Kalender gibt.
navigator.globalization.getFirstDayOfWeek(successCallback, errorCallback);
Die Tage der Woche sind nummeriert, beginnend mit 1, wo wird 1 Sonntag angenommen. Liefert den Tag auf der successCallback mit einem properties -Objekt als Parameter. Dieses Objekt muss eine value Eigenschaft mit einer Number Wert.
Wenn es einen Fehler erhalten das Muster, dann die errorCallback führt mit einem GlobalizationError -Objekt als Parameter. Die erwarteten Fehlercode istGlobalizationError.UNKNOWN_ERROR.
Wenn der Browser auf festgelegt ist die en_US Gebietsschema, das zeigt einen Popup-Dialog mit Text ähnlichday: 1.
navigator.globalization.getFirstDayOfWeek(
function (day) {alert('day: ' + day.value + '\n');},
function () {alert('Error getting day\n');}
);
Gibt eine Musterzeichenfolge zum Formatieren und Analysieren von Zahlen nach der Client-Benutzer-Einstellungen.
navigator.globalization.getNumberPattern(successCallback, errorCallback, options);
Gibt das Muster auf der successCallback mit einem properties -Objekt als Parameter. Dieses Objekt enthält die folgenden Eigenschaften:
Muster: die Muster zur Formatierung und zum Analysieren von Zahlen. Die Muster folgen Unicode Technical Standard #35. (String)
Symbol: das Symbol beim Formatieren und analysieren, wie ein Prozentsatz oder Symbol verwendet. (String)
Bruch: die Anzahl von Bruchziffern zum analysieren und Formatieren von Zahlen verwendet. (Anzahl)
Rundung: die Rundung erhöhen wenn analysieren und formatieren verwenden. (Anzahl)
positiv: das Symbol für positive Zahlen beim Analysieren und formatieren verwenden. (String)
negativ: das Symbol für negative Zahlen beim Analysieren und formatieren verwenden. (String)
Dezimal: das Dezimaltrennzeichen für analysieren und formatieren. (String)
Gruppieren: das Symbol für Zifferngruppierung zum analysieren und formatieren verwenden. (String)
Wenn es einen Fehler erhalten das Muster, dann die errorCallback führt mit einem GlobalizationError -Objekt als Parameter. Die erwarteten Fehlercode istGlobalizationError.PATTERN_ERROR.
Die options Parameter ist optional und Standardwerte sind:
{Typ: "decimal"}
Die options.type kann decimal , percent , odercurrency.
Wenn der Browser auf festgelegt ist die en_US Gebietsschema, dies sollte einen Popup-Dialog mit Text ähnlich wie die Ergebnisse in den folgenden anzeigen:
navigator.globalization.getNumberPattern(
function (pattern) {alert('pattern: ' + pattern.pattern + '\n' +
'symbol: ' + pattern.symbol + '\n' +
'fraction: ' + pattern.fraction + '\n' +
'rounding: ' + pattern.rounding + '\n' +
'positive: ' + pattern.positive + '\n' +
'negative: ' + pattern.negative + '\n' +
'decimal: ' + pattern.decimal + '\n' +
'grouping: ' + pattern.grouping);},
function () {alert('Error getting pattern\n');},
{type:'decimal'}
);
Ergebnisse:
pattern: #,##0.### symbol: . fraction: 0 rounding: 0 positive: negative: - decimal: . grouping: ,
Die pattern -Eigenschaft wird nicht unterstützt, und Retuens eine leere Zeichenfolge.
Die fraction -Eigenschaft wird nicht unterstützt, und gibt NULL zurück.
Gibt an, ob die Sommerzeit ist in der Tat für ein bestimmtes Datum unter Verwendung des Auftraggebers Zeitzone und Kalender.
navigator.globalization.isDayLightSavingsTime(date, successCallback, errorCallback);
Gibt an, ob Sommerzeit ist in der Tat zu den successCallback mit einem properties -Objekt als Parameter. Dieses Objekt muss eine dst Eigenschaft mit einer Boolean Wert. A true Wert angibt, dass die Sommer-/Winterzeit für das angegebene Datum gültig ist und false weist darauf hin, dass es nicht.
Die eingehenden Parameter date sollte vom TypDate.
Wenn gibt es einen Lesefehler das Datum der errorCallback führt. Die erwarteten Fehlercode istGlobalizationError.UNKNOWN_ERROR.
Im Sommer und wenn der Browser auf eine DST-fähigen Zeitzone festgelegt ist, sollte dies einen Popup-Dialog mit Text ähnlich angezeigt dst: true :
navigator.globalization.isDayLightSavingsTime(
new Date(),
function (date) {alert('dst: ' + date.dst + '\n');},
function () {alert('Error getting names\n');}
);
Gibt eine Zahl, die als Zeichenfolge nach dem Client-Benutzer-Einstellungen formatiert.
navigator.globalization.numberToString(number, successCallback, errorCallback, options);
Gibt die formatierte Zeichenfolge, die successCallback mit einem properties -Objekt als Parameter. Dieses Objekt muss eine value Eigenschaft mit einer String Wert.
Wenn es ist ein Fehler, die Formatierung der Zahl, dann die errorCallback führt mit einem GlobalizationError -Objekt als Parameter. Die erwarteten Fehlercode istGlobalizationError.FORMATTING_ERROR.
Die options Parameter ist optional, und die Standardwerte sind:
{Typ: "decimal"}
Die options.type kann sein “decimal”, “Prozent” oder “Währung”.
Wenn der Browser auf festgelegt ist die en_US Gebietsschema, das zeigt einen Popup-Dialog mit Text ähnlich wie number: 3.142 :
navigator.globalization.numberToString(
3.1415926,
function (number) {alert('number: ' + number.value + '\n');},
function () {alert('Error getting number\n');},
{type:'decimal'}
);
Analysiert ein Datum formatiert als Zeichenfolge, nach der Client Benutzereinstellungen und Kalender mit der Zeitzone des Clients, und gibt das entsprechende Datumsobjekt zurück.
navigator.globalization.stringToDate(dateString, successCallback, errorCallback, options);
Gibt das Datum zurück, an den Erfolg-Rückruf mit einem properties -Objekt als Parameter. Das Objekt sollte folgenden Eigenschaften aufweisen:
Jahr: die vier Digit Year. (Anzahl)
Monat: der Monat ab (0-11). (Anzahl)
Tag: der Tag von (1-31). (Anzahl)
Stunde: die Stunde (0-23). (Anzahl)
Minute: die Minute (0-59). (Anzahl)
zweite: die zweite von (0-59). (Anzahl)
Millisekunde: die Millisekunden (von 0-999), nicht auf allen Plattformen verfügbar. (Anzahl)
Die eingehende dateString -Parameter des Typs sein sollteString.
Die options Parameter ist optional und wird mit den folgenden Werten:
{FormatLength: 'kurz', Selektor: "Datum und Uhrzeit"}
Die options.formatLength kann short , medium , long , oder full . Die options.selector kann date , time oderdate and time.
Wenn es ist ein Fehler beim Analysieren der Datumszeichenfolge dann die errorCallback führt mit einem GlobalizationError -Objekt als Parameter. Die erwarteten Fehlercode istGlobalizationError.PARSING_ERROR.
Wenn der Browser auf festgelegt ist die en_US Gebietsschema, das zeigt einen Popup-Dialog mit Text ähnlich month:8 day:25 year:2012 . Beachten Sie, dass im Monat ganze Zahl ist kleiner als die Zeichenfolge AsInteger Monat stellt einen Array-Index.
navigator.globalization.stringToDate(
'9/25/2012',
function (date) {alert('month:' + date.month +
' day:' + date.day +
' year:' + date.year + '\n');},
function () {alert('Error getting date\n');},
{selector: 'date'}
);
formatLength option unterstützt nur short und full Werte.Analysiert eine Zahl als Zeichenfolge nach dem Client-Benutzer-Einstellungen formatiert und gibt die entsprechende Nummer zurück.
navigator.globalization.stringToNumber(string, successCallback, errorCallback, options);
Liefert die Anzahl an der successCallback mit einem properties -Objekt als Parameter. Dieses Objekt muss eine value Eigenschaft mit einer Number Wert.
Wenn es ist ein Fehler beim Analysieren der Zeichenfolge, dann die errorCallback führt mit einem GlobalizationError -Objekt als Parameter. Die erwarteten Fehlercode istGlobalizationError.PARSING_ERROR.
Die options Parameter ist optional und wird standardmäßig auf folgende Werte:
{Typ: "decimal"}
Die options.type kann decimal , percent , odercurrency.
Wenn der Browser auf festgelegt ist die en_US Gebietsschema, dies sollte einen Popup-Dialog mit Text ähnlich anzeigen number: 1234.56 :
navigator.globalization.stringToNumber(
'1234.56',
function (number) {alert('number: ' + number.value + '\n');},
function () {alert('Error getting number\n');},
{type:'decimal'}
);
Ein Objekt, das einen Fehler von der Globalisierung-API darstellt.
Dieses Objekt ist erstellt und bevölkert von Cordova und kehrte nach einem Rückruf im Fehlerfall.
Die folgenden Fehler-Callback ausgeführt wird, zeigt einen Popup-Dialog mit dem Text ähnlich wie code: 3 undmessage:
function errorCallback(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
};