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.
Dieses Plugin wird global navigator.globalization-Objekt definiert.
Obwohl im globalen Gültigkeitsbereich, steht es nicht bis nach dem deviceready-Ereignis.
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
console.log(navigator.globalization);
}
cordova plugin add cordova-plugin-globalization
Erhalten Sie das BCP 47-Sprachtag für aktuelle Sprache des Clients.
navigator.globalization.getPreferredLanguage(successCallback, errorCallback);
Gibt das BCP-47-kompatiblen Sprache Bezeichner-Tag an der successCallback mit einem properties-Objekt als Parameter zurück. Das Objekt sollte eine Value-Eigenschaft mit einem String-Wert haben.
Wenn ein Fehler, der immer der Sprache vorliegt, führt die errorCallback mit einem GlobalizationError-Objekt als Parameter. Die erwarteten Fehlercode ist GlobalizationError.UNKNOWN_ERROR.
Wenn der Browser auf die En-US-Sprache festgelegt ist, sollte dies einen Popup-Dialog mit dem Text anzeigen Sprache: 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 an die SuccessCallback mit einem Eigenschaften-Objekt als Parameter zurück. Das Objekt sollte eine Value-Eigenschaft mit einem String-Wert haben. 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 ein Fehler, der immer des Gebietsschemas vorliegt, führt die ErrorCallback mit einem GlobalizationError-Objekt als Parameter. Die erwarteten Fehlercode ist GlobalizationError.UNKNOWN_ERROR.
Wenn der Browser auf das En-US-Gebietsschema festgelegt ist, zeigt dies einen Popup-Dialog mit dem Text Locale: 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 aus dem Objekt als Parameter übergeben, um die SuccessCallback zu erreichen.
Der eingehende date-Parameter muss vom Typ Date sein.
Wenn ein Fehler, die Formatierung des Datums vorliegt, führt die ErrorCallback mit einem GlobalizationError-Objekt als Parameter. Die erwarteten Fehlercode ist GlobalizationError.FORMATTING_ERROR.
Der options-Parameter ist optional, und die Standardwerte sind:
{formatLength:'short', selector:'date and time'}
Die options.formatLength kann short, medium, long oder full sein.
Die options.selector können date, time oder date and time werden.
Wenn der Browser auf das En_US Gebietsschema festgelegt ist, zeigt dies einen Popup-Dialog mit Text ähnlich Datum: 25.09.2012 16:21 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-Optionen sind eine Teilmenge der Unicode UTS #35. Die standardmäßige Option kurze hängt von einem Benutzer ausgewählten Datumsformat in Einstellungen -> System -> Datum & Zeit-Datumsformat auswählen >, die liefern einer Jahr-Musters nur mit 4 Ziffern, nicht 2 Ziffern. Dies bedeutet, dass es nicht völlig ICU ausgerichtet ist.Die FormatLength-Option unterstützt nur short und full Werte.
Das Muster für “date and time” Selektor ist immer eine volle Datetime-Format.
Der zurückgegebene Wert möglicherweise nicht vollständig mit ICU je nach ein Benutzergebietsschema ausgerichtet werden.
Die FormatLength-Option unterstützt nur short und full Werte.
Das Muster für “date and time” Selektor ist immer eine volle Datetime-Format.
Der zurückgegebene Wert möglicherweise nicht vollständig mit ICU je nach ein Benutzergebietsschema ausgerichtet werden.
Nur 79 Gebietsschemas werden unterstützt, da bei dieser Methode moment.js verwendet wird.
Der zurückgegebene Wert möglicherweise nicht vollständig mit ICU je nach ein Benutzergebietsschema ausgerichtet werden.
time -Selektor unterstützt nur full und short FormatLength.
formatLength ist long und full unterscheiden.long 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:
pattern: 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)
fraction: die Anzahl von Bruchziffern zum analysieren und Formatieren einer Währung verwendet. (Anzahl)
rounding: die Rundung erhöhen wenn analysieren und formatieren verwenden. (Anzahl)
decimal: das Dezimaltrennzeichen für analysieren und formatieren. (String)
grouping: das Symbol für Zifferngruppierung zum analysieren und formatieren verwenden. (String)
Der eingehende currencyCode-Parameter muss eine String eines der ISO 4217 Währungscodes, z. B. ‘USD’ sein.
Wenn ein Fehler, erhalten das Muster vorliegt, führt die ErrorCallback mit einem GlobalizationError-Objekt als Parameter. Die erwarteten Fehlercode ist GlobalizationError.FORMATTING_ERROR.
Wenn der Browser auf das En_US Gebietsschema festgelegt ist und die ausgewählte Währung US-Dollar, zeigt 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 zu den successCallback mit einem properties-Objekt als Parameter. Dieses Objekt enthält eine Value-Eigenschaft mit einem Array von Zeichenfolgen. 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, erhalten die Namen vorliegt, führt dann ErrorCallback mit einem GlobalizationError-Objekt als Parameter. Die erwarteten Fehlercode ist GlobalizationError.UNKNOWN_ERROR.
Der options-Parameter ist optional, und die Standardwerte sind:
{type:'wide', item:'months'}
Der Wert des options.type kann narrow oder wide sein.
Der Wert des options.item kann month oder days sein.
Wenn der Browser auf das En_US Gebietsschema festgelegt ist, in diesem Beispiel wird eine Reihe von zwölf Popup-Dialoge, eine pro Monat, mit Text ähnlich Monat: Januar:
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' }
);
pptions.type unterstü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:
pattern: das Datum und die Uhrzeit-Muster zur Formatierung und zum Analysieren von Daten. Die Muster folgen Unicode Technical Standard #35. (String)
timezone: 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 ein Fehler, erhalten das Muster vorliegt, führt die ErrorCallback mit einem GlobalizationError-Objekt als Parameter. Die erwarteten Fehlercode ist GlobalizationError.PATTERN_ERROR.
Der options-Parameter ist optional und wird standardmäßig auf folgende Werte:
{formatLength:'short', selector:'date and time'}
Die options.formatLength kann short, medium, long oder full sein. Die options.selector können date, time oder date and time werden.
Wenn der Browser auf das En_US Gebietsschema festgelegt ist, in diesem Beispiel wird einen Popup-Dialog mit Text wie z. B. Muster: t.m.JJJJ h: mm ein:
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-Option unterstützt nur short und full Werte.
Das pattern für date and time-Muster gibt nur volle Datetime-Format zurück.
Die timezone gibt den Namen der Vollzeit-Zone zurück.
Die dst_offset-Eigenschaft wird nicht unterstützt und gibt immer 0 (null).
Das Muster kann je nach ein Benutzergebietsschema nicht vollständig mit ICU ausgerichtet werden.
Die FormatLength-Option unterstützt nur short und full Werte.
Das pattern für date and time-Muster gibt nur volle Datetime-Format zurück.
Die timezone gibt den Namen der Vollzeit-Zone zurück.
Die dst_offset-Eigenschaft wird nicht unterstützt und gibt immer 0 (null).
Das Muster kann je nach ein Benutzergebietsschema nicht vollständig mit ICU ausgerichtet werden.
Die ‘pattern’-Eigenschaft wird nicht unterstützt und gibt leere Zeichenfolge zurück.
Nur Chrome gibt ‘Timezone’-Eigenschaft. Das Format ist “Teil der Welt/{City}”. Andere Browser zurück leere Zeichenfolge.
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. Gibt den Tag an der successCallback mit einem properties-Objekt als Parameter zurück. Das Objekt sollte eine Value-Eigenschaft mit einem String-Wert haben.
Wenn ein Fehler, erhalten das Muster vorliegt, führt die ErrorCallback mit einem GlobalizationError-Objekt als Parameter. Die erwarteten Fehlercode ist GlobalizationError.UNKNOWN_ERROR.
Wenn der Browser auf das En_US Gebietsschema festgelegt ist, zeigt dies einen Popup-Dialog mit Text ähnlich Tag: 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:
pattern: 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)
fraction: die Anzahl von Bruchziffern zum analysieren und Formatieren von Zahlen verwendet. (Anzahl)
rounding: die Rundung erhöhen wenn analysieren und formatieren verwenden. (Anzahl)
positive: das Symbol für positive Zahlen beim Analysieren und formatieren verwenden. (String)
negative: das Symbol für negative Zahlen beim Analysieren und formatieren verwenden. (String)
decimal: das Dezimaltrennzeichen für analysieren und formatieren. (String)
grouping: das Symbol für Zifferngruppierung zum analysieren und formatieren verwenden. (String)
Wenn ein Fehler, erhalten das Muster vorliegt, führt die ErrorCallback mit einem GlobalizationError-Objekt als Parameter. Die erwarteten Fehlercode ist GlobalizationError.PATTERN_ERROR.
Der options-Parameter ist optional, und die Standardwerte sind:
{type:'decimal'}
Die options.type können decimal, percent oder currency sein.
Wenn der Browser auf das En_US Gebietsschema festgelegt ist, sollte dies einen Popup-Dialog mit Text ähnlich wie die Ergebnisse angezeigt werden, die Folgen:
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 gibt eine leere Zeichenfolge zurück.
Die fraction-Eigenschaft wird nicht unterstützt und gibt NULL zurück.
pattern-Eigenschaft wird nicht unterstützt, und gibt eine leere Zeichenfolge zurück.Muster.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 in Kraft, die successCallback mit einem properties-Objekt als Parameter ist. Das Objekt sollte eine dst-Eigenschaft mit einem Boolean Wert aufweisen. Ein Wert von true gibt an, dass die Sommerzeit ist in der Tat für das angegebene Datum, und false gibt an, dass es nicht.
Die eingehenden Parameter date sollte vom Typ Date werden.
Wenn gibt es einen Lesefehler das Datum führt dann die ErrorCallback. Die erwarteten Fehlercode ist GlobalizationError.UNKNOWN_ERROR.
Im Sommer und wenn der Browser auf eine DST-fähigen Zeitzone festgelegt ist, sollte dies einen Popup-Dialog mit Text ähnlich anzeigen dst: echte:
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 an die SuccessCallback mit einem Eigenschaften-Objekt als Parameter zurück. Das Objekt sollte eine Value-Eigenschaft mit einem String-Wert haben.
Wenn ein Fehler, die Formatierung der Zahl vorliegt, führt die ErrorCallback mit einem GlobalizationError-Objekt als Parameter. Die erwarteten Fehlercode ist GlobalizationError.FORMATTING_ERROR.
Der options-Parameter ist optional, und die Standardwerte sind:
{type:'decimal'}
Die options.type kann “decimal”, “percent” oder “currency” sein.
Wenn der Browser auf das En_US Gebietsschema festgelegt ist, zeigt dies einen Popup-Dialog mit Text ähnlich Zahl: 3,142:
navigator.globalization.numberToString(
3.1415926,
function (number) {alert('number: ' + number.value + '\n');},
function () {alert('Error getting number\n');},
{type:'decimal'}
);
Windows 8.0 unterstützt nicht die Zahl gerundet, daher Werte werden nicht automatisch gerundet werden.
Auf Windows 8.1 und Windows Phone 8.1 Kommastellen statt abgeschnitten ist, bei percent Zahl Typ daher Nachkommastellen gerundet wird Graf auf 0 festgelegt.
percent Zahlen werden nicht gruppiert, wie sie in StringToNumber analysiert werden können, wenn gruppiert.
currency -Datentyp wird nicht unterstützt.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 an den Erfolg-Rückruf mit einem properties-Objekt als Parameter. Das Objekt sollte folgenden Eigenschaften aufweisen:
year: die vier Digit Year. (Anzahl)
month: der Monat ab (0-11). (Anzahl)
day: der Tag von (1-31). (Anzahl)
hour: die Stunde (0-23). (Anzahl)
minute: die Minute (0-59). (Anzahl)
second: die zweite von (0-59). (Anzahl)
millisecond: die Millisekunden (von 0-999), nicht auf allen Plattformen verfügbar. (Anzahl)
Der eingehende dateString-Parameter muss vom Typ String sein.
Der options-Parameter ist optional und wird standardmäßig auf folgende Werte:
{formatLength:'short', selector:'date and time'}
Die options.formatLength kann short, medium, long oder full sein. Die options.selector können date, time oder date and time werden.
Wenn es ein Fehler beim Analysieren der Datumszeichenfolge ist, führt die ErrorCallback mit einem GlobalizationError-Objekt als Parameter. Die erwarteten Fehlercode ist GlobalizationError.PARSING_ERROR.
Wenn der Browser auf das En_US Gebietsschema festgelegt ist, wird einen Popup-Dialog mit Text Monat: 8 Tag: 25 Jahr: 2012 ähnlich angezeigt. 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'}
);
Die FormatLength-Option unterstützt nur short und full Werte.
Das Muster für “date and time” Selektor ist immer eine volle Datetime-Format.
Parameters eingehenden dateString sollte in Übereinstimmung mit einem Muster von GetDatePattern zurückgegebenen gebildet werden. Dieses Muster kann nicht vollständig mit ICU je nach ein Benutzergebietsschema ausgerichtet werden.
Die FormatLength-Option unterstützt nur short und full Werte.
Das Muster für “date and time” Selektor ist immer eine volle Datetime-Format.
Parameters eingehenden dateString sollte in Übereinstimmung mit einem Muster von GetDatePattern zurückgegebenen gebildet werden. Dieses Muster kann nicht vollständig mit ICU je nach ein Benutzergebietsschema ausgerichtet werden.
Nur 79 Gebietsschemas werden unterstützt, da bei dieser Methode moment.js verwendet wird.
Eingehende Zeichenfolge sollte mit DateToString Ausgabeformat und Mai nicht vollständig abgestimmt auf ICU je nach ein Benutzergebietsschema angepasst werden.
time -Selektor unterstützt nur full und short FormatLength.
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);
Gibt die Anzahl der successCallback mit einem properties-Objekt als Parameter zurück. Das Objekt sollte eine Value-Eigenschaft mit Number haben.
Ist ein Fehler beim Analysieren der Zeichenfolge, führt die ErrorCallback mit einem GlobalizationError-Objekt als Parameter. Die erwarteten Fehlercode ist GlobalizationError.PARSING_ERROR.
Der options-Parameter ist optional und wird standardmäßig auf folgende Werte:
{type:'decimal'}
Die options.type können decimal, percent oder currency sein.
Wenn der Browser auf das En_US Gebietsschema festgelegt ist, sollte dies einen Popup-Dialog mit Text ähnlich anzeigen Zahl: 1234,56:
navigator.globalization.stringToNumber(
'1234.56',
function (number) {alert('number: ' + number.value + '\n');},
function () {alert('Error getting number\n');},
{type:'decimal'}
);
percent Typ wird der zurückgegebene Wert nicht durch 100 dividiert.Die Zeichenfolge muss streng auf das Gebietsschema-Format entsprechen. Beispielsweise sollten Prozentzeichen werden durch Leerzeichen getrennt für Gebietsschema “En-US” ist der Typparameter ‘percent’.
percent zahlen müssen nicht gruppiert werden, um ordnungsgemäß analysiert werden.
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.
Wenn die folgenden Fehler-Callback ausgeführt wird, zeigt es einen Popup-Dialog mit dem Text ähnlich Code: 3 und message:
function errorCallback(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
};