Public Member Functions | |
__construct ($date=null, $part=null, $locale=null) | |
getTimestamp () | |
setTimestamp ($timestamp) | |
addTimestamp ($timestamp) | |
subTimestamp ($timestamp) | |
compareTimestamp ($timestamp) | |
toString ($format=null, $type=null, $locale=null) | |
__toString () | |
toValue ($part=null) | |
toArray () | |
get ($part=null, $locale=null) | |
set ($date, $part=null, $locale=null) | |
add ($date, $part=null, $locale=null) | |
sub ($date, $part=null, $locale=null) | |
compare ($date, $part=null, $locale=null) | |
copyPart ($part, $locale=null) | |
getTimezoneFromString ($zone) | |
equals ($date, $part=null, $locale=null) | |
isEarlier ($date, $part=null, $locale=null) | |
isLater ($date, $part=null, $locale=null) | |
getTime ($locale=null) | |
setTime ($time, $format=null, $locale=null) | |
addTime ($time, $format=null, $locale=null) | |
subTime ($time, $format=null, $locale=null) | |
compareTime ($time, $format=null, $locale=null) | |
getDate ($locale=null) | |
setDate ($date, $format=null, $locale=null) | |
addDate ($date, $format=null, $locale=null) | |
subDate ($date, $format=null, $locale=null) | |
compareDate ($date, $format=null, $locale=null) | |
getIso ($locale=null) | |
setIso ($date, $locale=null) | |
addIso ($date, $locale=null) | |
subIso ($date, $locale=null) | |
compareIso ($date, $locale=null) | |
getArpa ($locale=null) | |
setArpa ($date, $locale=null) | |
addArpa ($date, $locale=null) | |
subArpa ($date, $locale=null) | |
compareArpa ($date, $locale=null) | |
getSunrise ($location) | |
getSunset ($location) | |
getSunInfo ($location) | |
isLeapYear () | |
isToday () | |
isYesterday () | |
isTomorrow () | |
getYear ($locale=null) | |
setYear ($year, $locale=null) | |
addYear ($year, $locale=null) | |
subYear ($year, $locale=null) | |
compareYear ($year, $locale=null) | |
getMonth ($locale=null) | |
setMonth ($month, $locale=null) | |
addMonth ($month, $locale=null) | |
subMonth ($month, $locale=null) | |
compareMonth ($month, $locale=null) | |
getDay ($locale=null) | |
setDay ($day, $locale=null) | |
addDay ($day, $locale=null) | |
subDay ($day, $locale=null) | |
compareDay ($day, $locale=null) | |
getWeekday ($locale=null) | |
setWeekday ($weekday, $locale=null) | |
addWeekday ($weekday, $locale=null) | |
subWeekday ($weekday, $locale=null) | |
compareWeekday ($weekday, $locale=null) | |
getDayOfYear ($locale=null) | |
setDayOfYear ($day, $locale=null) | |
addDayOfYear ($day, $locale=null) | |
subDayOfYear ($day, $locale=null) | |
compareDayOfYear ($day, $locale=null) | |
getHour ($locale=null) | |
setHour ($hour, $locale=null) | |
addHour ($hour, $locale=null) | |
subHour ($hour, $locale=null) | |
compareHour ($hour, $locale=null) | |
getMinute ($locale=null) | |
setMinute ($minute, $locale=null) | |
addMinute ($minute, $locale=null) | |
subMinute ($minute, $locale=null) | |
compareMinute ($minute, $locale=null) | |
getSecond ($locale=null) | |
setSecond ($second, $locale=null) | |
addSecond ($second, $locale=null) | |
subSecond ($second, $locale=null) | |
compareSecond ($second, $locale=null) | |
getFractionalPrecision () | |
setFractionalPrecision ($precision) | |
getMilliSecond () | |
setMilliSecond ($milli=null, $precision=null) | |
addMilliSecond ($milli=null, $precision=null) | |
subMilliSecond ($milli=null, $precision=null) | |
compareMilliSecond ($milli=null, $precision=null) | |
getWeek ($locale=null) | |
setWeek ($week, $locale=null) | |
addWeek ($week, $locale=null) | |
subWeek ($week, $locale=null) | |
compareWeek ($week, $locale=null) | |
setLocale ($locale=null) | |
getLocale () | |
Static Public Member Functions | |
static | setOptions (array $options=array()) |
static | getFullYear ($value) |
static | checkLeapYear ($year) |
static | now ($locale=null) |
static | isDate ($date, $format=null, $locale=null) |
Data Fields | |
const | DAY = 'dd' |
const | DAY_SHORT = 'd' |
const | DAY_SUFFIX = 'SS' |
const | DAY_OF_YEAR = 'D' |
const | WEEKDAY = 'EEEE' |
const | WEEKDAY_SHORT = 'EEE' |
const | WEEKDAY_NARROW = 'E' |
const | WEEKDAY_NAME = 'EE' |
const | WEEKDAY_8601 = 'eee' |
const | WEEKDAY_DIGIT = 'e' |
const | WEEK = 'ww' |
const | MONTH = 'MM' |
const | MONTH_SHORT = 'M' |
const | MONTH_DAYS = 'ddd' |
const | MONTH_NAME = 'MMMM' |
const | MONTH_NAME_SHORT = 'MMM' |
const | MONTH_NAME_NARROW = 'MMMMM' |
const | YEAR = 'y' |
const | YEAR_SHORT = 'yy' |
const | YEAR_8601 = 'Y' |
const | YEAR_SHORT_8601 = 'YY' |
const | LEAPYEAR = 'l' |
const | MERIDIEM = 'a' |
const | SWATCH = 'B' |
const | HOUR = 'HH' |
const | HOUR_SHORT = 'H' |
const | HOUR_AM = 'hh' |
const | HOUR_SHORT_AM = 'h' |
const | MINUTE = 'mm' |
const | MINUTE_SHORT = 'm' |
const | SECOND = 'ss' |
const | SECOND_SHORT = 's' |
const | MILLISECOND = 'S' |
const | TIMEZONE_NAME = 'zzzz' |
const | DAYLIGHT = 'I' |
const | GMT_DIFF = 'Z' |
const | GMT_DIFF_SEP = 'ZZZZ' |
const | TIMEZONE = 'z' |
const | TIMEZONE_SECS = 'X' |
const | ISO_8601 = 'c' |
const | RFC_2822 = 'r' |
const | TIMESTAMP = 'U' |
const | ERA = 'G' |
const | ERA_NAME = 'GGGG' |
const | ERA_NARROW = 'GGGGG' |
const | DATES = 'F' |
const | DATE_FULL = 'FFFFF' |
const | DATE_LONG = 'FFFF' |
const | DATE_MEDIUM = 'FFF' |
const | DATE_SHORT = 'FF' |
const | TIMES = 'WW' |
const | TIME_FULL = 'TTTTT' |
const | TIME_LONG = 'TTTT' |
const | TIME_MEDIUM = 'TTT' |
const | TIME_SHORT = 'TT' |
const | DATETIME = 'K' |
const | DATETIME_FULL = 'KKKKK' |
const | DATETIME_LONG = 'KKKK' |
const | DATETIME_MEDIUM = 'KKK' |
const | DATETIME_SHORT = 'KK' |
const | ATOM = 'OOO' |
const | COOKIE = 'CCC' |
const | RFC_822 = 'R' |
const | RFC_850 = 'RR' |
const | RFC_1036 = 'RRR' |
const | RFC_1123 = 'RRRR' |
const | RFC_3339 = 'RRRRR' |
const | RSS = 'SSS' |
const | W3C = 'WWW' |
Static Protected Member Functions | |
static | _getLocalizedToken ($token, $locale) |
Definition at line 36 of file Date.php.
__construct | ( | $ | date = null , |
$ | part = null , |
||
$ | locale = null |
||
) |
Generates the standard date object, could be a unix timestamp, localized date, string, integer, array and so on. Also parts of dates or time are supported Always set the default timezone: http://php.net/date_default_timezone_set For example, in your bootstrap: date_default_timezone_set('America/Los_Angeles'); For detailed instructions please look in the docu.
string | integer | Zend_Date | array | $date | OPTIONAL Date value or value of date part to set ,depending on $part. If null the actual time is set |
string | $part | OPTIONAL Defines the input format of $date |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
__toString | ( | ) |
static _getLocalizedToken | ( | $ | token, |
$ | locale | ||
) | [static, protected] |
add | ( | $ | date, |
$ | part = null , |
||
$ | locale = null |
||
) |
Adds a date or datepart to the existing date, by extracting $part from $date, and modifying this object by adding that part. The $part is then extracted from this object and returned as an integer or numeric string (for large values, or $part's corresponding to pre-defined formatted date strings). This could be for example a ISO 8601 date, the hour the monthname or only the minute. There are about 50 different supported date parts. For a complete list of supported datepart values look into the docu.
string | integer | array | Zend_Date | $date | Date or datepart to add |
string | $part | OPTIONAL Part of the date to add, if null the timestamp is added |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
addArpa | ( | $ | date, |
$ | locale = null |
||
) |
Adds a RFC 822 date to the date object. ARPA messages are used in emails or HTTP Headers. Only RFC 822 compilant date strings are accepted. For example: Sat, 14 Feb 09 00:31:30 +0100 Returned is the new date object
string | integer | Zend_Date | $date | RFC 822 Date to add |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
addDate | ( | $ | date, |
$ | format = null , |
||
$ | locale = null |
||
) |
Adds a date to the existing date object. Format defines how to parse the date string. If only parts are given the other parts are set to 0. If no format is given, the standardformat of this locale is used. For example: MM.dd.YYYY -> 10 -> +10 months
string | integer | array | Zend_Date | $date | Date to add |
string | $format | OPTIONAL Date format for parsing input |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
addDay | ( | $ | day, |
$ | locale = null |
||
) |
Adds days to the existing date object. The day can be a number or a string. Adding days lower then 0 or greater than the number of this months days will result in adding or subtracting the relevant month. If a localized dayname is given it will be parsed with the default locale or the optional set locale. Returned is the new date object Example: addDay('Montag', 'de_AT'); will add the number of days until the next monday
string | integer | array | Zend_Date | $month | Day to add |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
addDayOfYear | ( | $ | day, |
$ | locale = null |
||
) |
Adds a day of year to the existing date object. The day of year is always a number. Returned is the new date object Example: addDayOfYear(10); will add 10 days to the existing date object.
string | integer | array | Zend_Date | $day | Day of Year to add |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
addHour | ( | $ | hour, |
$ | locale = null |
||
) |
Adds hours to the existing date object. The hour is always a number. Returned is the new date object Example: 04.May.1993 13:07:25 -> addHour(12); -> 05.May.1993 01:07:25
string | integer | array | Zend_Date | $hour | Hour to add |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
addIso | ( | $ | date, |
$ | locale = null |
||
) |
Adds a ISO date to the date object. Not given parts are set to default. Only supported ISO 8601 formats are accepted. For example: 050901 -> + 01.Sept.2005 00:00:00, 10:00:00 -> +10h Returned is the new date object
string | integer | Zend_Date | $date | ISO Date to add |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
addMilliSecond | ( | $ | milli = null , |
$ | precision = null |
||
) |
addMinute | ( | $ | minute, |
$ | locale = null |
||
) |
Adds minutes to the existing date object. The minute is always a number. Returned is the new date object Example: 04.May.1993 13:07:25 -> addMinute(65); -> 04.May.1993 13:12:25
string | integer | array | Zend_Date | $minute | Minute to add |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
addMonth | ( | $ | month, |
$ | locale = null |
||
) |
Adds months to the existing date object. The month can be a number or a string. Adding months lower then 0 and greater then 12 will result in adding or subtracting the relevant year. (12 months equal one year) If a localized monthname is given it will be parsed with the default locale or the optional set locale. Returned is the new date object
string | integer | array | Zend_Date | $month | Month to add |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
addSecond | ( | $ | second, |
$ | locale = null |
||
) |
Adds seconds to the existing date object. The second is always a number. Returned is the new date object Example: 04.May.1993 13:07:25 -> addSecond(65); -> 04.May.1993 13:08:30
string | integer | array | Zend_Date | $second | Second to add |
string | Zend_Locale | $locale | (Optional) Locale for parsing input |
Zend_Date_Exception |
addTime | ( | $ | time, |
$ | format = null , |
||
$ | locale = null |
||
) |
Adds a time to the existing date. Format defines how to parse the time string. If only parts are given the other parts are set to 0. If no format is given, the standardformat of this locale is used. For example: HH:mm:ss -> 10 -> +10 hours
string | integer | array | Zend_Date | $time | Time to add |
string | $format | OPTIONAL Timeformat for parsing input |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
addTimestamp | ( | $ | timestamp ) |
addWeek | ( | $ | week, |
$ | locale = null |
||
) |
Adds a week. The week is always a number. The day of week is not changed. Returned is the new date object Example: 09.Jan.2007 13:07:25 -> addWeek(1); -> 16.Jan.2007 13:07:25
string | integer | array | Zend_Date | $week | Week to add |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
addWeekday | ( | $ | weekday, |
$ | locale = null |
||
) |
Adds weekdays to the existing date object. The weekday can be a number or a string. If a localized dayname is given it will be parsed with the default locale or the optional set locale. Returned is the new date object Example: addWeekday(3); will add the difference of days from the begining of the month until wednesday.
string | integer | array | Zend_Date | $month | Weekday to add |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
addYear | ( | $ | year, |
$ | locale = null |
||
) |
Adds the year to the existing date object If the year is between 0 and 69, 2000 will be added (2000-2069) If the year if between 70 and 99, 1999 will be added (1970-1999) 3 or 4 digit years are added as expected. If you need to add years from 0-99 use add() instead. Returned is the new date object
string | integer | array | Zend_Date | $date | Year to add |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
static checkLeapYear | ( | $ | year ) | [static] |
compare | ( | $ | date, |
$ | part = null , |
||
$ | locale = null |
||
) |
Compares a date or datepart with the existing one. Returns -1 if earlier, 0 if equal and 1 if later.
string | integer | array | Zend_Date | $date | Date or datepart to compare with the date object |
string | $part | OPTIONAL Part of the date to compare, if null the timestamp is subtracted |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
compareArpa | ( | $ | date, |
$ | locale = null |
||
) |
Compares a RFC 822 compilant date with the date object. ARPA messages are used in emails or HTTP Headers. Only RFC 822 compilant date strings are accepted. For example: Sat, 14 Feb 09 00:31:30 +0100 Returns if equal, earlier or later
string | integer | Zend_Date | $date | RFC 822 Date to sub |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
compareDate | ( | $ | date, |
$ | format = null , |
||
$ | locale = null |
||
) |
Compares the date from the existing date object, ignoring the time. Format defines how to parse the date string. If only parts are given the other parts are set to 0. If no format is given, the standardformat of this locale is used. For example: 10.01.2000 => 10.02.1999 -> false
string | integer | array | Zend_Date | $date | Date to compare |
string | $format | OPTIONAL Date format for parsing input |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
compareDay | ( | $ | day, |
$ | locale = null |
||
) |
Compares the day with the existing date object, ignoring other date parts. For example: 'Monday', 'en' -> 08.Jan.2007 -> 0 Returns if equal, earlier or later
string | integer | array | Zend_Date | $day | Day to compare |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
compareDayOfYear | ( | $ | day, |
$ | locale = null |
||
) |
Compares the day of year with the existing date object. For example: compareDayOfYear(33) -> 02.Feb.2007 -> 0 Returns if equal, earlier or later
string | integer | array | Zend_Date | $day | Day of Year to compare |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
compareHour | ( | $ | hour, |
$ | locale = null |
||
) |
Compares the hour with the existing date object. For example: 10:30:25 -> compareHour(10) -> 0 Returns if equal, earlier or later
string | integer | array | Zend_Date | $hour | Hour to compare |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
compareIso | ( | $ | date, |
$ | locale = null |
||
) |
Compares a ISO date with the date object. Not given parts are set to default. Only supported ISO 8601 formats are accepted. For example: 050901 -> - 01.Sept.2005 00:00:00, 10:00:00 -> -10h Returns if equal, earlier or later
string | integer | Zend_Date | $date | ISO Date to sub |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
compareMilliSecond | ( | $ | milli = null , |
$ | precision = null |
||
) |
Compares only the millisecond part, returning the difference
integer | Zend_Date | $milli | OPTIONAL Millisecond to compare, when null the actual millisecond is compared |
integer | $precision | OPTIONAL Fractional precision for the given milliseconds |
compareMinute | ( | $ | minute, |
$ | locale = null |
||
) |
Compares the minute with the existing date object. For example: 10:30:25 -> compareMinute(30) -> 0 Returns if equal, earlier or later
string | integer | array | Zend_Date | $minute | Hour to compare |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
compareMonth | ( | $ | month, |
$ | locale = null |
||
) |
Compares the month with the existing date object, ignoring other date parts. For example: 10.03.2000 -> 15.03.1950 -> true Returns if equal, earlier or later
string | integer | array | Zend_Date | $month | Month to compare |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
compareSecond | ( | $ | second, |
$ | locale = null |
||
) |
Compares the second with the existing date object. For example: 10:30:25 -> compareSecond(25) -> 0 Returns if equal, earlier or later
string | integer | array | Zend_Date | $second | Second to compare |
string | Zend_Locale | $locale | (Optional) Locale for parsing input |
Zend_Date_Exception |
compareTime | ( | $ | time, |
$ | format = null , |
||
$ | locale = null |
||
) |
Compares the time from the existing date. Format defines how to parse the time string. If only parts are given the other parts are set to default. If no format us given, the standardformat of this locale is used. For example: HH:mm:ss -> 10 -> 10 hours
string | integer | array | Zend_Date | $time | Time to compare |
string | $format | OPTIONAL Timeformat for parsing input |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
compareTimestamp | ( | $ | timestamp ) |
compareWeek | ( | $ | week, |
$ | locale = null |
||
) |
Compares only the week part, returning the difference Returned is the new date object Returns if equal, earlier or later Example: 09.Jan.2007 13:07:25 -> compareWeek(2); -> 0
string | integer | array | Zend_Date | $week | Week to compare |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
compareWeekday | ( | $ | weekday, |
$ | locale = null |
||
) |
Compares the weekday with the existing date object, ignoring other date parts. For example: 'Monday', 'en' -> 08.Jan.2007 -> 0 Returns if equal, earlier or later
string | integer | array | Zend_Date | $weekday | Weekday to compare |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
compareYear | ( | $ | year, |
$ | locale = null |
||
) |
Compares the year with the existing date object, ignoring other date parts. For example: 10.03.2000 -> 15.02.2000 -> true Returns if equal, earlier or later
string | integer | array | Zend_Date | $year | Year to compare |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
copyPart | ( | $ | part, |
$ | locale = null |
||
) |
Returns a new instance of Zend_Date with the selected part copied. To make an exact copy, use PHP's clone keyword. For a complete list of supported date part values look into the docu. If a date part is copied, all other date parts are set to standard values. For example: If only YEAR is copied, the returned date object is equal to 01-01-YEAR 00:00:00 (01-01-1970 00:00:00 is equal to timestamp 0) If only HOUR is copied, the returned date object is equal to 01-01-1970 HOUR:00:00 (so $this contains a timestamp equal to a timestamp of 0 plus HOUR).
string | $part | Part of the date to compare, if null the timestamp is subtracted |
string | Zend_Locale | $locale | OPTIONAL New object's locale. No adjustments to timezone are made. |
equals | ( | $ | date, |
$ | part = null , |
||
$ | locale = null |
||
) |
Returns true when both date objects or date parts are equal. For example: 15.May.2000 <-> 15.June.2000 Equals only for Day or Year... all other will return false
string | integer | array | Zend_Date | $date | Date or datepart to equal with |
string | $part | OPTIONAL Part of the date to compare, if null the timestamp is used |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
get | ( | $ | part = null , |
$ | locale = null |
||
) |
Returns a representation of a date or datepart This could be for example a localized monthname, the time without date, the era or only the fractional seconds. There are about 50 different supported date parts. For a complete list of supported datepart values look into the docu
string | $part | OPTIONAL Part of the date to return, if null the timestamp is returned |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
getArpa | ( | $ | locale = null ) |
Returns a RFC 822 compilant datestring from the date object. This function does not return the RFC date as object. Use copy() instead.
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
getDate | ( | $ | locale = null ) |
Returns a clone of $this, with the time part set to 00:00:00.
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
getDay | ( | $ | locale = null ) |
getDayOfYear | ( | $ | locale = null ) |
Returns the day of year as new date object Example: 02.Feb.1986 10:00:00 -> 02.Feb.1970 00:00:00
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
getFractionalPrecision | ( | ) |
static getFullYear | ( | $ | value ) | [static] |
getHour | ( | $ | locale = null ) |
getIso | ( | $ | locale = null ) |
Returns the full ISO 8601 date from the date object. Always the complete ISO 8601 specifiction is used. If an other ISO date is needed (ISO 8601 defines several formats) use toString() instead. This function does not return the ISO date as object. Use copy() instead.
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
getLocale | ( | ) |
getMilliSecond | ( | ) |
getMinute | ( | $ | locale = null ) |
Returns the minute as new date object Example: 02.Feb.1986 10:30:25 -> 01.Jan.1970 00:30:00
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
getMonth | ( | $ | locale = null ) |
Returns only the month from the date object as new object. For example: 10.May.2000 10:30:00 -> 01.May.1970 00:00:00
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
getSecond | ( | $ | locale = null ) |
Returns the second as new date object Example: 02.Feb.1986 10:30:25 -> 01.Jan.1970 00:00:25
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
getSunInfo | ( | $ | location ) |
Returns an array with the sunset and sunrise dates for all horizon types For a list of cities and correct locations use the class Zend_Date_Cities
$location | array - location of suninfo ['horizon'] -> civil, nautic, astronomical, effective (default) ['longitude'] -> longitude of location ['latitude'] -> latitude of location |
Zend_Date_Exception |
getSunrise | ( | $ | location ) |
Returns the time of sunrise for this date and a given location as new date object For a list of cities and correct locations use the class Zend_Date_Cities
$location | array - location of sunrise ['horizon'] -> civil, nautic, astronomical, effective (default) ['longitude'] -> longitude of location ['latitude'] -> latitude of location |
Zend_Date_Exception |
getSunset | ( | $ | location ) |
Returns the time of sunset for this date and a given location as new date object For a list of cities and correct locations use the class Zend_Date_Cities
$location | array - location of sunset ['horizon'] -> civil, nautic, astronomical, effective (default) ['longitude'] -> longitude of location ['latitude'] -> latitude of location |
Zend_Date_Exception |
getTime | ( | $ | locale = null ) |
Returns only the time of the date as new Zend_Date object For example: 15.May.2000 10:11:23 will return a dateobject equal to 01.Jan.1970 10:11:23
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
getTimestamp | ( | ) |
Returns this object's internal UNIX timestamp (equivalent to Zend_Date::TIMESTAMP). If the timestamp is too large for integers, then the return value will be a string. This function does not return the timestamp as an object. Use clone() or copyPart() instead.
getTimezoneFromString | ( | $ | zone ) |
getWeek | ( | $ | locale = null ) |
getWeekday | ( | $ | locale = null ) |
getYear | ( | $ | locale = null ) |
Returns only the year from the date object as new object. For example: 10.May.2000 10:30:00 -> 01.Jan.2000 00:00:00
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
static isDate | ( | $ | date, |
$ | format = null , |
||
$ | locale = null |
||
) | [static] |
Checks if the given date is a real date or datepart. Returns false if a expected datepart is missing or a datepart exceeds its possible border. But the check will only be done for the expected dateparts which are given by format. If no format is given the standard dateformat for the actual locale is used. f.e. 30.February.2007 will return false if format is 'dd.MMMM.YYYY'
string | array | Zend_Date | $date | Date to parse for correctness |
string | $format | (Optional) Format for parsing the date string |
string | Zend_Locale | $locale | (Optional) Locale for parsing date parts |
isEarlier | ( | $ | date, |
$ | part = null , |
||
$ | locale = null |
||
) |
Returns if the given date or datepart is earlier For example: 15.May.2000 <-> 13.June.1999 will return true for day, year and date, but not for month
string | integer | array | Zend_Date | $date | Date or datepart to compare with |
string | $part | OPTIONAL Part of the date to compare, if null the timestamp is used |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
isLater | ( | $ | date, |
$ | part = null , |
||
$ | locale = null |
||
) |
Returns if the given date or datepart is later For example: 15.May.2000 <-> 13.June.1999 will return true for month but false for day, year and date Returns if the given date is later
string | integer | array | Zend_Date | $date | Date or datepart to compare with |
string | $part | OPTIONAL Part of the date to compare, if null the timestamp is used |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
isLeapYear | ( | ) |
isToday | ( | ) |
isTomorrow | ( | ) |
isYesterday | ( | ) |
static now | ( | $ | locale = null ) |
[static] |
Returns the actual date as new date object
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
set | ( | $ | date, |
$ | part = null , |
||
$ | locale = null |
||
) |
Sets the given date as new date or a given datepart as new datepart returning the new datepart This could be for example a localized dayname, the date without time, the month or only the seconds. There are about 50 different supported date parts. For a complete list of supported datepart values look into the docu
string | integer | array | Zend_Date | $date | Date or datepart to set |
string | $part | OPTIONAL Part of the date to set, if null the timestamp is set |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
setArpa | ( | $ | date, |
$ | locale = null |
||
) |
Sets a RFC 822 date as new date for the date object. Only RFC 822 compilant date strings are accepted. For example: Sat, 14 Feb 09 00:31:30 +0100 Returned is the new date object
string | integer | Zend_Date | $date | RFC 822 to set |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
setDate | ( | $ | date, |
$ | format = null , |
||
$ | locale = null |
||
) |
Sets a new date for the date object. Format defines how to parse the date string. Also a complete date with time can be given, but only the date is used for setting. For example: MMMM.yy HH:mm-> May.07 22:11 => 01.May.07 00:00 Returned is the new date object and the existing time is left as it was before
string | integer | array | Zend_Date | $date | Date to set |
string | $format | OPTIONAL Date format for parsing |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
setDay | ( | $ | day, |
$ | locale = null |
||
) |
Sets a new day The day can be a number or a string. Setting days lower then 0 or greater than the number of this months days will result in adding or subtracting the relevant month. If a localized dayname is given it will be parsed with the default locale or the optional set locale. Returned is the new date object Example: setDay('Montag', 'de_AT'); will set the monday of this week as day.
string | integer | array | Zend_Date | $month | Day to set |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
setDayOfYear | ( | $ | day, |
$ | locale = null |
||
) |
Sets a new day of year The day of year is always a number. Returned is the new date object Example: 04.May.2004 -> setDayOfYear(10) -> 10.Jan.2004
string | integer | array | Zend_Date | $day | Day of Year to set |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
setFractionalPrecision | ( | $ | precision ) |
setHour | ( | $ | hour, |
$ | locale = null |
||
) |
Sets a new hour The hour is always a number. Returned is the new date object Example: 04.May.1993 13:07:25 -> setHour(7); -> 04.May.1993 07:07:25
string | integer | array | Zend_Date | $hour | Hour to set |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
setIso | ( | $ | date, |
$ | locale = null |
||
) |
Sets a new date for the date object. Not given parts are set to default. Only supported ISO 8601 formats are accepted. For example: 050901 -> 01.Sept.2005 00:00:00, 20050201T10:00:30 -> 01.Feb.2005 10h00m30s Returned is the new date object
string | integer | Zend_Date | $date | ISO Date to set |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
setLocale | ( | $ | locale = null ) |
Sets a new standard locale for the date object. This locale will be used for all functions Returned is the really set locale. Example: 'de_XX' will be set to 'de' because 'de_XX' does not exist 'xx_YY' will be set to 'root' because 'xx' does not exist
string | Zend_Locale | $locale | (Optional) Locale for parsing input |
Zend_Date_Exception | When the given locale does not exist |
setMilliSecond | ( | $ | milli = null , |
$ | precision = null |
||
) |
Sets new milliseconds for the date object Example: setMilliSecond(550, 2) -> equals +5 Sec +50 MilliSec
integer | Zend_Date | $milli | (Optional) Millisecond to set, when null the actual millisecond is set |
integer | $precision | (Optional) Fraction precision of the given milliseconds |
setMinute | ( | $ | minute, |
$ | locale = null |
||
) |
Sets a new minute The minute is always a number. Returned is the new date object Example: 04.May.1993 13:07:25 -> setMinute(29); -> 04.May.1993 13:29:25
string | integer | array | Zend_Date | $minute | Minute to set |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
setMonth | ( | $ | month, |
$ | locale = null |
||
) |
Sets a new month The month can be a number or a string. Setting months lower then 0 and greater then 12 will result in adding or subtracting the relevant year. (12 months equal one year) If a localized monthname is given it will be parsed with the default locale or the optional set locale. Returned is the new date object
string | integer | array | Zend_Date | $month | Month to set |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
static setOptions | ( | array $ | options = array() ) |
[static] |
setSecond | ( | $ | second, |
$ | locale = null |
||
) |
Sets new seconds to the existing date object. The second is always a number. Returned is the new date object Example: 04.May.1993 13:07:25 -> setSecond(100); -> 04.May.1993 13:08:40
string | integer | array | Zend_Date | $second | Second to set |
string | Zend_Locale | $locale | (Optional) Locale for parsing input |
Zend_Date_Exception |
setTime | ( | $ | time, |
$ | format = null , |
||
$ | locale = null |
||
) |
Sets a new time for the date object. Format defines how to parse the time string. Also a complete date can be given, but only the time is used for setting. For example: dd.MMMM.yyTHH:mm' and 'ss sec'-> 10.May.07T25:11 and 44 sec => 1h11min44sec + 1 day Returned is the new date object and the existing date is left as it was before
string | integer | array | Zend_Date | $time | Time to set |
string | $format | OPTIONAL Timeformat for parsing input |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
setTimestamp | ( | $ | timestamp ) |
setWeek | ( | $ | week, |
$ | locale = null |
||
) |
Sets a new week. The week is always a number. The day of week is not changed. Returned is the new date object Example: 09.Jan.2007 13:07:25 -> setWeek(1); -> 02.Jan.2007 13:07:25
string | integer | array | Zend_Date | $week | Week to set |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
setWeekday | ( | $ | weekday, |
$ | locale = null |
||
) |
Sets a new weekday The weekday can be a number or a string. If a localized weekday name is given, then it will be parsed as a date in $locale (defaults to the same locale as $this). Returned is the new date object. Example: setWeekday(3); will set the wednesday of this week as day.
string | integer | array | Zend_Date | $month | Weekday to set |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
setYear | ( | $ | year, |
$ | locale = null |
||
) |
Sets a new year If the year is between 0 and 69, 2000 will be set (2000-2069) If the year if between 70 and 99, 1999 will be set (1970-1999) 3 or 4 digit years are set as expected. If you need to set year 0-99 use set() instead. Returned is the new date object
string | integer | array | Zend_Date | $date | Year to set |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
sub | ( | $ | date, |
$ | part = null , |
||
$ | locale = null |
||
) |
Subtracts a date from another date. This could be for example a RFC2822 date, the time, the year or only the timestamp. There are about 50 different supported date parts. For a complete list of supported datepart values look into the docu Be aware: Adding -2 Months is not equal to Subtracting 2 Months !!!
string | integer | array | Zend_Date | $date | Date or datepart to subtract |
string | $part | OPTIONAL Part of the date to sub, if null the timestamp is subtracted |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
subArpa | ( | $ | date, |
$ | locale = null |
||
) |
Subtracts a RFC 822 date from the date object. ARPA messages are used in emails or HTTP Headers. Only RFC 822 compilant date strings are accepted. For example: Sat, 14 Feb 09 00:31:30 +0100 Returned is the new date object
string | integer | Zend_Date | $date | RFC 822 Date to sub |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
subDate | ( | $ | date, |
$ | format = null , |
||
$ | locale = null |
||
) |
Subtracts a date from the existing date object. Format defines how to parse the date string. If only parts are given the other parts are set to 0. If no format is given, the standardformat of this locale is used. For example: MM.dd.YYYY -> 10 -> -10 months Be aware: Subtracting 2 months is not equal to Adding -2 months !!!
string | integer | array | Zend_Date | $date | Date to sub |
string | $format | OPTIONAL Date format for parsing input |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
subDay | ( | $ | day, |
$ | locale = null |
||
) |
Subtracts days from the existing date object. The day can be a number or a string. Subtracting days lower then 0 or greater than the number of this months days will result in adding or subtracting the relevant month. If a localized dayname is given it will be parsed with the default locale or the optional set locale. Returned is the new date object Example: subDay('Montag', 'de_AT'); will sub the number of days until the previous monday
string | integer | array | Zend_Date | $month | Day to sub |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
subDayOfYear | ( | $ | day, |
$ | locale = null |
||
) |
Subtracts a day of year from the existing date object. The day of year is always a number. Returned is the new date object Example: subDayOfYear(10); will subtract 10 days from the existing date object.
string | integer | array | Zend_Date | $day | Day of Year to sub |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
subHour | ( | $ | hour, |
$ | locale = null |
||
) |
Subtracts hours from the existing date object. The hour is always a number. Returned is the new date object Example: 04.May.1993 13:07:25 -> subHour(6); -> 05.May.1993 07:07:25
string | integer | array | Zend_Date | $hour | Hour to sub |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
subIso | ( | $ | date, |
$ | locale = null |
||
) |
Subtracts a ISO date from the date object. Not given parts are set to default. Only supported ISO 8601 formats are accepted. For example: 050901 -> - 01.Sept.2005 00:00:00, 10:00:00 -> -10h Returned is the new date object
string | integer | Zend_Date | $date | ISO Date to sub |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
subMilliSecond | ( | $ | milli = null , |
$ | precision = null |
||
) |
subMinute | ( | $ | minute, |
$ | locale = null |
||
) |
Subtracts minutes from the existing date object. The minute is always a number. Returned is the new date object Example: 04.May.1993 13:07:25 -> subMinute(9); -> 04.May.1993 12:58:25
string | integer | array | Zend_Date | $minute | Minute to sub |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
subMonth | ( | $ | month, |
$ | locale = null |
||
) |
Subtracts months from the existing date object. The month can be a number or a string. Subtracting months lower then 0 and greater then 12 will result in adding or subtracting the relevant year. (12 months equal one year) If a localized monthname is given it will be parsed with the default locale or the optional set locale. Returned is the new date object
string | integer | array | Zend_Date | $month | Month to sub |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
subSecond | ( | $ | second, |
$ | locale = null |
||
) |
Subtracts seconds from the existing date object. The second is always a number. Returned is the new date object Example: 04.May.1993 13:07:25 -> subSecond(10); -> 04.May.1993 13:07:15
string | integer | array | Zend_Date | $second | Second to sub |
string | Zend_Locale | $locale | (Optional) Locale for parsing input |
Zend_Date_Exception |
subTime | ( | $ | time, |
$ | format = null , |
||
$ | locale = null |
||
) |
Subtracts a time from the existing date. Format defines how to parse the time string. If only parts are given the other parts are set to 0. If no format is given, the standardformat of this locale is used. For example: HH:mm:ss -> 10 -> -10 hours
string | integer | array | Zend_Date | $time | Time to sub |
string | $format | OPTIONAL Timeformat for parsing input |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
subTimestamp | ( | $ | timestamp ) |
subWeek | ( | $ | week, |
$ | locale = null |
||
) |
Subtracts a week. The week is always a number. The day of week is not changed. Returned is the new date object Example: 09.Jan.2007 13:07:25 -> subWeek(1); -> 02.Jan.2007 13:07:25
string | integer | array | Zend_Date | $week | Week to sub |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
subWeekday | ( | $ | weekday, |
$ | locale = null |
||
) |
Subtracts weekdays from the existing date object. The weekday can be a number or a string. If a localized dayname is given it will be parsed with the default locale or the optional set locale. Returned is the new date object Example: subWeekday(3); will subtract the difference of days from the begining of the month until wednesday.
string | integer | array | Zend_Date | $month | Weekday to sub |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
subYear | ( | $ | year, |
$ | locale = null |
||
) |
Subs the year from the existing date object If the year is between 0 and 69, 2000 will be subtracted (2000-2069) If the year if between 70 and 99, 1999 will be subtracted (1970-1999) 3 or 4 digit years are subtracted as expected. If you need to subtract years from 0-99 use sub() instead. Returned is the new date object
string | integer | array | Zend_Date | $date | Year to sub |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
Zend_Date_Exception |
toArray | ( | ) |
toString | ( | $ | format = null , |
$ | type = null , |
||
$ | locale = null |
||
) |
Returns a string representation of the object Supported format tokens are: G - era, y - year, Y - ISO year, M - month, w - week of year, D - day of year, d - day of month E - day of week, e - number of weekday (1-7), h - hour 1-12, H - hour 0-23, m - minute, s - second A - milliseconds of day, z - timezone, Z - timezone offset, S - fractional second, a - period of day
Additionally format tokens but non ISO conform are: SS - day suffix, eee - php number of weekday(0-6), ddd - number of days per month l - Leap year, B - swatch internet time, I - daylight saving time, X - timezone offset in seconds r - RFC2822 format, U - unix timestamp
Not supported ISO tokens are u - extended year, Q - quarter, q - quarter, L - stand alone month, W - week of month F - day of week of month, g - modified julian, c - stand alone weekday, k - hour 0-11, K - hour 1-24 v - wall zone
string | $format | OPTIONAL Rule for formatting output. If null the default date format is used |
string | $type | OPTIONAL Type for the format string which overrides the standard setting |
string | Zend_Locale | $locale | OPTIONAL Locale for parsing input |
toValue | ( | $ | part = null ) |