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