Added: cordova/site/public/docs/en/6.x/cordova-plugin-globalization/index.html URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/6.x/cordova-plugin-globalization/index.html?rev=1734016&view=auto ============================================================================== --- cordova/site/public/docs/en/6.x/cordova-plugin-globalization/index.html (added) +++ cordova/site/public/docs/en/6.x/cordova-plugin-globalization/index.html Tue Mar 8 01:36:30 2016 @@ -0,0 +1,3705 @@ +<!DOCTYPE html> +<html lang="en"> +<head> + <meta charset="utf-8"> + <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"> + <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> + <meta name="format-detection" content="telephone=no"> + <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width" /> + <meta name="description" content=" "> + + <title> + + Apache Cordova + + </title> + + <link rel="SHORTCUT ICON" href="/favicon.ico"/> + <link rel="canonical" href="https://cordova.apache.org/docs/en/6.x/cordova-plugin-globalization/";> + + <!-- CSS --> + <link rel="stylesheet" type="text/css" href="/static/css/main.css"> + + + <link rel="stylesheet" type="text/css" href="/static/js/lib/prettify/prettify.css"> + + + <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries --> + <!--[if lt IE 9]> + <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js";></script> + <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js";></script> + <![endif]--> + <script type="text/javascript"> + var disqus_developer = 1; // this would set it to developer mode + </script> + + <!-- JS --> + <script defer type="text/javascript" src="/static/js/lib/jquery-2.1.1.min.js"></script> + <script defer type="text/javascript" src="/static/js/lib/bootstrap.min.js"></script> + <script defer type="text/javascript" src="/static/js/lib/ZeroClipboard.js"></script> +</head> + +<body> + <header> + <a class="scroll-point pt-top" name="top"></a> + <nav class="navbar navbar-inverse navbar-fixed-top"> + <div class="container-fluid"> + <div class="navbar-header"> + <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="/"><img id="logo_top" src="/static/img/cordova-logo-newbrand.svg"/></a> + </div> + <div id="navbar" class="navbar-collapse collapse"> + <div class="nav_bar_center"> + <ul class="nav navbar-nav"> + <li class="active"> + <a href="/docs/en/latest/guide/overview/">Documentation</a> + </li> + <li > + <a href="/plugins">Plugins</a> + </li> + <li > + <a href="/blog" id="blog_button">Blog<span class="badge" id="new_blog_count"></span></a> + </li> + <li > + <a href="/contribute">Contribute</a> + </li> + <li> + <a href="/#getstarted">Get Started</a> + </li> + </ul> + <form action="https://www.google.com/search"; method="GET" class="navbar-form navbar-right" id="header-search-form" role="search"> + <div class="input-group"> + <input type="text" name="q" class="form-control hidden-sm" placeholder="Site-wide Search"> + <span class="input-group-btn"> + <button type="submit" class="btn search-button"> + <span class="glyphicon glyphicon-search" aria-hidden="true"></span> + </button> + </span> + </div> + <input type="hidden" name="q" value="site:cordova.apache.org"> + </form> + </div> + </div><!--/.navbar-collapse --> + </div> + </nav> + <div id="_fixed_navbar_spacer" style="padding-top:50px"></div> +</header> + + <!-- Use the manual ToC, and if it doesn't exist, use the generated one --> + + + + + + + + + + + + +<div class="docs container"> + + <!-- Table of Contents --> + <div class="hidden-xs hidden-sm col-md-3 site-toc-container"> + <h2 class="site-toc-title">Table of Contents</h2> + <ul class="site-toc"> + + + + + + + + <li> + + <span class="toc-section-heading"> + Introduction + </span> + + + + + + + <ul class="site-toc"> + + + + + + <li> + + <a class="" href="../guide/overview/index.html"> + Overview + </a> + + + + + + + </li> + +</ul> + + + </li> + + + + + + + + <li> + + <span class="toc-section-heading"> + Create apps + </span> + + + + + + + <ul class="site-toc"> + + + + + + <li> + + <a class="" href="../guide/cli/index.html"> + Create your first app + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/support/index.html"> + Platform support + </a> + + + + + + + </li> + + + + + + + + <li> + + <span class="toc-section-heading"> + Develop for platforms + </span> + + + + + + + <ul class="site-toc"> + + + + + + <li> + + <a class="" href="../guide/platforms/android/index.html"> + Android + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/platforms/blackberry10/home.html"> + Blackberry 10 + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/platforms/ios/index.html"> + iOS + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/platforms/osx/index.html"> + OS X + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/platforms/ubuntu/index.html"> + Ubuntu + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/platforms/win8/index.html"> + Windows + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/platforms/wp8/home.html"> + WP8 + </a> + + + + + + + </li> + +</ul> + + + </li> + + + + + + <li> + + <a class="" href="../platform_plugin_versioning_ref/index.html"> + Manage versions and platforms + </a> + + + + + + + </li> + + + + + + + + + + + <li> + + <a class="" href="../config_ref/images.html"> + Customize icons + </a> + + + + + + + </li> + + + + + + + + + + + <li> + + <a class="" href="../cordova/storage/storage.html"> + Store data + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/appdev/privacy/index.html"> + Manage privacy + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/appdev/security/index.html"> + Manage security + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/appdev/whitelist/index.html"> + Whitelisting + </a> + + + + + + + </li> + + + + + + +</ul> + + + </li> + + + + + + + + <li> + + <span class="toc-section-heading"> + Create plugins + </span> + + + + + + + <ul class="site-toc"> + + + + + + <li> + + <a class="" href="../guide/hybrid/plugins/index.html"> + Create a plugin + </a> + + + + + + + </li> + + + + + + + + + + + + + <li> + + <span class="toc-section-heading"> + Develop for platforms + </span> + + + + + + + <ul class="site-toc"> + + + + + + <li> + + <a class="" href="../guide/platforms/android/plugin.html"> + Android + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/platforms/blackberry10/plugin.html"> + Blackberry 10 + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/platforms/ios/plugin.html"> + iOS + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/platforms/win8/plugin.html"> + Windows + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/platforms/wp8/plugin.html"> + WP8 + </a> + + + + + + + </li> + +</ul> + + + </li> + + + + + + <li> + + <a class="" href="../plugin_ref/plugman.html"> + Use Plugman + </a> + + + + + + + </li> + + + + + + +</ul> + + + </li> + + + + + + + + <li> + + <span class="toc-section-heading"> + Advanced Topics + </span> + + + + + + + <ul class="site-toc"> + + + + + + <li> + + <a class="" href="../guide/hybrid/webviews/index.html"> + Embed Cordova in native apps + </a> + + + + + + + </li> + + + + + + + + + + + <li> + + <a class="" href="../guide/next/index.html"> + Next Steps + </a> + + + + + + + </li> + +</ul> + + + </li> + + + + + + + + <li> + + <span class="toc-section-heading"> + Reference + </span> + + + + + + + <ul class="site-toc"> + + + + + + <li> + + <a class="" href="../config_ref/index.html"> + Config.xml + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova/events/events.html"> + Events + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-cli/index.html"> + CLI + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../guide/appdev/hooks/index.html"> + Hooks + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../plugin_ref/spec.html"> + Plugin.xml + </a> + + + + + + + </li> + + + + + + + + <li> + + <span class="toc-section-heading"> + Plugin APIs + </span> + + + + + + + <ul class="site-toc"> + + + + + + <li> + + <a class="" href="../cordova-plugin-battery-status/index.html"> + Battery Status + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-camera/index.html"> + Camera + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-console/index.html"> + Console + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-contacts/index.html"> + Contacts + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-device/index.html"> + Device + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-device-motion/index.html"> + Device Motion + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-device-orientation/index.html"> + Device Orientation + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-dialogs/index.html"> + Dialogs + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-file/index.html"> + File + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-file-transfer/index.html"> + File Transfer + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-geolocation/index.html"> + Geolocation + </a> + + + + + + + </li> + + + + + + <li> + + <a class="this-page" href="../cordova-plugin-globalization/index.html"> + Globalization + </a> + + + + <div id="page-toc" class="page-toc"></div> + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-inappbrowser/index.html"> + Inappbrowser + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-media/index.html"> + Media + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-media-capture/index.html"> + Media Capture + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-network-information/index.html"> + Network Information + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-splashscreen/index.html"> + Splashscreen + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-vibration/index.html"> + Vibration + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-statusbar/index.html"> + Statusbar + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-whitelist/index.html"> + Whitelist + </a> + + + + + + + </li> + + + + + + <li> + + <a class="" href="../cordova-plugin-legacy-whitelist/index.html"> + Legacy Whitelist + </a> + + + + + + + </li> + +</ul> + + + </li> + +</ul> + + + </li> + + + + + + +</ul> + + </div> + + <!-- Page content --> + <div class="col-md-8 col-md-offset-1"> + + <!-- ToC Dropdown (for XS and SM sizes only) --> + <div class="toc-dropdown content-header visible-xs-block visible-sm-block"> + <div class="dropdown"> + <button class="btn btn-default dropdown-toggle" type="button" id="tocDropdown" data-toggle="dropdown" aria-haspopup="true" aria-expanded="true"> + Table of Contents + <span class="caret"></span> + </button> + <ul class="dropdown-menu"> + + + + + +<li> + <a class="" href="../guide/overview/index.html"> + Overview + </a> +</li> + + + + + + + + + + +<li> + <a class="" href="../guide/cli/index.html"> + Create your first app + </a> +</li> + + + + +<li> + <a class="" href="../guide/support/index.html"> + Platform support + </a> +</li> + + + + + + + +<li> + <a class="" href="../guide/platforms/android/index.html"> + Android + </a> +</li> + + + + +<li> + <a class="" href="../guide/platforms/blackberry10/home.html"> + Blackberry 10 + </a> +</li> + + + + +<li> + <a class="" href="../guide/platforms/ios/index.html"> + iOS + </a> +</li> + + + + +<li> + <a class="" href="../guide/platforms/osx/index.html"> + OS X + </a> +</li> + + + + +<li> + <a class="" href="../guide/platforms/ubuntu/index.html"> + Ubuntu + </a> +</li> + + + + +<li> + <a class="" href="../guide/platforms/win8/index.html"> + Windows + </a> +</li> + + + + +<li> + <a class="" href="../guide/platforms/wp8/home.html"> + WP8 + </a> +</li> + + + + + + + +<li> + <a class="" href="../platform_plugin_versioning_ref/index.html"> + Manage versions and platforms + </a> +</li> + + + + + + + +<li> + <a class="" href="../config_ref/images.html"> + Customize icons + </a> +</li> + + + + + + + +<li> + <a class="" href="../cordova/storage/storage.html"> + Store data + </a> +</li> + + + + +<li> + <a class="" href="../guide/appdev/privacy/index.html"> + Manage privacy + </a> +</li> + + + + +<li> + <a class="" href="../guide/appdev/security/index.html"> + Manage security + </a> +</li> + + + + +<li> + <a class="" href="../guide/appdev/whitelist/index.html"> + Whitelisting + </a> +</li> + + + + + + + + + + + + + +<li> + <a class="" href="../guide/hybrid/plugins/index.html"> + Create a plugin + </a> +</li> + + + + + + + + + + +<li> + <a class="" href="../guide/platforms/android/plugin.html"> + Android + </a> +</li> + + + + +<li> + <a class="" href="../guide/platforms/blackberry10/plugin.html"> + Blackberry 10 + </a> +</li> + + + + +<li> + <a class="" href="../guide/platforms/ios/plugin.html"> + iOS + </a> +</li> + + + + +<li> + <a class="" href="../guide/platforms/win8/plugin.html"> + Windows + </a> +</li> + + + + +<li> + <a class="" href="../guide/platforms/wp8/plugin.html"> + WP8 + </a> +</li> + + + + + + + +<li> + <a class="" href="../plugin_ref/plugman.html"> + Use Plugman + </a> +</li> + + + + + + + + + + + + + +<li> + <a class="" href="../guide/hybrid/webviews/index.html"> + Embed Cordova in native apps + </a> +</li> + + + + + + + +<li> + <a class="" href="../guide/next/index.html"> + Next Steps + </a> +</li> + + + + + + + + + + +<li> + <a class="" href="../config_ref/index.html"> + Config.xml + </a> +</li> + + + + +<li> + <a class="" href="../cordova/events/events.html"> + Events + </a> +</li> + + + + +<li> + <a class="" href="../cordova-cli/index.html"> + CLI + </a> +</li> + + + + +<li> + <a class="" href="../guide/appdev/hooks/index.html"> + Hooks + </a> +</li> + + + + +<li> + <a class="" href="../plugin_ref/spec.html"> + Plugin.xml + </a> +</li> + + + + + + + +<li> + <a class="" href="../cordova-plugin-battery-status/index.html"> + Battery Status + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-camera/index.html"> + Camera + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-console/index.html"> + Console + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-contacts/index.html"> + Contacts + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-device/index.html"> + Device + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-device-motion/index.html"> + Device Motion + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-device-orientation/index.html"> + Device Orientation + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-dialogs/index.html"> + Dialogs + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-file/index.html"> + File + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-file-transfer/index.html"> + File Transfer + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-geolocation/index.html"> + Geolocation + </a> +</li> + + + + +<li> + <a class="this-page" href="../cordova-plugin-globalization/index.html"> + Globalization + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-inappbrowser/index.html"> + Inappbrowser + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-media/index.html"> + Media + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-media-capture/index.html"> + Media Capture + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-network-information/index.html"> + Network Information + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-splashscreen/index.html"> + Splashscreen + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-vibration/index.html"> + Vibration + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-statusbar/index.html"> + Statusbar + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-whitelist/index.html"> + Whitelist + </a> +</li> + + + + +<li> + <a class="" href="../cordova-plugin-legacy-whitelist/index.html"> + Legacy Whitelist + </a> +</li> + + + + + + + + + + + + + + </ul> + </div> + </div> + + <div class="content-header"> + + <a class="edit" href="https://github.com/apache/cordova-plugin-globalization/blob/master/README.md";> + <span class="glyphicon glyphicon-pencil" aria-hidden="true"></span> Edit + </a> + + <!-- Language dropdown --> + <div class="dropdown"> + <button class="btn btn-default dropdown-toggle" type="button" id="languageDropdown" data-toggle="dropdown" aria-haspopup="true" aria-expanded="true"> + English + <span class="caret"></span> + </button> + + <!-- List all languages --> + <ul class="dropdown-menu" aria-labelledby="languageDropdown"> + + + + + + + + + + + + + + <li> + <a href="/docs/de/6.x/cordova-plugin-globalization/index.html" class=" + + + " + > + + Deutsch + + </a> + </li> + + + + + + + + + + + + + + <li> + <a href="/docs/en/6.x/cordova-plugin-globalization/index.html" class=" + + + " + > + + <span class="selected"> + English + </span> + + </a> + </li> + + + + + + + + + + + + + + <li> + <a href="/docs/es/6.x/cordova-plugin-globalization/index.html" class=" + + + " + > + + Español + + </a> + </li> + + + + + + + + + + + + + + <li> + <a href="/docs/fr/6.x/cordova-plugin-globalization/index.html" class=" + + + " + > + + Français + + </a> + </li> + + + + + + + + + + + + + + <li> + <a href="/docs/it/6.x/cordova-plugin-globalization/index.html" class=" + + + " + > + + Italiano + + </a> + </li> + + + + + + + + + + + + + + <li> + <a href="/docs/ja/6.x/cordova-plugin-globalization/index.html" class=" + + + " + > + + æ¥æ¬èª + + </a> + </li> + + + + + + + + + + + + + + <li> + <a href="/docs/ko/6.x/cordova-plugin-globalization/index.html" class=" + + + " + > + + íêµì´ + + </a> + </li> + + + + + + + + + + + + + + <li> + <a href="/docs/pl/6.x/cordova-plugin-globalization/index.html" class=" + + + " + > + + Polski + + </a> + </li> + + + + + + + + + + + + + + <li> + <a href="/docs/ru/6.x/cordova-plugin-globalization/index.html" class=" + + + " + > + + Ð ÑÑÑкий + + </a> + </li> + + + + + + + + + + + + + + <li> + <a href="/docs/sl/6.x/cordova-plugin-globalization/index.html" class=" + + + " + > + + Slovene + + </a> + </li> + + + + + + + + + + + + + + <li> + <a href="/docs/zh/6.x/cordova-plugin-globalization/index.html" class=" + + + " + > + + æ±è¯ + + </a> + </li> + + </ul> + </div> + + <!-- Version dropdown --> + <div class="dropdown"> + <button class="btn btn-default dropdown-toggle" type="button" id="versionDropdown" data-toggle="dropdown" aria-haspopup="true" aria-expanded="true"> + 6.x + + (Latest) + + <span class="caret"></span> + </button> + <ul class="dropdown-menu" aria-labelledby="versionDropdown"> + + <!-- List versions available in this language --> + + <li> + + + + + + + + + <a href="/docs/en/dev/cordova-plugin-globalization/index.html"> + + + dev + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/6.x/cordova-plugin-globalization/index.html"> + + <span class="selected"> + + 6.x + + (Latest) + + + </span> + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/5.4.0/cordova-plugin-globalization/index.html"> + + + 5.4.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/5.1.1/cordova-plugin-globalization/index.html"> + + + 5.1.1 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/5.0.0/cordova-plugin-globalization/index.html"> + + + 5.0.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/4.0.0/cordova-plugin-globalization/index.html"> + + + 4.0.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/3.6.0/cordova-plugin-globalization/index.html"> + + + 3.6.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/3.5.0/cordova-plugin-globalization/index.html"> + + + 3.5.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/3.4.0/cordova-plugin-globalization/index.html"> + + + 3.4.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/3.3.0/cordova-plugin-globalization/index.html"> + + + 3.3.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/3.2.0/cordova-plugin-globalization/index.html"> + + + 3.2.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/3.1.0/cordova-plugin-globalization/index.html"> + + + 3.1.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/3.0.0/cordova-plugin-globalization/index.html"> + + + 3.0.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/2.9.0/cordova-plugin-globalization/index.html"> + + + 2.9.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/2.8.0/cordova-plugin-globalization/index.html"> + + + 2.8.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/2.7.0/cordova-plugin-globalization/index.html"> + + + 2.7.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/2.6.0/cordova-plugin-globalization/index.html"> + + + 2.6.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/2.5.0/cordova-plugin-globalization/index.html"> + + + 2.5.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/2.4.0/cordova-plugin-globalization/index.html"> + + + 2.4.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/2.3.0/cordova-plugin-globalization/index.html"> + + + 2.3.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/2.2.0/cordova-plugin-globalization/index.html"> + + + 2.2.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/2.1.0/cordova-plugin-globalization/index.html"> + + + 2.1.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/2.0.0/cordova-plugin-globalization/index.html"> + + + 2.0.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/1.9.0/cordova-plugin-globalization/index.html"> + + + 1.9.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/1.8.1/cordova-plugin-globalization/index.html"> + + + 1.8.1 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/1.8.0/cordova-plugin-globalization/index.html"> + + + 1.8.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/1.7.0/cordova-plugin-globalization/index.html"> + + + 1.7.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/1.6.1/cordova-plugin-globalization/index.html"> + + + 1.6.1 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/1.6.0/cordova-plugin-globalization/index.html"> + + + 1.6.0 + + + + </a> + </li> + + <li> + + + + + + + + + <a href="/docs/en/1.5.0/cordova-plugin-globalization/index.html"> + + + 1.5.0 + + + + </a> + </li> + + </ul> + </div> + </div> + + <!-- Get URL for this page in the latest version --> + + + + + <!-- Show warnings for special versions (i.e. non-latest, and dev) --> + + + + <div class="alert alert-warning docs-alert" role="alert"> + <button type="button" class="close" data-dismiss="alert" aria-label="Close"> + <span aria-hidden="true">×</span> + </button> + This documentation describes this plugin at version master. + <a href="https://github.com/apache/cordova-plugin-globalization/releases";> + Other versions are on GitHub. + </a> + </div> + + + + <div id="page-toc-source"> + <!-- +# license: Licensed to the Apache Software Foundation (ASF) under one +# or more contributor license agreements. See the NOTICE file +# distributed with this work for additional information +# regarding copyright ownership. The ASF licenses this file +# to you under the Apache License, Version 2.0 (the +# "License"); you may not use this file except in compliance +# with the License. You may obtain a copy of the License at +# +# http://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, +# software distributed under the License is distributed on an +# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +# KIND, either express or implied. See the License for the +# specific language governing permissions and limitations +# under the License. +--> + +<p><a href="https://travis-ci.org/apache/cordova-plugin-globalization";><img src="https://travis-ci.org/apache/cordova-plugin-globalization.svg?branch=master"; alt="Build Status"></a></p> + +<h1>cordova-plugin-globalization</h1> + +<p>This plugin obtains information and performs operations specific to the user's +locale, language, and timezone. Note the difference between locale and language: +locale controls how numbers, dates, and times are displayed for a region, while +language determines what language text appears as, independently of locale settings. +Often developers use locale to set both settings, but there is no reason a user +couldn't set her language to "English" but locale to "French", so that text is +displayed in English but dates, times, etc., are displayed as they are in France. +Unfortunately, most mobile platforms currently do not make a distinction between +these settings.</p> + +<p>This plugin defines global <code class="prettyprint">navigator.globalization</code> object.</p> + +<p>Although in the global scope, it is not available until after the <code class="prettyprint">deviceready</code> event.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">document.addEventListener("deviceready", onDeviceReady, false); +function onDeviceReady() { + console.log(navigator.globalization); +} +</code></pre></div> +<p>Report issues with this plugin on the <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20CB%20AND%20status%20in%20%28Open%2C%20%22In%20Progress%22%2C%20Reopened%29%20AND%20resolution%20%3D%20Unresolved%20AND%20component%20%3D%20%22Plugin%20Globalization%22%20ORDER%20BY%20priority%20DESC%2C%20summary%20ASC%2C%20updatedDate%20DESC";>Apache Cordova issue tracker</a></p> + +<h2>Installation</h2> +<div class="highlight"><pre><code class="language-text" data-lang="text">cordova plugin add cordova-plugin-globalization +</code></pre></div> +<h2>Objects</h2> + +<ul> +<li>GlobalizationError</li> +</ul> + +<h2>Methods</h2> + +<ul> +<li>navigator.globalization.getPreferredLanguage</li> +<li>navigator.globalization.getLocaleName</li> +<li>navigator.globalization.dateToString</li> +<li>navigator.globalization.stringToDate</li> +<li>navigator.globalization.getDatePattern</li> +<li>navigator.globalization.getDateNames</li> +<li>navigator.globalization.isDayLightSavingsTime</li> +<li>navigator.globalization.getFirstDayOfWeek</li> +<li>navigator.globalization.numberToString</li> +<li>navigator.globalization.stringToNumber</li> +<li>navigator.globalization.getNumberPattern</li> +<li>navigator.globalization.getCurrencyPattern</li> +</ul> + +<h2>navigator.globalization.getPreferredLanguage</h2> + +<p>Get the BCP 47 language tag for the client's current language.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.getPreferredLanguage(successCallback, errorCallback); +</code></pre></div> +<h3>Description</h3> + +<p>Returns the BCP-47 compliant language identifier tag to the <code class="prettyprint">successCallback</code> +with a <code class="prettyprint">properties</code> object as a parameter. That object should have a <code class="prettyprint">value</code> +property with a <code class="prettyprint">String</code> value.</p> + +<p>If there is an error getting the language, then the <code class="prettyprint">errorCallback</code> +executes with a <code class="prettyprint">GlobalizationError</code> object as a parameter. The +error's expected code is <code class="prettyprint">GlobalizationError.UNKNOWN_ERROR</code>.</p> + +<h3>Supported Platforms</h3> + +<ul> +<li>Amazon Fire OS</li> +<li>Android</li> +<li>BlackBerry 10</li> +<li>Firefox OS</li> +<li>iOS</li> +<li>Windows Phone 8</li> +<li>Windows</li> +<li>Browser</li> +</ul> + +<h3>Example</h3> + +<p>When the browser is set to the <code class="prettyprint">en-US</code> language, this should display a +popup dialog with the text <code class="prettyprint">language: en-US</code>:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.getPreferredLanguage( + function (language) {alert('language: ' + language.value + '\n');}, + function () {alert('Error getting language\n');} +); +</code></pre></div> +<h3>Android Quirks</h3> + +<ul> +<li>Returns the ISO 639-1 two-letter language code, upper case ISO 3166-1 +country code and variant separated by hyphens. Examples: "en", "en-US", "US"</li> +</ul> + +<h3>Windows Phone 8 Quirks</h3> + +<ul> +<li>Returns the ISO 639-1 two-letter language code and ISO 3166-1 country code +of the regional variant corresponding to the "Language" setting, separated by +a hyphen.</li> +<li>Note that the regional variant is a property of the "Language" setting and +not determined by the unrelated "Country/Region" setting on Windows Phone.</li> +</ul> + +<h3>Windows Quirks</h3> + +<ul> +<li>Returns the ISO 639-1 two-letter language code and ISO 3166-1 country code +of the regional variant corresponding to the "Language" setting, separated by +a hyphen.</li> +</ul> + +<h3>Browser Quirks</h3> + +<ul> +<li>Falls back on getLocaleName</li> +</ul> + +<h2>navigator.globalization.getLocaleName</h2> + +<p>Returns the BCP 47 compliant tag for the client's current locale setting.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.getLocaleName(successCallback, errorCallback); +</code></pre></div> +<h3>Description</h3> + +<p>Returns the BCP 47 compliant locale identifier string to the <code class="prettyprint">successCallback</code> +with a <code class="prettyprint">properties</code> object as a parameter. That object should have a <code class="prettyprint">value</code> +property with a <code class="prettyprint">String</code> value. The locale tag will consist of a two-letter lower +case language code, two-letter upper case country code, and (unspecified) variant +code, separated by a hyphen.</p> + +<p>If there is an error getting the locale, then the <code class="prettyprint">errorCallback</code> +executes with a <code class="prettyprint">GlobalizationError</code> object as a parameter. The +error's expected code is <code class="prettyprint">GlobalizationError.UNKNOWN_ERROR</code>.</p> + +<h3>Supported Platforms</h3> + +<ul> +<li>Amazon Fire OS</li> +<li>Android</li> +<li>BlackBerry 10</li> +<li>Firefox OS</li> +<li>iOS</li> +<li>Windows Phone 8</li> +<li>Windows</li> +<li>Browser</li> +</ul> + +<h3>Example</h3> + +<p>When the browser is set to the <code class="prettyprint">en-US</code> locale, this displays a popup +dialog with the text <code class="prettyprint">locale: en-US</code>.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.getLocaleName( + function (locale) {alert('locale: ' + locale.value + '\n');}, + function () {alert('Error getting locale\n');} +); +</code></pre></div> +<h3>Android Quirks</h3> + +<ul> +<li>Java does not distinguish between a set "langauge" and set "locale," so this +method is essentially the same as <code class="prettyprint">navigator.globalization.getPreferredLanguage()</code>.</li> +</ul> + +<h3>Windows Phone 8 Quirks</h3> + +<ul> +<li>Returns the ISO 639-1 two-letter language code and ISO 3166-1 country code +of the regional variant corresponding to the "Regional Format" setting, separated +by a hyphen.</li> +</ul> + +<h3>Windows Quirks</h3> + +<ul> +<li>Locale setting can be changed in Control Panel -> Clock, Language and Region +-> Region -> Formats -> Format, +and in Settings -> Region -> Regional Format on Windows Phone 8.1.</li> +</ul> + +<h3>Browser Quirks</h3> + +<ul> +<li>IE returns the locale of operating system. Chrome and Firefox return browser language tag.</li> +</ul> + +<h2>navigator.globalization.dateToString</h2> + +<p>Returns a date formatted as a string according to the client's locale and timezone.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.dateToString(date, successCallback, errorCallback, options); +</code></pre></div> +<h3>Description</h3> + +<p>Returns the formatted date <code class="prettyprint">String</code> via a <code class="prettyprint">value</code> property accessible +from the object passed as a parameter to the <code class="prettyprint">successCallback</code>.</p> + +<p>The inbound <code class="prettyprint">date</code> parameter should be of type <code class="prettyprint">Date</code>.</p> + +<p>If there is an error formatting the date, then the <code class="prettyprint">errorCallback</code> +executes with a <code class="prettyprint">GlobalizationError</code> object as a parameter. The +error's expected code is <code class="prettyprint">GlobalizationError.FORMATTING_ERROR</code>.</p> + +<p>The <code class="prettyprint">options</code> parameter is optional, and its default values are:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">{formatLength:'short', selector:'date and time'} +</code></pre></div> +<p>The <code class="prettyprint">options.formatLength</code> can be <code class="prettyprint">short</code>, <code class="prettyprint">medium</code>, <code class="prettyprint">long</code>, or <code class="prettyprint">full</code>.</p> + +<p>The <code class="prettyprint">options.selector</code> can be <code class="prettyprint">date</code>, <code class="prettyprint">time</code> or <code class="prettyprint">date and time</code>.</p> + +<h3>Supported Platforms</h3> + +<ul> +<li>Amazon Fire OS</li> +<li>Android</li> +<li>BlackBerry 10</li> +<li>Firefox OS</li> +<li>iOS</li> +<li>Windows Phone 8</li> +<li>Windows</li> +<li>Browser</li> +</ul> + +<h3>Example</h3> + +<p>If the browser is set to the <code class="prettyprint">en_US</code> locale, this displays a popup +dialog with text similar to <code class="prettyprint">date: 9/25/2012 4:21PM</code> using the default +options:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.dateToString( + new Date(), + function (date) { alert('date: ' + date.value + '\n'); }, + function () { alert('Error getting dateString\n'); }, + { formatLength: 'short', selector: 'date and time' } +); +</code></pre></div> +<h3>Android Quirks</h3> + +<ul> +<li><code class="prettyprint">formatLength</code> options are a subset of Unicode +<a href="http://unicode.org/reports/tr35/tr35-4.html";>UTS #35</a>. The default option +<code class="prettyprint">short</code> depends on a user selected date format within +<code class="prettyprint">Settings -> System -> Date & time -> Choose date format</code>, +which provide a <code class="prettyprint">year</code> pattern only with 4 digits, not 2 digits. +This means that it is not completely aligned with +<a href="http://demo.icu-project.org/icu-bin/locexp?d_=en_US&_=en_US";>ICU</a>.</li> +</ul> + +<h3>Windows Phone 8 Quirks</h3> + +<ul> +<li><p>The <code class="prettyprint">formatLength</code> option supports only <code class="prettyprint">short</code> and <code class="prettyprint">full</code> values.</p></li> +<li><p>The pattern for 'date and time' selector is always a full datetime format.</p></li> +<li><p>The returned value may be not completely aligned with ICU depending on a user locale.</p></li> +</ul> + +<h3>Windows Quirks</h3> + +<ul> +<li><p>The <code class="prettyprint">formatLength</code> option supports only <code class="prettyprint">short</code> and <code class="prettyprint">full</code> values.</p></li> +<li><p>The pattern for 'date and time' selector is always a full datetime format.</p></li> +<li><p>The returned value may be not completely aligned with ICU depending on a user locale.</p></li> +</ul> + +<h3>Browser Quirks</h3> + +<ul> +<li><p>Only 79 locales are supported because moment.js is used in this method.</p></li> +<li><p>The returned value may be not completely aligned with ICU depending on a user locale.</p></li> +<li><p><code class="prettyprint">time</code> selector supports <code class="prettyprint">full</code> and <code class="prettyprint">short</code> formatLength only.</p></li> +</ul> + +<h3>Firefox OS Quirks</h3> + +<ul> +<li><code class="prettyprint">formatLength</code> is not distinguishing <code class="prettyprint">long</code> and <code class="prettyprint">full</code></li> +<li>only one method of displaying date (no <code class="prettyprint">long</code> or <code class="prettyprint">full</code> version)</li> +</ul> + +<h2>navigator.globalization.getCurrencyPattern</h2> + +<p>Returns a pattern string to format and parse currency values according +to the client's user preferences and ISO 4217 currency code.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text"> navigator.globalization.getCurrencyPattern(currencyCode, successCallback, errorCallback); +</code></pre></div> +<h3>Description</h3> + +<p>Returns the pattern to the <code class="prettyprint">successCallback</code> with a <code class="prettyprint">properties</code> object +as a parameter. That object should contain the following properties:</p> + +<ul> +<li><p><strong>pattern</strong>: The currency pattern to format and parse currency values. The patterns follow <a href="http://unicode.org/reports/tr35/tr35-4.html";>Unicode Technical Standard #35</a>. <em>(String)</em></p></li> +<li><p><strong>code</strong>: The ISO 4217 currency code for the pattern. <em>(String)</em></p></li> +<li><p><strong>fraction</strong>: The number of fractional digits to use when parsing and formatting currency. <em>(Number)</em></p></li> +<li><p><strong>rounding</strong>: The rounding increment to use when parsing and formatting. <em>(Number)</em></p></li> +<li><p><strong>decimal</strong>: The decimal symbol to use for parsing and formatting. <em>(String)</em></p></li> +<li><p><strong>grouping</strong>: The grouping symbol to use for parsing and formatting. <em>(String)</em></p></li> +</ul> + +<p>The inbound <code class="prettyprint">currencyCode</code> parameter should be a <code class="prettyprint">String</code> of one of +the ISO 4217 currency codes, for example 'USD'.</p> + +<p>If there is an error obtaining the pattern, then the <code class="prettyprint">errorCallback</code> +executes with a <code class="prettyprint">GlobalizationError</code> object as a parameter. The +error's expected code is <code class="prettyprint">GlobalizationError.FORMATTING_ERROR</code>.</p> + +<h3>Supported Platforms</h3> + +<ul> +<li>Amazon Fire OS</li> +<li>Android</li> +<li>BlackBerry 10</li> +<li>iOS</li> +<li>Windows</li> +</ul> + +<h3>Example</h3> + +<p>When the browser is set to the <code class="prettyprint">en_US</code> locale and the selected +currency is United States Dollars, this example displays a popup +dialog with text similar to the results that follow:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">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'); } +); +</code></pre></div> +<p>Expected result:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">pattern: $#,##0.##;($#,##0.##) +code: USD +fraction: 2 +rounding: 0 +decimal: . +grouping: , +</code></pre></div> +<h3>Windows Quirks</h3> + +<ul> +<li>Only 'code' and 'fraction' properties are supported</li> +</ul> + +<h2>navigator.globalization.getDateNames</h2> + +<p>Returns an array of the names of the months or days of the week, +depending on the client's user preferences and calendar.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.getDateNames(successCallback, errorCallback, options); +</code></pre></div> +<h3>Description</h3> + +<p>Returns the array of names to the <code class="prettyprint">successCallback</code> with a +<code class="prettyprint">properties</code> object as a parameter. That object contains a <code class="prettyprint">value</code> +property with an <code class="prettyprint">Array</code> of <code class="prettyprint">String</code> values. The array features names +starting from either the first month in the year or the first day of +the week, depending on the option selected.</p> + +<p>If there is an error obtaining the names, then the <code class="prettyprint">errorCallback</code> +executes with a <code class="prettyprint">GlobalizationError</code> object as a parameter. The +error's expected code is <code class="prettyprint">GlobalizationError.UNKNOWN_ERROR</code>.</p> + +<p>The <code class="prettyprint">options</code> parameter is optional, and its default values are:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">{type:'wide', item:'months'} +</code></pre></div> +<p>The value of <code class="prettyprint">options.type</code> can be <code class="prettyprint">narrow</code> or <code class="prettyprint">wide</code>.</p> + +<p>The value of <code class="prettyprint">options.item</code> can be <code class="prettyprint">months</code> or <code class="prettyprint">days</code>.</p> + +<h3>Supported Platforms</h3> + +<ul> +<li>Amazon Fire OS</li> +<li>Android</li> +<li>BlackBerry 10</li> +<li>Firefox OS</li> +<li>iOS</li> +<li>Windows Phone 8</li> +<li>Windows</li> +<li>Browser</li> +</ul> + +<h3>Example</h3> + +<p>When the browser is set to the <code class="prettyprint">en_US</code> locale, this example displays +a series of twelve popup dialogs, one per month, with text similar to +<code class="prettyprint">month: January</code>:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">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' } +); +</code></pre></div> +<h3>Firefox OS Quirks</h3> + +<ul> +<li><code class="prettyprint">options.type</code> supports a <code class="prettyprint">genitive</code> value, important for some languages.</li> +</ul> + +<h3>Windows Phone 8 Quirks</h3> + +<ul> +<li>The array of months contains 13 elements.</li> +<li>The returned array may be not completely aligned with ICU depending on a user locale.</li> +</ul> + +<h3>Windows Quirks</h3> + +<ul> +<li>The array of months contains 12 elements.</li> +<li>The returned array may be not completely aligned with ICU depending on a user locale.</li> +</ul> + +<h3>Browser Quirks</h3> + +<ul> +<li>Date names are not completely aligned with ICU.</li> +<li>The array of months contains 12 elements.</li> +</ul> + +<h2>navigator.globalization.getDatePattern</h2> + +<p>Returns a pattern string to format and parse dates according to the +client's user preferences.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.getDatePattern(successCallback, errorCallback, options); +</code></pre></div> +<h3>Description</h3> + +<p>Returns the pattern to the <code class="prettyprint">successCallback</code>. The object passed in as +a parameter contains the following properties:</p> + +<ul> +<li><p><strong>pattern</strong>: The date and time pattern to format and parse dates. The patterns follow <a href="http://unicode.org/reports/tr35/tr35-4.html";>Unicode Technical Standard #35</a>. <em>(String)</em></p></li> +<li><p><strong>timezone</strong>: The abbreviated name of the time zone on the client. <em>(String)</em></p></li> +<li><p><strong>utc_offset</strong>: The current difference in seconds between the client's time zone and coordinated universal time. <em>(Number)</em></p></li> +<li><p><strong>dst_offset</strong>: The current daylight saving time offset in seconds between the client's non-daylight saving's time zone and the client's daylight saving's time zone. <em>(Number)</em></p></li> +</ul> + +<p>If there is an error obtaining the pattern, the <code class="prettyprint">errorCallback</code> +executes with a <code class="prettyprint">GlobalizationError</code> object as a parameter. The +error's expected code is <code class="prettyprint">GlobalizationError.PATTERN_ERROR</code>.</p> + +<p>The <code class="prettyprint">options</code> parameter is optional, and defaults to the following values:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">{formatLength:'short', selector:'date and time'} +</code></pre></div> +<p>The <code class="prettyprint">options.formatLength</code> can be <code class="prettyprint">short</code>, <code class="prettyprint">medium</code>, <code class="prettyprint">long</code>, or +<code class="prettyprint">full</code>. The <code class="prettyprint">options.selector</code> can be <code class="prettyprint">date</code>, <code class="prettyprint">time</code> or <code class="prettyprint">date and +time</code>.</p> + +<h3>Supported Platforms</h3> + +<ul> +<li>Amazon Fire OS</li> +<li>Android</li> +<li>BlackBerry 10</li> +<li>iOS</li> +<li>Windows Phone 8</li> +<li>Windows</li> +<li>Browser</li> +</ul> + +<h3>Example</h3> + +<p>When the browser is set to the <code class="prettyprint">en_US</code> locale, this example displays +a popup dialog with text such as <code class="prettyprint">pattern: M/d/yyyy h:mm a</code>:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">function checkDatePattern() { + navigator.globalization.getDatePattern( + function (date) { alert('pattern: ' + date.pattern + '\n'); }, + function () { alert('Error getting pattern\n'); }, + { formatLength: 'short', selector: 'date and time' } + ); +} +</code></pre></div> +<h3>Windows Phone 8 Quirks</h3> + +<ul> +<li><p>The <code class="prettyprint">formatLength</code> supports only <code class="prettyprint">short</code> and <code class="prettyprint">full</code> values.</p></li> +<li><p>The <code class="prettyprint">pattern</code> for <code class="prettyprint">date and time</code> pattern returns only full datetime format.</p></li> +<li><p>The <code class="prettyprint">timezone</code> returns the full time zone name.</p></li> +<li><p>The <code class="prettyprint">dst_offset</code> property is not supported, and always returns zero.</p></li> +<li><p>The pattern may be not completely aligned with ICU depending on a user locale.</p></li> +</ul> + +<h3>Windows Quirks</h3> + +<ul> +<li><p>The <code class="prettyprint">formatLength</code> supports only <code class="prettyprint">short</code> and <code class="prettyprint">full</code> values.</p></li> +<li><p>The <code class="prettyprint">pattern</code> for <code class="prettyprint">date and time</code> pattern returns only full datetime format.</p></li> +<li><p>The <code class="prettyprint">timezone</code> returns the full time zone name.</p></li> +<li><p>The <code class="prettyprint">dst_offset</code> property is not supported, and always returns zero.</p></li> +<li><p>The pattern may be not completely aligned with ICU depending on a user locale.</p></li> +</ul> + +<h3>Browser Quirks</h3> + +<ul> +<li><p>The 'pattern' property is not supported and returns empty string.</p></li> +<li><p>Only Chrome returns 'timezone' property. Its format is "Part of the world/{City}". +Other browsers return empty string.</p></li> +</ul> + +<h2>navigator.globalization.getFirstDayOfWeek</h2> + +<p>Returns the first day of the week according to the client's user +preferences and calendar.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.getFirstDayOfWeek(successCallback, errorCallback); +</code></pre></div> +<h3>Description</h3> + +<p>The days of the week are numbered starting from 1, where 1 is assumed +to be Sunday. Returns the day to the <code class="prettyprint">successCallback</code> with a +<code class="prettyprint">properties</code> object as a parameter. That object should have a <code class="prettyprint">value</code> +property with a <code class="prettyprint">Number</code> value.</p> + +<p>If there is an error obtaining the pattern, then the <code class="prettyprint">errorCallback</code> +executes with a <code class="prettyprint">GlobalizationError</code> object as a parameter. The +error's expected code is <code class="prettyprint">GlobalizationError.UNKNOWN_ERROR</code>.</p> + +<h3>Supported Platforms</h3> + +<ul> +<li>Amazon Fire OS</li> +<li>Android</li> +<li>BlackBerry 10</li> +<li>Firefox OS</li> +<li>iOS</li> +<li>Windows Phone 8</li> +<li>Windows</li> +<li>Browser</li> +</ul> + +<h3>Example</h3> + +<p>When the browser is set to the <code class="prettyprint">en_US</code> locale, this displays a +popup dialog with text similar to <code class="prettyprint">day: 1</code>.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.getFirstDayOfWeek( + function (day) {alert('day: ' + day.value + '\n');}, + function () {alert('Error getting day\n');} +); +</code></pre></div> +<h3>Windows Quirks</h3> + +<ul> +<li>On Windows 8.0/8.1 the value depends on user' calendar preferences. On Windows Phone 8.1 +the value depends on current locale.</li> +</ul> + +<h3>Browser Quirks</h3> + +<ul> +<li>Only 79 locales are supported because moment.js is used in this method.</li> +</ul> + +<h2>navigator.globalization.getNumberPattern</h2> + +<p>Returns a pattern string to format and parse numbers according to the client's user preferences.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.getNumberPattern(successCallback, errorCallback, options); +</code></pre></div> +<h3>Description</h3> + +<p>Returns the pattern to the <code class="prettyprint">successCallback</code> with a <code class="prettyprint">properties</code> object +as a parameter. That object contains the following properties:</p> + +<ul> +<li><p><strong>pattern</strong>: The number pattern to format and parse numbers. The patterns follow <a href="http://unicode.org/reports/tr35/tr35-4.html";>Unicode Technical Standard #35</a>. <em>(String)</em></p></li> +<li><p><strong>symbol</strong>: The symbol to use when formatting and parsing, such as a percent or currency symbol. <em>(String)</em></p></li> +<li><p><strong>fraction</strong>: The number of fractional digits to use when parsing and formatting numbers. <em>(Number)</em></p></li> +<li><p><strong>rounding</strong>: The rounding increment to use when parsing and formatting. <em>(Number)</em></p></li> +<li><p><strong>positive</strong>: The symbol to use for positive numbers when parsing and formatting. <em>(String)</em></p></li> +<li><p><strong>negative</strong>: The symbol to use for negative numbers when parsing and formatting. <em>(String)</em></p></li> +<li><p><strong>decimal</strong>: The decimal symbol to use for parsing and formatting. <em>(String)</em></p></li> +<li><p><strong>grouping</strong>: The grouping symbol to use for parsing and formatting. <em>(String)</em></p></li> +</ul> + +<p>If there is an error obtaining the pattern, then the <code class="prettyprint">errorCallback</code> +executes with a <code class="prettyprint">GlobalizationError</code> object as a parameter. The +error's expected code is <code class="prettyprint">GlobalizationError.PATTERN_ERROR</code>.</p> + +<p>The <code class="prettyprint">options</code> parameter is optional, and default values are:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">{type:'decimal'} +</code></pre></div> +<p>The <code class="prettyprint">options.type</code> can be <code class="prettyprint">decimal</code>, <code class="prettyprint">percent</code>, or <code class="prettyprint">currency</code>.</p> + +<h3>Supported Platforms</h3> + +<ul> +<li>Amazon Fire OS</li> +<li>Android</li> +<li>BlackBerry 10</li> +<li>iOS</li> +<li>Windows Phone 8</li> +<li>Windows</li> +<li>Browser</li> +</ul> + +<h3>Example</h3> + +<p>When the browser is set to the <code class="prettyprint">en_US</code> locale, this should display a +popup dialog with text similar to the results that follow:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">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'} +); +</code></pre></div> +<p>Results:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">pattern: #,##0.### +symbol: . +fraction: 0 +rounding: 0 +positive: +negative: - +decimal: . +grouping: , +</code></pre></div> +<h3>Windows Phone 8 Quirks</h3> + +<ul> +<li><p>The <code class="prettyprint">pattern</code> property is not supported, and returns an empty string.</p></li> +<li><p>The <code class="prettyprint">fraction</code> property is not supported, and returns zero.</p></li> +</ul> + +<h3>Windows Quirks</h3> + +<ul> +<li>The <code class="prettyprint">pattern</code> property is not supported, and returns an empty string.</li> +</ul> + +<h3>Browser Quirks</h3> + +<ul> +<li>getNumberPattern is supported in Chrome only; the only defined property is <code class="prettyprint">pattern</code>.</li> +</ul> + +<h2>navigator.globalization.isDayLightSavingsTime</h2> + +<p>Indicates whether daylight savings time is in effect for a given date +using the client's time zone and calendar.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.isDayLightSavingsTime(date, successCallback, errorCallback); +</code></pre></div> +<h3>Description</h3> + +<p>Indicates whether or not daylight savings time is in effect to the +<code class="prettyprint">successCallback</code> with a <code class="prettyprint">properties</code> object as a parameter. That object +should have a <code class="prettyprint">dst</code> property with a <code class="prettyprint">Boolean</code> value. A <code class="prettyprint">true</code> value +indicates that daylight savings time is in effect for the given date, +and <code class="prettyprint">false</code> indicates that it is not.</p> + +<p>The inbound parameter <code class="prettyprint">date</code> should be of type <code class="prettyprint">Date</code>.</p> + +<p>If there is an error reading the date, then the <code class="prettyprint">errorCallback</code> +executes. The error's expected code is <code class="prettyprint">GlobalizationError.UNKNOWN_ERROR</code>.</p> + +<h3>Supported Platforms</h3> + +<ul> +<li>Amazon Fire OS</li> +<li>Android</li> +<li>BlackBerry 10</li> +<li>Firefox OS</li> +<li>iOS</li> +<li>Windows Phone 8</li> +<li>Windows</li> +<li>Browser</li> +</ul> + +<h3>Example</h3> + +<p>During the summer, and if the browser is set to a DST-enabled +timezone, this should display a popup dialog with text similar to +<code class="prettyprint">dst: true</code>:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.isDayLightSavingsTime( + new Date(), + function (date) {alert('dst: ' + date.dst + '\n');}, + function () {alert('Error getting names\n');} +); +</code></pre></div> +<h2>navigator.globalization.numberToString</h2> + +<p>Returns a number formatted as a string according to the client's user preferences.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.numberToString(number, successCallback, errorCallback, options); +</code></pre></div> +<h3>Description</h3> + +<p>Returns the formatted number string to the <code class="prettyprint">successCallback</code> with a +<code class="prettyprint">properties</code> object as a parameter. That object should have a <code class="prettyprint">value</code> +property with a <code class="prettyprint">String</code> value.</p> + +<p>If there is an error formatting the number, then the <code class="prettyprint">errorCallback</code> +executes with a <code class="prettyprint">GlobalizationError</code> object as a parameter. The +error's expected code is <code class="prettyprint">GlobalizationError.FORMATTING_ERROR</code>.</p> + +<p>The <code class="prettyprint">options</code> parameter is optional, and its default values are:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">{type:'decimal'} +</code></pre></div> +<p>The <code class="prettyprint">options.type</code> can be <code class="prettyprint">decimal</code>, <code class="prettyprint">percent</code>, or <code class="prettyprint">currency</code>.</p> + +<h3>Supported Platforms</h3> + +<ul> +<li>Amazon Fire OS</li> +<li>Android</li> +<li>BlackBerry 10</li> +<li>iOS</li> +<li>Windows Phone 8</li> +<li>Windows</li> +<li>Browser</li> +</ul> + +<h3>Example</h3> + +<p>When the browser is set to the <code class="prettyprint">en_US</code> locale, this displays a popup +dialog with text similar to <code class="prettyprint">number: 3.142</code>:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.numberToString( + 3.1415926, + function (number) {alert('number: ' + number.value + '\n');}, + function () {alert('Error getting number\n');}, + {type:'decimal'} +); +</code></pre></div> +<h3>Windows Quirks</h3> + +<ul> +<li><p>Windows 8.0 does not support number rounding, therefore values will not be rounded automatically.</p></li> +<li><p>On Windows 8.1 and Windows Phone 8.1 fractional part is being truncated instead of rounded in case of <code class="prettyprint">percent</code> number type therefore fractional digits count is set to 0.</p></li> +<li><p><code class="prettyprint">percent</code> numbers are not grouped as they can't be parsed in stringToNumber if grouped.</p></li> +</ul> + +<h3>Browser Quirks</h3> + +<ul> +<li><code class="prettyprint">currency</code> type is not supported.</li> +</ul> + +<h2>navigator.globalization.stringToDate</h2> + +<p>Parses a date formatted as a string, according to the client's user +preferences and calendar using the time zone of the client, and +returns the corresponding date object.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">navigator.globalization.stringToDate(dateString, successCallback, errorCallback, options); +</code></pre></div> +<h3>Description</h3> + +<p>Returns the date to the success callback with a <code class="prettyprint">properties</code> object as +a parameter. That object should have the following properties:</p> + +<ul> +<li><p><strong>year</strong>: The four digit year. <em>(Number)</em></p></li> +<li><p><strong>month</strong>: The month from (0-11). <em>(Number)</em></p></li> +<li><p><strong>day</strong>: The day from (1-31). <em>(Number)</em></p></li> +<li><p><strong>hour</strong>: The hour from (0-23). <em>(Number)</em></p></li> +<li><p><strong>minute</strong>: The minute from (0-59). <em>(Number)</em></p></li> +<li><p><strong>second</strong>: The second from (0-59). <em>(Number)</em></p></li> +<li><p><strong>millisecond</strong>: The milliseconds (from 0-999), not available on all platforms. <em>(Number)</em></p></li> +</ul> + +<p>The inbound <code class="prettyprint">dateString</code> parameter should be of type <code class="prettyprint">String</code>.</p> + +<p>The <code class="prettyprint">options</code> parameter is optional, and defaults to the following +values:</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">{formatLength:'short', selector:'date and time'} +</code></pre></div> +<p>The <code class="prettyprint">options.formatLength</code> can be <code class="prettyprint">short</code>, <code class="prettyprint">medium</code>, <code class="prettyprint">long</code>, or +<code class="prettyprint">full</code>. The <code class="prettyprint">options.selector</code> can be <code class="prettyprint">date</code>, <code class="prettyprint">time</code> or <code class="prettyprint">date and +time</code>.</p> + +<p>If there is an error parsing the date string, then the <code class="prettyprint">errorCallback</code> +executes with a <code class="prettyprint">GlobalizationError</code> object as a parameter. The +error's expected code is <code class="prettyprint">GlobalizationError.PARSING_ERROR</code>.</p> + +<h3>Supported Platforms</h3> + +<ul> +<li>Amazon Fire OS</li> +<li>Android</li> +<li>BlackBerry 10</li> +<li>Firefox OS</li> +<li>iOS</li> +<li>Windows Phone 8</li> +<li>Windows</li> +<li>Browser</li> +</ul> + +<h3>Example</h3> + +<p>When the browser is set to the <code class="prettyprint">en_US</code> locale, this displays a +popup dialog with text similar to <code class="prettyprint">month:8 day:25 year:2012</code>. Note +that the month integer is one less than the string, as the month +integer represents an array index.</p> +<div class="highlight"><pre><code class="language-text" data-lang="text">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'} +); +</code></pre></div> +<h3>Windows Phone 8 Quirks</h3> + +<ul> +<li><p>The <code class="prettyprint">formatLength</code> option supports only <code class="prettyprint">short</code> and <code class="prettyprint">full</code> values.</p></li> +<li><p>The pattern for 'date and time' selector is always a full datetime format.</p></li> +<li><p>The inbound <code class="prettyprint">dateString</code> parameter should be formed in compliance with a pattern returned by getDatePattern. +This pattern may be not completely aligned with ICU depending on a user locale.</p></li> +</ul> + +<h3>Windows Quirks</h3> + +<ul> +<li><p>The <code class="prettyprint">formatLength</code> option supports only <code class="prettyprint">short</code> and <code class="prettyprint">full</code> values.</p></li> +<li><p>The pattern for 'date and time' selector is always a full datetime format.</p></li> +<li><p>The inbound <code class="prettyprint">dateString</code> parameter should be formed in compliance with a pattern returned by getDatePattern. +This pattern may be not completely aligned with ICU depending on a user locale.</p></li> +</ul> + +<h3>Browser Quirks</h3> + +<ul> +<li><p>Only 79 locales are supported because moment.js is used in this method.</p></li> +<li><p>Inbound string should be aligned with <code class="prettyprint">dateToString</code> output format and may not completely aligned with ICU depending on a user locale.</p></li> +<li><p><code class="prettyprint">time</code> selector supports <code class="prettyprint">full</code> and <code class="prettyprint">short</code> formatLength only.</p></li> +</ul> +
[... 197 lines stripped ...] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
![https://travis-ci.org/apache/cordova-plugin-globalization.svg?branch=master"](https://travis-ci.org/apache/cordova-plugin-globalization.svg?branch=master"){kind=link}