Format date and time in a human readable format.
Format the given date and time in a human readable format.
The underlying operating system is used to format the date and time.
Pass an empty string as the locale parameter to use the OS settings with
the preferred date and time formatting given by the user.
Pass a locale code as described in nsILocale as the locale parameter
(e.g. en-US) to use a specific locale. If the given locale is not
available, a fallback will be used.
NOTE: The output of this method depends on the operating system and user
settings. Even if you pass a locale code as the first parameter, there
are no guarantees about which locale and exact format the returned value
uses. Even if you know the locale, the format might be customized by the
user. Therefore you should not use the returned values in contexts where
you depend on any specific format or language.
| locale | Locale code of locale used to format the date or an empty string to follow user preference. |
| dateFormatSelector | Indicate which format should preferably be used for the date. Use one of the dateFormat* constants. |
| timeFormatSelector | Indicate which format should preferably be used for the time. Use one of the timeFormat* constants. |
| year, | month, day, hour, minute and second The date and time to be formatted, given in the computer's local time zone. |
| The date and time formatted as human readable text according to user preferences or the given locale. |
Format the given date in a human readable format.
See FormatDateTime for details.
Format the given time in a human readable format.
See FormatDateTime for details.
Do not include the date in the format string.
Provide the long date format.
NOTE:
The original definitions of dateFormatLong and dateFormatShort are from
the Windows platform.
In US English dateFormatLong output will be like:
Wednesday, January 29, 2003 4:02:14 PM
In US English dateFormatShort output will be like:
1/29/03 4:02:14 PM
On platforms like Linux, it is rather difficult to achieve exact
same output, and since we are aiming at human readers, it does not make
sense to achieve exact same result. We will do just enough as the
platform allow us to do.
Provide the short date format. See also dateFormatLong.
Format using only the year and month.
Provide the Week day (e.g. Mo, Mon, Monday or similar).
Don’t include the time in the format string.
Provide the time format with seconds.
Provide the time format without seconds.
Provide the time format with seconds, and force the time format to use
24-hour clock, regardless of the locale conventions.
Provide the time format without seconds, and force the time format to use
24-hour clock, regardless of the locale conventions.