Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
2008-04-13 [geoffrey.mcgill]
Revision #162
1. Fixed bug in sugarpak.js where .toISOString was not correctly checking the Date.prototype
if an instance of .toISOString was already in the dom.
2. Moved .toISOString() from sugarpak.js to core.js. Function remains otherwise unchanged.
3. Renamed .getDayOfYear() function to the proper name of .getOrdinalNumber().
Example
// Old
Date.today().getDayOfYear(); // 103
// New
Date.today().getOrdinalNumber(); // 103
4. Fixed bug in core.js where .getOrdinalNumber() was not including the current day in the calculation.
For example 1-Jan-2008 would return '0', although it is the 'first' day of the year.
The .getOrdinalNumber() function now includes the current day in the calculation.
Example
// Old (15-Jan-2008)
new Date(2008, 0, 15).getOrdinalNumber(); // 14
// New
new Date(2008, 0, 15).getOrdinalNumber(); // 15
5. Added new "S" format specifier as option in .toString(). The "S" format specifier will return
the ordinal suffix ("st, "nd", "rd" or "th") value of the Day.
Example
// Old
Date.today().getOrdinal(); // "th"
// New
Date.today().toString("S"); // "th"
It's also possible to use the ordinal format specifier as part of larger format string.
Example
Date.today().toString("MMMM dS, yyyy"); // "April 12th, 2008"
6. Removed .getOrdinal function from sugarpak.js. Please use .toString("S").
7. Contemplated adding "z", "zz" and "zzz" as format specifiers, but changed my mind.
For future reference here's the code required if adding "z*" support to .toString().
// Add to .toString()
case "z":
return x.toString("zz").replace("0", "");
case "zz":
return z.substring(0, z.length - 2);
case "zzz":
return z.substring(0, z.length - 2) + ":" + z.substring(z.length - 2);
// Documentation
z The offset time zone from UTC in hours. "–12" through "+13", "-6"
zz The offset time zone from UTC in hours with leading zero. "–12" through "+13", "-06"
zzz The offset time zone from UTC in hours and minutes. "–12:00" through "+13:00", "-06:00"
8. Contemplated add "fff" as format specifier option of .toString() but changed my mind.
For future reference, here's the code required if adding "fff" support to .toString().
// Add to .toString()
case "fff":
var y = "00" + x.getMilliseconds();
return y.substring(y.length - 3);
// Documentation
fff The milliseconds between 000-999. "000" to "999"
9. Changed return type of .getISOWeek to String from Number. Returns values from "01" to "53".
10. Corrected bug where .getISOWeek() was not returning a string with a leading zero if the week was < 10.
Example
// Old
Date.today().getISOWeek(); // "7"
// New
Date.today().getISOWeek(); // "07"
11. Added support for escaping ("\\") characters in a format specifier string.
Example
new Date().toString("\\da\\te: MMMM dS, yyyy"); // "date: April 12th, 2008"
12. Removed .toShortDateString() from sugarpak.js. Please use .toString("d").
13. Removed .toLongDateString() from sugarpak.js. Please use .toString("D").
14. Removed .toShortTimeString() from sugarpak.js. Please use .toString("t").
15. Removed .toLongTimeString() from sugarpak.js. Please use .toString("T").
16. Added support in .toString() for the following Standard Date and Time Format Specifiers.
The format pattern for each standard pattern is pulled from the CultureInfo file.
The pattern is culture specific and *may* be different for each CultureInfo class.
STANDARD DATE AND TIME FORMAT STRINGS
Format Description Example ("en-US")
------ --------------------------------------------------------------------------- -----------------------
d The CultureInfo shortDate Format Pattern "M/d/yyyy"
D The CultureInfo longDate Format Pattern "dddd, MMMM dd, yyyy"
F The CultureInfo fullDateTime Format Pattern "dddd, MMMM dd, yyyy h:mm:ss tt"
m The CultureInfo monthDay Format Pattern "MMMM dd"
r The CultureInfo rfc1123 Format Pattern "ddd, dd MMM yyyy HH:mm:ss GMT"
s The CultureInfo sortableDateTime Format Pattern "yyyy-MM-ddTHH:mm:ss"
t The CultureInfo shortTime Format Pattern "h:mm tt"
T The CultureInfo longTime Format Pattern "h:mm:ss tt"
u The CultureInfo universalSortableDateTime Format Pattern "yyyy-MM-dd HH:mm:ssZ"
y The CultureInfo yearMonth Format Pattern "MMMM, yyyy"
17. Fixed bug in .getUTCOffset().
18. Updated APIDocuemtation to ensure all core.js functions were documented.
19. Added parameter information to APIDocumentation (http://code.google.com/p/datejs/wiki/APIDocumentation).
20. Added Date.prototype.format(format). The .format function is similar to the .toString() function,
but will accept a PHP/Unix style format string. See the following PHP documentation for reference.
http://www.php.net/strftime
http://www.php.net/manual/en/function.date.php
Example
Date.today().format("%m/%d/%y"); // "04/13/08"
Date.today().format("c"); // "2008-04-13T06:00:00Z"
If .format is already in the dom when the Datejs libary loads, the .format function will not be created.
A secondary .$format function is always created and available.
21. Added .normalizeFormat() to extras.js. The .normalizeFormat function will converts a PHP format
string to Java/.NET format string.
A PHP format string can be used with .$format or .format.
A Java/.NET format string can be used with .toString().
The .parseExact function will only accept a Java/.NET format string
Example
Date.normalizeFormat("%m/%d/%y"); // "MM/dd/yy"
var f1 = "%m/%d/%y"
var f2 = Date.normalizeFormat(f1); // "MM/dd/yy"
new Date().format(f1); // "04/13/08"
new Date().$format(f1); // "04/13/08"
new Date().toString(f2); // "04/13/08"
var date = Date.parseExact("04/13/08", f2); // Sun Apr 13 2008
22. Added .strftime() to extras.js. The .strftime() function will format a local Unix timestamp according
to locale settings.
Example
Date.strftime("%m/%d/%y", new Date()); // "04/13/08"
Date.strftime("c", "2008-04-13T17:52:03Z"); // "04/13/08"
23. Added .strtotime() to extras.js. The .strotime() function will parse any textual datetime description
into a Unix timestamp.
A Unix timestamp is the number of seconds that have elapsed since January 1, 1970 (midnight UTC/GMT).
Example
Date.strtotime("04/13/08"); // 1208044800
Date.strtotime("1970-01-01T00:00:00Z"); // 0
--------------------- Loading branch information