Date Class
Date provides a set of utility functions to operate against Date objects.
Item Index
Methods
addDays
-
oDate
-
numMonths
Adds a specified number of days to the given date.
Parameters:
Returns:
addMonths
-
oDate
-
numMonths
Adds a specified number of months to the given date.
Parameters:
Returns:
addYears
-
oDate
-
numYears
Adds a specified number of years to the given date.
Parameters:
Returns:
areEqual
-
aDate
-
bDate
Checks whether two dates correspond to the same date and time.
Returns:
daysInMonth
-
oDate
Takes a native JavaScript Date and returns the number of days in the month that the given date belongs to.
Parameters:
-
oDate
DateDate in the month for which the number of days is desired.
Returns:
format
-
oDate
-
oConfig
Takes a native JavaScript Date and formats it as a string for display to user.
Parameters:
-
oDate
DateDate.
-
oConfig
Object(Optional) Object literal of configuration values:
- format {HTML} (Optional)
-
Any strftime string is supported, such as "%I:%M:%S %p". strftime has several format specifiers defined by the Open group at http://www.opengroup.org/onlinepubs/007908799/xsh/strftime.html PHP added a few of its own, defined at http://www.php.net/strftime
This javascript implementation supports all the PHP specifiers and a few more. The full list is below.
If not specified, it defaults to the ISO 8601 standard date format: %Y-%m-%d.
- %a
- abbreviated weekday name according to the current locale
- %A
- full weekday name according to the current locale
- %b
- abbreviated month name according to the current locale
- %B
- full month name according to the current locale
- %c
- preferred date and time representation for the current locale
- %C
- century number (the year divided by 100 and truncated to an integer, range 00 to 99)
- %d
- day of the month as a decimal number (range 01 to 31)
- %D
- same as %m/%d/%y
- %e
- day of the month as a decimal number, a single digit is preceded by a space (range " 1" to "31")
- %F
- same as %Y-%m-%d (ISO 8601 date format)
- %g
- like %G, but without the century
- %G
- The 4-digit year corresponding to the ISO week number
- %h
- same as %b
- %H
- hour as a decimal number using a 24-hour clock (range 00 to 23)
- %I
- hour as a decimal number using a 12-hour clock (range 01 to 12)
- %j
- day of the year as a decimal number (range 001 to 366)
- %k
- hour as a decimal number using a 24-hour clock (range 0 to 23); single digits are preceded by a blank. (See also %H.)
- %l
- hour as a decimal number using a 12-hour clock (range 1 to 12); single digits are preceded by a blank. (See also %I.)
- %m
- month as a decimal number (range 01 to 12)
- %M
- minute as a decimal number
- %n
- newline character
- %p
- either "AM" or "PM" according to the given time value, or the corresponding strings for the current locale
- %P
- like %p, but lower case
- %r
- time in a.m. and p.m. notation equal to %I:%M:%S %p
- %R
- time in 24 hour notation equal to %H:%M
- %s
- number of seconds since the Epoch, ie, since 1970-01-01 00:00:00 UTC
- %S
- second as a decimal number
- %t
- tab character
- %T
- current time, equal to %H:%M:%S
- %u
- weekday as a decimal number [1,7], with 1 representing Monday
- %U
- week number of the current year as a decimal number, starting with the first Sunday as the first day of the first week
- %V
- The ISO 8601:1988 week number of the current year as a decimal number, range 01 to 53, where week 1 is the first week that has at least 4 days in the current year, and with Monday as the first day of the week.
- %w
- day of the week as a decimal, Sunday being 0
- %W
- week number of the current year as a decimal number, starting with the first Monday as the first day of the first week
- %x
- preferred date representation for the current locale without the time
- %X
- preferred time representation for the current locale without the date
- %y
- year as a decimal number without a century (range 00 to 99)
- %Y
- year as a decimal number including the century
- %z
- numerical time zone representation
- %Z
- time zone name or abbreviation
- %%
- a literal "%" character
Returns:
isGreater
-
aDate
-
bDate
Checks whether the first date comes later than the second.
Returns:
isGreaterOrEqual
-
aDate
-
bDate
Checks whether the first date comes later than or is the same as the second.
Returns:
isInRange
-
aDate
-
bDate
-
cDate
Checks whether the date is between two other given dates.
Parameters:
Returns:
isValidDate
-
oDate
Checks whether a native JavaScript Date contains a valid value.
Parameters:
-
oDate
DateDate in the month for which the number of days is desired.
Returns:
listOfDatesInMonth
-
oDate
Lists all dates in a given month.
Parameters:
-
oDate
DateThe date corresponding to the month for which a list of dates is required.