Locale-Sensitive JavaScript Method

date.setMonth(month);
date.setMonth(month, day);


Internationalization (I18n) Method Overview

The setMonth method sets the month (0-11) and optional day for the date object, based on the system's local time zone.

Click here (w3schools) and here (MDN) for additional details.

I18n Issues

Whether or not calling setMonth is an i18n issue is dependent on how it is being used in the application. Two possible issues are:

• The system's local time zone is being used rather than either UTC or the application's time zone. It is usually recommended that all stored dates be in UTC time zone so that they can be retrieved and displayed based on the application's time zone.
• The month + day value is assumed to be the start of the week rather than using the locale to determine the start of the week.

Suggested Replacement

To address the first i18n issue, call setUTCMonth to use UTC time zone rather than local time zone. Then, when displaying the date, call one of the locale-sensitive date methods, which support setting the time zone as well as using the locale to format the date:

toLocaleDateString
toLocaleString
toLocaleTimeString To support the weekday starting value based on locale, you will need to either use a 3rd party javascript calendar library or retrieve the value from a locale-sensitive resource file.

Globalyzer will detect this method and report it as an i18n issue. If you have determined that the call is being handled correctly, you can use Globalyzer's Ignore Comment functionality to ensure that it isn't picked up in a subsequent scan.