Returns a date converted to a string using the current locale.
dateObj.toLocaleString() |
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. |
Example
The following example illustrates the use of the toLocaleString method.
Copy Code | |
---|---|
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 } |
Requirements
Applies To: Array Object (JScript 5.6)| Date Object (JScript 5.6)| Number Object (JScript 5.6)| Object Object (JScript 5.6)