Return date of first day of month of given date.
string
beginOfMonth
([string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Returns date of begin of next month of given date.
string
beginOfNextMonth
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Find the month day of the beginning of week after given date, using DATE_CALC_BEGIN_WEEKDAY. (can return weekday of prev month.)
string
beginOfNextWeek
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Returns date of the first day of previous month of given date.
string
beginOfPrevMonth
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Find the month day of the beginning of week before given date, using DATE_CALC_BEGIN_WEEKDAY. (can return weekday of prev month.)
string
beginOfPrevWeek
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Find the month day of the beginning of week for given date, using DATE_CALC_BEGIN_WEEKDAY. (can return weekday of prev month.)
string
beginOfWeek
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Compares two dates
int
compareDates
(string $day1, string $month1, string $year1, string $day2, string $month2, string $year2)
-
string
$day1: day in format DD
-
string
$month1: month in format MM
-
string
$year1: year in format CCYY
-
string
$day2: day in format DD
-
string
$month2: month in format MM
-
string
$year2: year in format CCYY
Returns number of days between two given dates.
int
dateDiff
(string $day1, string $month1, string $year1, string $day2, string $month2, string $year2)
-
string
$day1: day in format DD
-
string
$month1: month in format MM
-
string
$year1: year in format CCYY
-
string
$day2: day in format DD
-
string
$month2: month in format MM
-
string
$year2: year in format CCYY
Formats the date in the given format, much like strfmt(). This function is used to alleviate the problem with 32-bit numbers for dates pre 1970 or post 2038, as strfmt() has on most systems.
Most of the formatting options are compatible.
formatting options:
%a abbreviated weekday name (Sun, Mon, Tue) %A full weekday name (Sunday, Monday, Tuesday) %b abbreviated month name (Jan, Feb, Mar) %B full month name (January, February, March) %d day of month (range 00 to 31) %e day of month, single digit (range 0 to 31) %E number of days since unspecified epoch (integer) (%E is useful for passing a date in a URL as an integer value. Then simply use daysToDate() to convert back to a date.) %j day of year (range 001 to 366) %m month as decimal number (range 1 to 12) %n newline character (\n) %t tab character (\t) %w weekday as decimal (0 = Sunday) %U week number of current year, first sunday as first week %y year as decimal (range 00 to 99) %Y year as decimal including century (range 0000 to 9999) %% literal '%'
string
dateFormat
(string $day, string $month, string $year, string $format)
-
string
$day: day in format DD
-
string
$month: month in format MM
-
string
$year: year in format CCYY
-
string
$format: format for returned date
Returns the current local date. NOTE: This function retrieves the local date using strftime(), which may or may not be 32-bit safe on your system.
string
dateNow
([string $format = '%Y%m%d'])
-
string
$format: the strftime() format to return the date
Determines julian date of the given season Adapted from previous work in Java by James Mark Hamilton, mhamilton@qwest.net
float
dateSeason
(string $season, [string $year = ''])
-
string
$season: is VERNALEQUINOX, SUMMERSOLSTICE, AUTUMNALEQUINOX, or WINTERSOLSTICE.
-
string
$year: year in format CCYY, must be a calendar year between -1000BC and 3000AD.
Converts a date to number of days since a distant unspecified epoch.
integer
dateToDays
(string $day, string $month, string $year)
-
string
$day: day in format DD
-
string
$month: month in format MM
-
string
$year: year in format CCYY
Returns day of week for given date, 0=Sunday
int
dayOfWeek
([string $day = ''], [string $month = ''], [string $year = ''])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
Find the number of days in the given month.
int
daysInMonth
([string $month = ''], [string $year = ''])
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
Converts number of days to a distant unspecified epoch.
string
daysToDate
(int $days, [string $format = '%Y%m%d'])
-
int
$days: number of days
-
string
$format: format for returned date
Sets century for 2 digit year.
51-99 is 19, else 20
string
defaultCentury
(string $year)
-
string
$year: 2 digit year
Returns date of the last day of next month of given date.
string
endOfNextMonth
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Returns date of the last day of previous month for given date.
string
endOfPrevMonth
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Find the month day of the end of week for given date, using DATE_CALC_BEGIN_WEEKDAY. (can return weekday of following month.)
string
endOfWeek
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Find the day of the week for the first of the month of given date.
int
firstOfMonthWeekday
([string $month = ''], [string $year = ''])
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
Return a set of arrays to construct a calendar month for the given date.
array
getCalendarMonth
([string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Return an array with days in week
array
getCalendarWeek
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Return a set of arrays to construct a calendar year for the given date.
array
getCalendarYear
([string $year = ''], [string $format = '%Y%m%d'])
-
string
$year: year in format CCYY, default current local year
-
string
$format: format for returned date
Returns the current local day in format DD
string
getDay
()
Returns the current local month in format MM
string
getMonth
()
Returns the abbreviated month name for the given month
string
getMonthAbbrname
(string $month, [int $length = 3])
-
string
$month: month in format MM
-
int
$length: optional length of abbreviation, default is 3
Returns the numeric month from the month name or an abreviation
Both August and Aug would return 8. Month name is case insensitive.
integer
getMonthFromFullName
(string $month)
-
string
$month: month name
Returns the full month name for the given month
string
getMonthFullname
(string $month)
-
string
$month: month in format MM
Returns an array of month names
Used to take advantage of the setlocale function to return language specific month names. XXX cache values to some global array to avoid preformace hits when called more than once.
array
getMonthNames
()
Returns the abbreviated weekday name for the given date
string
getWeekdayAbbrname
([string $day = ''], [string $month = ''], [string $year = ''], [int $length = 3])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
int
$length: optional length of abbreviation, default is 3
Returns the full weekday name for the given date
string
getWeekdayFullname
([string $day = ''], [string $month = ''], [string $year = ''])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
Returns an array of week days
Used to take advantage of the setlocale function to return language specific week days XXX cache values to some global array to avoid preformace hits when called more than once.
array
getWeekDays
()
Returns the current local year in format CCYY
string
getYear
()
Converts from Gregorian Year-Month-Day to ISO YearNumber-WeekNumber-WeekDay
Uses ISO 8601 definitions. Algorithm from Rick McCarty, 1999 at http://personal.ecu.edu/mccartyr/ISOwdALG.txt
string
gregorianToISO
(string $day, string $month, string $year)
-
string
$day: day in format DD
-
string
$month: month in format MM
-
string
$year: year in format CCYY
Determines if given date is a future date from now.
boolean
isFutureDate
(string $day, string $month, string $year)
-
string
$day: day in format DD
-
string
$month: month in format MM
-
string
$year: year in format CCYY
Returns true for a leap year, else false
boolean
isLeapYear
([string $year = ''])
-
string
$year: year in format CCYY
Determines if given date is a past date from now.
boolean
isPastDate
(string $day, string $month, string $year)
-
string
$day: day in format DD
-
string
$month: month in format MM
-
string
$year: year in format CCYY
Returns true for valid date, false for invalid date.
boolean
isValidDate
(string $day, string $month, string $year)
-
string
$day: year in format CCYY
-
string
$month: month in format MM
-
string
$year: day in format DD
Returns number of days since 31 December of year before given date.
int
julianDate
([string $day = ''], [string $month = ''], [string $year = ''])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
Returns date of day after given date.
string
nextDay
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Returns date of the next specific day of the week from the given date.
string
nextDayOfWeek
(int $dow, [string $day = ''], [string $month = ''], [string $year = ''], [boolean $format = '%Y%m%d'], [string $onOrAfter = false])
-
int
$dow: day of week, 0=Sunday
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
boolean
$format: onOrAfter if true and days are same, returns current day
-
string
$onOrAfter: format for returned date
Returns date of the next specific day of the week on or after the given date.
string
nextDayOfWeekOnOrAfter
(int $dow, [string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
int
$dow: day of week, 0=Sunday
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Returns date of the next weekday of given date, skipping from Friday to Monday.
string
nextWeekday
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Calculates the date of the Nth weekday of the month, such as the second Saturday of January 2000.
string
NWeekdayOfMonth
(string $occurance, string $dayOfWeek, string $month, string $year, [string $format = '%Y%m%d'])
-
string
$occurance: occurance: 1=first, 2=second, 3=third, etc.
-
string
$dayOfWeek: dayOfWeek: 0=Sunday, 1=Monday, etc.
-
string
$month: month in format MM
-
string
$year: year in format CCYY
-
string
$format: format for returned date
Returns date of day before given date.
string
prevDay
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Returns date of the previous specific day of the week from the given date.
string
prevDayOfWeek
(int $dow, [string $day = ''], [string $month = ''], [string $year = ''], [boolean $format = '%Y%m%d'], [string $onOrBefore = false])
-
int
$dow: day of week, 0=Sunday
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
boolean
$format: onOrBefore if true and days are same, returns current day
-
string
$onOrBefore: format for returned date
Returns date of the previous specific day of the week on or before the given date.
string
prevDayOfWeekOnOrBefore
(int $dow, [string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
int
$dow: day of week, 0=Sunday
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Returns date of the previous weekday, skipping from Monday to Friday.
string
prevWeekday
([string $day = ''], [string $month = ''], [string $year = ''], [string $format = '%Y%m%d'])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
-
string
$format: format for returned date
Returns quarter of the year for given date
int
quarterOfYear
([string $day = ''], [string $month = ''], [string $year = ''])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
Returns week of the year, first Sunday is first day of first week
integer
weekOfYear
([string $day = ''], [string $month = ''], [string $year = ''])
-
string
$day: day in format DD, default is current local day
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year
Returns the number of rows on a calendar month. Useful for determining the number of rows when displaying a typical month calendar.
int
weeksInMonth
([string $month = ''], [string $year = ''])
-
string
$month: month in format MM, default is current local month
-
string
$year: year in format CCYY, default is current local year