Dojo: The Definitive Guide

Dates, Numbers, and Currency

Additional Core facilities provide additional support for manipulating and supporting internationalization of dates, numbers, and currency via the dojo.date, dojo.number, and dojo.currency modules, respectively. In Part II, you'll learn that Dijit makes extensive use of these modules to provide advanced support for commonly used widgets. This section provides a quick inventory of these features.

Dates

Table 6-2 shows a quick overview of the dojo.date module. As you'll see, there are some real gems in here if you ever need to perform any routine processing of the built-in Date object.

Table 6-2. Summary of the date module

Name	Return type	Comment
dojo.date.getDaysInMonth (/*Date*/date)	Integer	Returns the number of days in date's month.
dojo.date.isLeapYear (/*Date*/date)	Boolean	Returns true if date is a leap year.
dojo.date.getTimezoneName (/*Date*/date)	String	Returns time zone information as defined by the browser. A Date object is needed because the time zone may vary according to issues such as daylight savings time.
dojo.date.compare(/*Date*/ date1, /*Date*/ date2, /*String?*/ portion)	Integer	Returns 0 if the two parameters are equal; returns a positive number if date1 > date 2 ; returns a negative number if date1 < date2. By default, both date and time are compared, although providing "date" or "time" for a portion produces a comparison strictly by date or time, respectively.
dojo.date.add(/*Date*/date, /*String*/ interval, /*Integer*/ amount)	Date	Provides a convenient ...