toLocaleString

Summary

Returns a date converted to a string using the current locale.

Syntax

dateObj.toLocaleString()

Examples

The following example illustrates the use of the toLocaleString method.

function toLocaleStrDemo(){
    var d, s;                      //Declare variables.
    d = new Date();                //Create Date object.
    s = "Current setting is ";
    s += d.toLocaleString() ;       //Convert to current locale.
    return(s);                     //Return converted date
 }

Remarks

The required dateObj is any Date object.

The toLocaleString method returns a String object that contains the date written in the current locale’s long default format.

For dates between 1601 and 1999 A.D., the date is formatted according to the user’s Control Panel Regional Settings.
For dates outside this range, the default format of the toString method is used.

For example, in the United States, toLocaleString returns “01/05/96 00:00:00” for January 5. In Europe, it returns “05/01/96 00:00:00” for the same date, as European convention puts the day before the month.

Note – toLocaleString should only be used to display results to a user; it should never be used as the basis for computation within a script as the returned result is machine-specific.

Attributions

Microsoft Developer Network: Article