이 플러그인 정보를 가져오고 사용자의 로캘, 언어 및 표준 시간대에 특정 작업을 수행 합니다. 로캘 및 언어의 차이점을 참고: 로캘 어떻게 숫자, 날짜 및 시간 표시 되는 제어 영역의 언어 어떤 언어 텍스트를 결정 하는 반면, 로캘 설정에 관계 없이 나타납니다. 종종 개발자 로캘 설정을 모두를 사용 하 여 하지만 거기에 아무 이유 없이 사용자 “영어”로 그녀의 언어를 설정할 수 없습니다 있지만 “프랑스어” 로캘을 영어 하지만 날짜, 시간, 등, 텍스트 표시 되도록 표시 됩니다 그들은 프랑스에. 불행히도, 대부분의 모바일 플랫폼 현재 만들지 않는다 이러한 설정 구분.
cordova plugin add org.apache.cordova.globalization
클라이언트의 현재 언어에 대 한 BCP 47 언어 태그를 얻을.
navigator.globalization.getPreferredLanguage(successCallback, errorCallback);
BCP 47 규격 언어 식별자 태그를 반환 합니다는 successCallback
와 properties
개체를 매개 변수로 합니다. 있어야 해당 개체는 value
속성을 String
값.
언어, 점점 오류가 발생 하는 경우는 errorCallback
로 실행 한 GlobalizationError
개체를 매개 변수로. 오류의 예상 된 코드는GlobalizationError.UNKNOWN_ERROR
.
브라우저 설정 된 경우에 en-US
언어,이 텍스트와 함께 팝업 대화 상자를 표시 한다 language: en-US
:
navigator.globalization.getPreferredLanguage( function (language) {alert('language: ' + language.value + '\n');}, function () {alert('Error getting language\n');} );
클라이언트의 현재 로캘 설정에 대 한 BCP 47 호환 태그를 반환합니다.
navigator.globalization.getLocaleName(successCallback, errorCallback);
BCP 47 준수 로캘 식별자 문자열을 반환 합니다에 successCallback
와 함께 한 properties
개체를 매개 변수로. 있어야 해당 개체는 value
속성을 String
값. 두 자리 소문자 언어 코드, 두 글자 대문자 국가 코드와 하이픈으로 분리 된 (지정 되지 않은) 변형 코드 로캘 태그 구성 됩니다.
로캘, 점점 오류가 발생 하는 경우는 errorCallback
로 실행 한 GlobalizationError
개체를 매개 변수로. 오류의 예상 된 코드는GlobalizationError.UNKNOWN_ERROR
.
브라우저 설정 된 경우에 en-US
로케일, 텍스트와 함께 팝업 대화 상자가 표시 됩니다locale: en-US
.
navigator.globalization.getLocaleName( function (locale) {alert('locale: ' + locale.value + '\n');}, function () {alert('Error getting locale\n');} );
navigator.globalizatin.getPreferredLanguage()
.날짜를 반환 합니다 클라이언트의 로케일과 시간대에 따라 문자열로 서식이 지정 된.
navigator.globalization.dateToString(date, successCallback, errorCallback, options);
서식이 지정 된 날짜를 반환 합니다 String
통해는 value
개체에서 액세스할 수 있는 속성을 매개 변수로 전달 되는successCallback
.
인바운드는 date
매개 변수 유형 이어야 합니다Date
.
날짜 서식을 오류가 발생 하는 경우는 errorCallback
로 실행 한 GlobalizationError
개체를 매개 변수로. 오류의 예상 된 코드는GlobalizationError.FORMATTING_ERROR
.
options
매개 변수는 선택적 이며 그것의 기본 값은:
{formatLength: '짧은' 선택기: '날짜 및 시간'}
options.formatLength
수 있는 short
, medium
, long
, 또는full
.
options.selector
수 있는 date
, time
또는date and time
.
브라우저 설정 된 경우는 en_US
로케일,이 텍스트에 유사한 팝업 대화 상자가 표시 됩니다 date: 9/25/2012 4:21PM
기본 옵션을 사용 하 여:
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
만 지원 옵션 short
및 full
값.formatLength
구별 하지 long
및full
long
또는 full
버전)포맷 하 고 클라이언트의 사용자 환경 설정 및 ISO 4217 통화 부호에 따라 통화 값을 구문 분석 패턴 문자열을 반환 합니다.
navigator.globalization.getCurrencyPattern(currencyCode, successCallback, errorCallback);
패턴을 반환 합니다에 successCallback
와 함께 한 properties
개체를 매개 변수로. 해당 개체에는 다음과 같은 속성이 포함 되어야 합니다.
패턴: 통화 패턴 서식을 지정 하 여 통화 값을 구문 분석 합니다. 패턴에 따라 유니코드 기술 표준 #35. (문자열)
코드: ISO 4217 통화 코드 패턴. (문자열)
분수: 구문 분석 하 고 통화 서식을 사용 하 여 소수 자릿수의 수. (수)
반올림: 라운딩 때 구문 분석 및 서식 지정을 사용 하 여 증가 합니다. (수)
10 진수: 구문 분석 및 서식 지정에 사용할 소수점 기호가. (문자열)
그룹화: 구문 분석 및 서식 지정에 사용할 그룹화 기호. (문자열)
인바운드는 currencyCode
매개 변수 이어야 합니다는 String
의 ISO 4217 통화 코드, 예를 들어 ‘미화’ 중 하나.
패턴을 얻는 오류가 발생 하는 경우는 errorCallback
로 실행 한 GlobalizationError
개체를 매개 변수로. 오류의 예상 된 코드는GlobalizationError.FORMATTING_ERROR
.
브라우저 설정 된 경우에 en_US
로캘 및 선택한 통화는 미국 달러,이 예제에서는 수행 결과를 유사한 텍스트와 팝업 대화 상자가 표시 됩니다:
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'); } );
예상된 결과:
pattern: $#,##0.##;($#,##0.##) code: USD fraction: 2 rounding: 0 decimal: . grouping: ,
달의 이름 또는 클라이언트의 사용자 환경 설정 및 일정에 따라 매일의 배열을 반환합니다.
navigator.globalization.getDateNames(successCallback, errorCallback, options);
이름의 배열을 반환 합니다는 successCallback
와 properties
개체를 매개 변수로 합니다. 해당 개체를 포함 한 value
속성으로는 Array
의 String
값. 배열 기능 이름과 년 또는 선택한 옵션에 따라 일주일의 첫날 첫 번째 달에서 시작.
이름을 얻는 오류가 발생 하는 경우는 errorCallback
로 실행 한 GlobalizationError
개체를 매개 변수로. 오류의 예상 된 코드는GlobalizationError.UNKNOWN_ERROR
.
options
매개 변수는 선택적 이며 그것의 기본 값은:
{type:'wide', item:'months'}
값 options.type
일 수 있다 narrow
또는wide
.
값 options.item
일 수 있다 months
또는days
.
브라우저 설정 된 경우에 en_US
로케일,이 예에서는 표시 12 팝업 대화 상자, 텍스트 비슷한 한달에 하나 시리즈 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.type
지원 한 genitive
값, 일부 언어에 대 한 중요 한포맷 하 고 클라이언트의 사용자 환경 설정에 따라 날짜 구문 분석 패턴 문자열을 반환 합니다.
navigator.globalization.getDatePattern(successCallback, errorCallback, options);
패턴을 반환 합니다 successCallback
. 매개 변수로 전달 된 개체에는 다음 속성이 포함 되어 있습니다.
패턴: 포맷 하 고 날짜를 구문 분석할 날짜 및 시간 패턴. 패턴에 따라 유니코드 기술 표준 #35. (문자열)
시간대: 클라이언트에 표준 시간대의 약식된 이름. (문자열)
utc_offset: 클라이언트의 시간대와 세계시 간의 초에서 현재 차이. (수)
dst_offset: 클라이언트의 비 일광 절약 간격 (초)에 현재 일광 절약 시간제 오프셋의 시간대와 클라이언트의 일광 절약의 시간대. (수)
패턴을 얻는 오류가 발생 하는 경우는 errorCallback
로 실행 한 GlobalizationError
개체를 매개 변수로 합니다. 오류의 예상 된 코드는GlobalizationError.PATTERN_ERROR
.
options
매개 변수는 선택적 이며 기본값은 다음 값:
{formatLength: '짧은' 선택기: '날짜 및 시간'}
options.formatLength
수 있는 short
, medium
, long
, 또는 full
. options.selector
수 있는 date
, time
또는date and time
.
브라우저 설정 된 경우에 en_US
로캘,이 예제에서는 같은 텍스트와 함께 팝업 대화 상자를 표시 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' } ); }
formatLength
만 지원 short
및 full
값.
pattern
에 대 한 date and time
패턴 전체 datetime 형식만 반환 합니다.
timezone
풀 타임 영역 이름을 반환 합니다.
dst_offset
속성은 지원 되지 않으며 항상 반환 0.
클라이언트의 사용자 환경 설정 및 일정에 따라 일주일의 첫 날을 반환합니다.
navigator.globalization.getFirstDayOfWeek(successCallback, errorCallback);
주일의 일 1 일요일으로 간주 됩니다 1에서 시작 하는 번호가 지정 됩니다. 하루에 반환 합니다는 successCallback
와 properties
개체를 매개 변수로. 있어야 해당 개체는 value
속성을 Number
값.
패턴을 얻는 오류가 발생 하는 경우는 errorCallback
로 실행 한 GlobalizationError
개체를 매개 변수로. 오류의 예상 된 코드는GlobalizationError.UNKNOWN_ERROR
.
브라우저 설정 된 경우에 en_US
로케일,이 텍스트에 유사한 팝업 대화 상자가 표시 됩니다day: 1
.
navigator.globalization.getFirstDayOfWeek( function (day) {alert('day: ' + day.value + '\n');}, function () {alert('Error getting day\n');} );
포맷 하 고 클라이언트의 사용자 환경 설정에 따라 숫자를 구문 분석할 패턴 문자열을 반환 합니다.
navigator.globalization.getNumberPattern(successCallback, errorCallback, options);
패턴을 반환 합니다에 successCallback
와 함께 한 properties
개체를 매개 변수로. 해당 개체에는 다음 속성이 포함 되어 있습니다.
패턴: 포맷 하 고 숫자를 구문 분석할 숫자 패턴. 패턴에 따라 유니코드 기술 표준 #35. (문자열)
기호: 때 서식 지정 및 구문 분석, % 또는 통화 기호 등을 사용 하 여 기호. (문자열)
분수: 구문 분석 하 고 숫자 서식을 사용 하 여 소수 자릿수의 수. (수)
반올림: 라운딩 때 구문 분석 및 서식 지정을 사용 하 여 증가 합니다. (수)
양수: 양수 때 구문 분석 및 서식 지정에 사용할 기호. (문자열)
음수: 음수 때 구문 분석 및 서식 지정에 사용할 기호. (문자열)
10 진수: 구문 분석 및 서식 지정에 사용할 소수점 기호가. (문자열)
그룹화: 구문 분석 및 서식 지정에 사용할 그룹화 기호. (문자열)
패턴을 얻는 오류가 발생 하는 경우는 errorCallback
로 실행 한 GlobalizationError
개체를 매개 변수로. 오류의 예상 된 코드는GlobalizationError.PATTERN_ERROR
.
options
매개 변수는 선택적 이며 기본값은:
{유형: '10 진수'}
options.type
수 있는 decimal
, percent
, 또는currency
.
브라우저 설정 된 경우에 en_US
로케일,이 수행 결과를 유사한 텍스트 팝업 대화 상자를 표시 합니다:
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'} );
결과:
pattern: #,##0.### symbol: . fraction: 0 rounding: 0 positive: negative: - decimal: . grouping: ,
pattern
속성은 지원 되지 않습니다, 및 retuens는 빈 문자열.
fraction
속성은 지원 되지 않습니다, 그리고 반환 0.
일광 절약 시간이 클라이언트의 표준 시간대 및 달력을 사용 하 여 특정된 날짜에 대 한 효과 인지 표시 합니다.
navigator.globalization.isDayLightSavingsTime(date, successCallback, errorCallback);
나타냅니다 여부 일광 절약 시간 적용 하는 successCallback
와 properties
개체를 매개 변수로. 있어야 해당 개체는 dst
속성을 Boolean
값. A true
값 나타냅니다 일광 절약 시간이 특정된 날짜에 대해 적용 되 고 false
하지 않음을 나타냅니다.
인바운드 매개 변수는 date
형식 이어야 합니다Date
.
날짜 읽기 오류가 발생 하는 경우 다음 errorCallback
를 실행 합니다. 오류의 예상 된 코드는GlobalizationError.UNKNOWN_ERROR
.
여름 동안에, 브라우저 DST 설정 표준 시간대로 설정 되어 있으면이 텍스트 비슷한 팝업 대화 상자를 표시 해야 하 고 dst: true
:
navigator.globalization.isDayLightSavingsTime( new Date(), function (date) {alert('dst: ' + date.dst + '\n');}, function () {alert('Error getting names\n');} );
클라이언트의 사용자 환경 설정에 따라 문자열 형식으로 숫자를 반환 합니다.
navigator.globalization.numberToString(number, successCallback, errorCallback, options);
서식이 지정 된 숫자 문자열을 반환 합니다에 successCallback
와 함께 한 properties
개체를 매개 변수로. 있어야 해당 개체는 value
속성을 String
값.
번호, 서식 오류가 발생 하는 경우는 errorCallback
로 실행 한 GlobalizationError
개체를 매개 변수로. 오류의 예상 된 코드는GlobalizationError.FORMATTING_ERROR
.
options
매개 변수는 선택적 이며 그것의 기본 값은:
{유형: '10 진수'}
options.type
‘소수’, ‘%’ 또는 ‘통화’ 될 수 있습니다.
브라우저 설정 된 경우에 en_US
로케일,이 텍스트에 유사한 팝업 대화 상자가 표시 됩니다 number: 3.142
:
navigator.globalization.numberToString( 3.1415926, function (number) {alert('number: ' + number.value + '\n');}, function () {alert('Error getting number\n');}, {type:'decimal'} );
클라이언트의 사용자 환경 설정 및 달력 클라이언트의 표준 시간대를 사용 하 여 문자열 형식으로 날짜를 구문 분석 하 고 해당 하는 date 개체를 반환 합니다.
navigator.globalization.stringToDate(dateString, successCallback, errorCallback, options);
날짜와 함께 성공 콜백 반환 된 properties
개체를 매개 변수로. 해당 개체는 다음 속성이 있어야 합니다.
년: 4 자리 연도. (수)
달: 달 (0-11). (수)
주: (1-31)에서 하루. (수)
시간: 1 시간 (0-23). (수)
분: 분 (0-59)에서. (수)
두 번째: (0-59)에서 두 번째. (수)
밀리초: 모든 플랫폼에서 사용할 수 없습니다 (0-999)에서 밀리초. (수)
인바운드는 dateString
매개 변수 유형 이어야 합니다String
.
options
매개 변수는 선택적 이며 기본값은 다음 값:
{formatLength: '짧은' 선택기: '날짜 및 시간'}
options.formatLength
수 있는 short
, medium
, long
, 또는 full
. options.selector
수 있는 date
, time
또는date and time
.
날짜 문자열을 구문 분석 오류가 발생 하는 경우는 errorCallback
로 실행 한 GlobalizationError
개체를 매개 변수로. 오류의 예상 된 코드는GlobalizationError.PARSING_ERROR
.
브라우저 설정 된 경우에 en_US
로케일,이 텍스트에 유사한 팝업 대화 상자가 표시 됩니다 month:8 day:25 year:2012
. 유의 정수는 한 달 미만의 문자열, 달 정수로 나타내는 배열 인덱스.
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
만 지원 옵션 short
및 full
값.클라이언트의 사용자 환경 설정에 따라 문자열 형식으로 번호를 구문 분석 하 고 해당 번호를 반환 합니다.
navigator.globalization.stringToNumber(string, successCallback, errorCallback, options);
번호를 반환 합니다는 successCallback
와 properties
개체를 매개 변수로 합니다. 있어야 해당 개체는 value
속성을 Number
값.
숫자 문자열을 구문 분석 오류가 발생 하는 경우는 errorCallback
로 실행 한 GlobalizationError
개체를 매개 변수로. 오류의 예상 된 코드는GlobalizationError.PARSING_ERROR
.
options
매개 변수는 선택적 이며 기본값은 다음 값:
{유형: '10 진수'}
options.type
수 있는 decimal
, percent
, 또는currency
.
브라우저 설정 된 경우에 en_US
로케일,이 텍스트와 유사한 팝업 대화 상자를 표시 한다 number: 1234.56
:
navigator.globalization.stringToNumber( '1234.56', function (number) {alert('number: ' + number.value + '\n');}, function () {alert('Error getting number\n');}, {type:'decimal'} );
세계화 API에서 오류를 나타내는 개체입니다.
이 개체와 코르도바, 의해 만들어지고 오류 경우 콜백 반환.
유사한 텍스트와 팝업 대화 상자가 표시 됩니다 다음 오류 콜백 실행 되 면 code: 3
와message:
function errorCallback(error) { alert('code: ' + error.code + '\n' + 'message: ' + error.message + '\n'); };