Developer

Dates and Timestamps

Dates are localized as customers enter them, and always use their time zone.

The generic Web UI uses the jQuery datepicker plug-in for date selection. This plug-in supplies a series of internationalized text labels for months, days, and input-display formats. The plug-in provides most language variants, and some localization exists for languages that have not been completely localized across the environment. For example, the datepicker plug-in provides some Arabic localization, but full Arabic language support and right-to-left rendering is not provided in the generic Web UI.

A sample datepicker plug-in localization file is scripts\jquery\i18n\jquery.datepicker-af.js:
/* Updated for SMS Builder Web UI by msw@sybase.com */    
/* monthNames and monthNamesShort changed to match JODA text so that validation and */
/* conversion works with Wicket PatternDateConverter */    
/* Note: If ’en’ month names are being used, it is because there are no JODA-specific */
/* values for this locale, and that is what it is expecting */    
/* Afrikaans initialisation for the jQuery datepicker plugin. */    
/* Written by Renier Pretorius. */
    
jQuery (function($) {    
  $.datepicker.regional [’af’] = {    
    closeText:’Selekteer’,   
    prevText:’Vorige’,    
    nextText:’Volgende’,    
    currentText:’Vandag’,    
    monthNames:[’January’,’February’,’March’,’April’,’May’,’June’,’July’,’August’,’September’,’October’,’November’,’December’],   
    monthNamesShort:[’Jan’,’Feb’,’Mar’,’Apr’,’May’,’Jun’,’Jul’,’Aug’,’Sep’,’Oct’,’Nov’,’Dec’],    
    dayNames:[’Sondag’,’Maandag’,’Dinsdag’,’Woensdag’,’Donderdag’,’Vrydag’,’Saterdag’],    
    dayNamesShort:[’Son’,’Maa',’Din’,’Woe’,’Don’,’Vry’,’Sat’],    
    dayNamesMin:[’So’,’Ma’,’Di’,’Wo’,’Do’,’Vr’,’Sa’],    
    weekHeader:’Wk’,    
    dateFormat:’dd/mm/yy’,    
    firstDay:1,    
    isRTL:false,    
    showMonthAfterYear:false ,    
    yearSuffix:’’};    
    $.datepicker.setDefaults($.datepicker.regional[’af’]);    
 }
); 

Localization files have been modified slightly from their original versions, as noted in the code comments. Dates that are generated by the datepicker plug-in are passed to Wicket for validation and conversion to internal Wicket date/time objects. Wicket uses the Java open source Joda-time library classes for this. Joda-time localized month names are not the same as the datepicker standard (or Java standard) month names. If a month name is not known by Joda-time classes, conversion and validation fail. Therefore, month names have been modified for all localized datepicker plug-in files to match the Joda-time equivalent values.