Web UI Framework localization - setting locale-specific formats

Date/time formats

Date and time formats can vary among countries or regions. For example, April 2, 2003 could be written as 02/04/03 in one country or region and 04/02/03 in another country or region. You can use the validation.js file to localize date/time formats.

In validation.js, all date/time formats are in the PHP format. The validation.js file includes a Java-to-PHP conversion table.

User date/time formats are set as follows:

sc.plat.Userprefs.setDateFormat('m/d/Y');
sc.plat.Userprefs.setTimeFormat('H:i:s');
sc.plat.Userprefs.setTimestampFormat('Y-m-d\\TH:i:sP');
sc.plat.Userprefs.setMonthDisplayDateFormat('F Y');
sc.plat.Userprefs.setDayDisplayDateFomrat('N j');
sc.plat.Userprefs.setHourMinuteTimeFormat('H:i');
sc.plat.Userprefs.setDateHourMinuteFormat('m/d/Y H:i');

Server date/time formats are set as follows:

sc.plat.info.Application.setDateFormat('Y-m-d');
sc.plat.info.Application.setTimeFormat('H:i:s');
sc.plat.info.Application.setTimestampFormat('Y-m-d\\TH:i:sP');

EXT specific formats

You can localize the following Ext specific locale formats using the platformExtLocaleSpecificFormatsHolderObj object in the validation.js file:

platformExtLocaleSpecificFormatsHolderObj = function() {
   return ({
   //Provide the Date format that should be displayed in the error message for
   //Date. Ideally, this should be in java format.
   getDisplayDateFormat: function() {
      var displayDateFormat = "MM/dd/yyyy";
      return displayDateFormat;
   }
   //Provide the suffixes to add to numbers. For example: 1st, 2nd, 3rd, 4th
   //and so on.
   , getNumberSuffixes: function() {
      var numberSuffixes = "(?:st|nd|rd|th)";
      return numberSuffixes;
   }
   //AM Time in lower case. am/pm stands for AM/PM (before noon/after noon) in
   //lower case.
   , getAMString: function() {
      var amString = "am";
      return amString;
   }
   //PM Time in lower case.. am/pm stands for AM/PM (before noon/after noon) in
   //lower case.
   , getPMString: function() {
      var pmString = "pm";
      return pmString;
   }
   //Alternate Date formats for current locale.
   , getAltDateFormats: function() {
      var altDateFormats = "m/d/Y|m-d-y|m-d-Y|m/d|m-d|md|mdy|mdY|d|Y-m-d";
      return altDateFormats;
   }
   //Date format for PropertyColumn.
   , getPropertyColumnModelDateFormat: function() {
      var propertyColModelDateFormat = "m/j/Y";
      return propertyColModelDateFormat;
   }
   //The number format to use for NumberColumn. This is Ext 3 specific.
   , getNumberColumnDefaultFormat: function() {
      var numberColFormat = "0,000.00";
      return numberColFormat;
   }
   //The Time format for TimeField in current locale.
   , getDefaultTimeFormatString: function() {
      var defaultTimeFormatString = "g:i A";
      return defaultTimeFormatString;
   }
   //Alternate Time formats for current locale.
   , getAltTimeFormats: function() {
      var altTimeFormats = "g:ia|g:iA|g:i a|g:i A|h:i|g:i|H:i|ga|ha|gA|h a|g a|
g A|gi|hi|gia|hia|g|H";
      return altTimeFormats;
   }
});
}();

Date format differences betweenJava andJavaScript

Make sure that you use the proper date formatting (Java™ or JavaScript) to accurately format dates for locales. In JavaScript, the PHP/Ext JS format is supported.

The date formats in Java and JavaScript are not the same. The date 01/03/2010 is in the "MM/dd/yyyy" format in Java, which is equivalent to "m/d/Y" in JavaScript. In the same way, the date 1/3/10 (notice the missing zeros in the date and month) is in the "M/d/yy" format in Java, which is equivalent to "n/j/y" in JavaScript.

Decimal separator

sc.plat.Userprefs.setDecimalSeparator(".");

sc.plat.Userprefs.setDecimalSeparator(",");

Grouping separator

sc.plat.Userprefs.setGroupingSeperator();

sc.plat.Userprefs.setGroupingSeperator(",");

Grouping and formatting numbers

sc.plat.NumberFormatter.formatNumber("3");

For example, if the group size is set t o"3" , the number 1000000 is displayed as 1,000,000, where "," is the grouping separator.

E-mail addresses, phone number, and credit card formats