applican

マイページに戻る

Globalization

端末に設定された言語やロケールを取得します。

機能

端末に設定された言語を取得する 【 getPreferredLanguage 】

端末に設定されたロケールを取得する 【 getLocaleName 】

端末に設定された国コードを取得する 【 getCountry 】

日時を現在の言語・地域で文字列化する 【 dateToString 】

利用用途

アプリがインストールされた端末の言語やロケールを取得し、それに応じたコンテンツを表示したい等、こちらの機能をご利用ください。

【対応ランタイムバージョン】

ランタイムのバージョン毎に最適化したサンプルをダウンロードしてご使用ください。

サンプル Globalization
サンプル Globalization
サンプル Globalization
サンプル Globalization
サンプル Globalization
サンプル Globalization

メソッド

getPreferredLanguage

メソッド説明

getPreferredLanguage(Function successCallback, Function errorCallback)

端末に設定された言語を取得します。

パラメータ

successCallback : Function 成功時にオブジェクト形式の結果がCallbackされます。
errorCallback : Function 失敗時にエラーコードがCallbackされます。
{code : "エラーコード"}
GlobalizationError.UNKNOWN_ERROR … 0
GlobalizationError.FORMATTING_ERROR … 1
GlobalizationError.PARSING_ERROR … 2
GlobalizationError.PATTERN_ERROR … 3

Return

void

サンプルコード

applican.globalization.getPreferredLanguage(getPreferredLanguageSuccess, getPreferredLanguageError);

function getPreferredLanguageSuccess(language){
	alert(language.value);
}
function getPreferredLanguageError(err){
	alert(err.code);
}

getLocaleName

メソッド説明

getLocaleName(Function successCallback, Function errorCallback)

端末に設定されたロケールを取得します。

パラメータ

successCallback : Function 成功時にオブジェクト形式の結果がCallbackされます。
errorCallback : Function 失敗時にエラーコードがCallbackされます。
{code : "エラーコード"}
GlobalizationError.UNKNOWN_ERROR … 0
GlobalizationError.FORMATTING_ERROR … 1
GlobalizationError.PARSING_ERROR … 2
GlobalizationError.PATTERN_ERROR … 3

Return

void

サンプルコード

applican.globalization.getLocaleName(getLocaleNameSuccess, getLocaleNameError);

function getLocaleNameSuccess(locale){
	alert(locale.value);
}
function getLocaleNameError(err){
	alert(err.code);
}

getCountry

メソッド説明

getCountry(Function successCallback, Function errorCallback)

端末に設定された国コードを取得します。

パラメータ

successCallback : Function 成功時にオブジェクト形式の結果がCallbackされます。
errorCallback : Function 失敗時にエラーコードがCallbackされます。
{code : "エラーコード"}
GlobalizationError.UNKNOWN_ERROR … 0
GlobalizationError.FORMATTING_ERROR … 1
GlobalizationError.PARSING_ERROR … 2
GlobalizationError.PATTERN_ERROR … 3

Return

void

サンプルコード

applican.globalization.getCountry(getCountrySuccess, getCountryError);

function getCountrySuccess(country){
	alert(country.value);
}
function getCountryError(err){
	alert(err.code);
}

dateToString

メソッド説明

dateToString(Date date, Function successCallback, Function errorCallback)

日時を現在の言語・地域で文字列化します。

パラメータ

date : Date 文字列化したい `Date` オブジェクトを設定します。
successCallback : Function 成功時にオブジェクト形式の結果がCallbackされます。
errorCallback : Function 失敗時にエラーコードがCallbackされます。

Return

void

サンプルコード

var now = new Date();
applican.globalization.dateToString(now, success, failure);

function successful(result) {
  console.log("dateToString() successful.", result);
}
function failure(error) {
  console.log("dateToString() failure.", error);
}