toLocaleString Method

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


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 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.


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


Version 1

See Also

Date Object Methods

Applies To: Array Object | Date Object | Number Object | Object Object