Docs For Class Date

object Date Date(
[mixed
$date = null])

Constructor

Creates a new Date Object initialized to the current date/time in the system default time zone by default. A date optionally passed in may be in the ISO, TIMESTAMP or UNIXTIME format, or another Date object.

Tags:

return:	the new Date object
access:	public

Parameters:

mixed

$date

optional - date/time to initialize

[ Top ]

void addSeconds(
int
$sec)

Adds a given number of seconds to the date

Tags:

access:

public

Parameters:

int

$sec

the number of seconds to add

[ Top ]

boolean after(
object Date
$when)

Test if this date/time is after a certian date/time

Tags:

return:	true if this date is after $when
access:	public

Parameters:

object Date

$when

the date to test against

[ Top ]

boolean before(
object Date
$when)

Test if this date/time is before a certian date/time

Tags:

return:	true if this date is before $when
access:	public

Parameters:

object Date

$when

the date to test against

[ Top ]

int compare(
object Date
$d1, object Date
$d2)

Compares two dates

Compares two dates. Suitable for use in sorting functions.

Tags:

return:	0 if the dates are equal, -1 if d1 is before d2, 1 if d1 is after d2
access:	public

Parameters:

object Date	$d1	the first date
object Date	$d2	the second date

[ Top ]

void convertTZ(
object Date_TimeZone
$tz)

Converts this date to a new time zone

Converts this date to a new time zone. WARNING: This may not work correctly if your system does not allow putenv() or if localtime() does not work in your environment. See Date::TimeZone::inDaylightTime() for more information.

Tags:

access:

public

Parameters:

object Date_TimeZone

$tz

the Date::TimeZone object for the conversion time zone

[ Top ]

void convertTZbyID(
string
$id)

Converts this date to a new time zone, given a valid time zone ID

Converts this date to a new time zone, given a valid time zone ID WARNING: This may not work correctly if your system does not allow putenv() or if localtime() does not work in your environment. See Date::TimeZone::inDaylightTime() for more information.

Tags:

access:

public

Parameters:

string

$id

id a time zone id

[ Top ]

void copy(
object Date
$date)

Copy values from another Date object

Makes this Date a copy of another Date object.

Tags:

access:

public

Parameters:

object Date

$date

Date to copy from

[ Top ]

boolean equals(
object Date
$when)

Test if this date/time is exactly equal to a certian date/time

Tags:

return:	true if this date is exactly equal to $when
access:	public

Parameters:

object Date

$when

the date to test against

[ Top ]

string format(
string
$format)

Date pretty printing, similar to strftime()

Formats the date in the given format, much like strftime(). Most strftime() options are supported.

formatting options:


1     %a

abbreviated weekday name (Sun, Mon, Tue)


1     %A

full weekday name (Sunday, Monday, Tuesday)


1     %b

abbreviated month name (Jan, Feb, Mar)


1     %B

full month name (January, February, March)


1     %C

century number (the year divided by 100 and truncated to an integer, range 00 to 99)


1     %d

day of month (range 00 to 31)


1     %D

same as "%m/%d/%y"


1     %e

day of month, single digit (range 0 to 31)


1     %E

number of days since unspecified epoch (integer, Date_Calc::dateToDays())


1     %H

hour as decimal number (00 to 23)


1     %I

hour as decimal number on 12-hour clock (01 to 12)


1     %j

day of year (range 001 to 366)


1     %m

month as decimal number (range 01 to 12)


1     %M

minute as a decimal number (00 to 59)


1     %n

newline character (\n)


1     %O

dst-corrected timezone offset expressed as "+/-HH:MM"


1     %o

raw timezone offset expressed as "+/-HH:MM"


1     %p

either 'am' or 'pm' depending on the time


1     %P

either 'AM' or 'PM' depending on the time


1     %r

time in am/pm notation, same as "%I:%M:%S %p"


1     %R

time in 24-hour notation, same as "%H:%M"


1     %S

seconds as a decimal number (00 to 59)


1     %t

tab character (\t)


1     %T

current time, same as "%H:%M:%S"


1     %w

weekday as decimal (0 = Sunday)


1     %U

week number of current year, first sunday as first week


1     %y

year as decimal (range 00 to 99)


1     %Y

year as decimal including century (range 0000 to 9999)


1     %%

literal '%'

Tags:

return:	date/time in given format
access:	public

Parameters:

string

$format

format the format string for returned date/time

[ Top ]

string getDate(
[int
$format = DATE_FORMAT_ISO])

Get a string (or other) representation of this date

Get a string (or other) representation of this date in the format specified by the DATE_FORMAT_* constants.

Tags:

return:	the date in the requested format
access:	public

Parameters:

int

$format

format constant (DATE_FORMAT_*) of the output date

[ Top ]

int getDay(
)

Returns the day field of the date object

Tags:

return:	the day
access:	public

[ Top ]

string getDayName(
[boolean
$abbr = false])

Gets the full name or abbriviated name of this weekday

Tags:

return:	name of this day
access:	public

Parameters:

boolean

$abbr

abbrivate the name

[ Top ]

int getDayOfWeek(
)

Gets the day of the week for this date

Gets the day of the week for this date (0=Sunday)

Tags:

return:	the day of the week (0=Sunday)
access:	public

[ Top ]

int getDaysInMonth(
)

Gets number of days in the month for this date

Tags:

return:	number of days in this month
access:	public

[ Top ]

int getHour(
)

Returns the hour field of the date object

Tags:

return:	the hour
access:	public

[ Top ]

int getJulianDate(
)

Get the Julian date for this date

Tags:

return:	the Julian date
access:	public

[ Top ]

int getMinute(
)

Returns the minute field of the date object

Tags:

return:	the minute
access:	public

[ Top ]

int getMonth(
)

Returns the month field of the date object

Tags:

return:	the month
access:	public

[ Top ]

string getMonthName(
[boolean
$abbr = false])

Gets the full name or abbriviated name of this month

Tags:

return:	name of this month
access:	public

Parameters:

boolean

$abbr

abbrivate the name

[ Top ]

object Date getNextDay(
)

Get a Date object for the day after this one

Get a Date object for the day after this one. The time of the returned Date object is the same as this time.

Tags:

return:	Date representing the next day
access:	public

[ Top ]

object Date getNextWeekday(
)

Get a Date object for the weekday after this one

Get a Date object for the weekday after this one. The time of the returned Date object is the same as this time.

Tags:

return:	Date representing the next weekday
access:	public

[ Top ]

object Date getPrevDay(
)

Get a Date object for the day before this one

Get a Date object for the day before this one. The time of the returned Date object is the same as this time.

Tags:

return:	Date representing the previous day
access:	public

[ Top ]

object Date getPrevWeekday(
)

Get a Date object for the weekday before this one

Get a Date object for the weekday before this one. The time of the returned Date object is the same as this time.

Tags:

return:	Date representing the previous weekday
access:	public

[ Top ]

int getQuarterOfYear(
)

Gets the quarter of the year for this date

Tags:

return:	the quarter of the year (1-4)
access:	public

[ Top ]

int getSecond(
)

Returns the second field of the date object

Tags:

return:	the second
access:	public

[ Top ]

int getTime(
)

Get this date/time in Unix time() format

Get a representation of this date in Unix time() format. This may only be valid for dates from 1970 to ~2038.

Tags:

return:	number of seconds since the unix epoch
access:	public

[ Top ]

int getWeekOfYear(
)

Gets the week of the year for this date

Tags:

return:	the week of the year
access:	public

[ Top ]

int getWeeksInMonth(
)

Gets the number of weeks in the month for this date

Tags:

return:	number of weeks in this month
access:	public

[ Top ]

int getYear(
)

Returns the year field of the date object

Tags:

return:	the year
access:	public

[ Top ]

boolean inDaylightTime(
)

Tests if this date/time is in DST

Returns true if daylight savings time is in effect for this date in this date's time zone. See Date_TimeZone::inDaylightTime() for compatability information.

Tags:

return:	true if DST is in effect for this date
access:	public

[ Top ]

boolean isFuture(
)

Determine if this date is in the future

Tags:

return:	true if this date is in the future
access:	public

[ Top ]

boolean isLeapYear(
)

Determine if the year in this date is a leap year

Tags:

return:	true if this year is a leap year
access:	public

[ Top ]

boolean isPast(
)

Determine if this date is in the past

Tags:

return:	true if this date is in the past
access:	public

[ Top ]

void setDate(
string
$date, [int
$format = DATE_FORMAT_ISO])

Set the fields of a Date object based on the input date and format

Set the fields of a Date object based on the input date and format, which is specified by the DATE_FORMAT_* constants.

Tags:

access:

public

Parameters:

string	$date	input date
int	$format	format constant (DATE_FORMAT_*) of the input date

[ Top ]

void setDay(
int
$d)

Set the day field of the date object

Set the day field of the date object, invalid days (not 1-31) are set to 1.

Tags:

access:

public

Parameters:

int

$d

the day

[ Top ]

void setHour(
int
$h)

Set the hour field of the date object

Set the hour field of the date object in 24-hour format. Invalid hours (not 0-23) are set to 0.

Tags:

access:

public

Parameters:

int

$h

the hour

[ Top ]

void setMinute(
int
$m)

Set the minute field of the date object

Set the minute field of the date object, invalid minutes (not 0-59) are set to 0.

Tags:

access:

public

Parameters:

int

$m

the minute

[ Top ]

void setMonth(
int
$m)

Set the month field of the date object

Set the month field of the date object, invalid months (not 1-12) are set to 1.

Tags:

access:

public

Parameters:

int

$m

the month

[ Top ]

void setSecond(
int
$s)

Set the second field of the date object

Set the second field of the date object, invalid seconds (not 0-59) are set to 0.

Tags:

access:

public

Parameters:

int

$s

the second

[ Top ]

void setTZ(
object Date_TimeZone
$tz)

Sets the time zone of this Date

Sets the time zone of this date with the given Date_TimeZone object. Does not alter the date/time, only assigns a new time zone. For conversion, use convertTZ().

Tags:

access:

public

Parameters:

object Date_TimeZone

$tz

the Date_TimeZone object to use

[ Top ]

void setTZbyID(
string
$id)

Sets the time zone of this date with the given time zone id

Sets the time zone of this date with the given time zone id, or to the system default if the given id is invalid. Does not alter the date/time, only assigns a new time zone. For conversion, use convertTZ().

Tags:

access:

public

Parameters:

string

$id

id a time zone id

[ Top ]

void setYear(
int
$y)

Set the year field of the date object

Set the year field of the date object, invalid years (not 0-9999) are set to 0.

Tags:

access:

public

Parameters:

int

$y

the year

[ Top ]

void subtractSeconds(
int
$sec)

Subtracts a given number of seconds from the date

Tags:

access:

public

Parameters:

int

$sec

the number of seconds to subtract

[ Top ]

void toUTC(
)

Converts this date to UTC and sets this date's timezone to UTC

Tags:

access:

public

[ Top ]

Class: Date

Class Overview

Author(s):

Version:

Variables

Methods

Inherited Variables

Inherited Methods

Class Details

Tags:

Class Variables

$day =

$hour =

$minute =

$month =

$second =

$tz =

$year =

Class Methods

constructor Date [line 114]

Tags:

Parameters:

method addSeconds [line 511]

Tags:

Parameters:

method after [line 651]

Tags:

Parameters:

method before [line 636]

Tags:

Parameters:

method compare [line 610]

Tags:

Parameters:

method convertTZ [line 465]

Tags:

Parameters:

method convertTZbyID [line 493]

Tags:

Parameters:

method copy [line 193]

Tags:

Parameters:

method equals [line 666]

Tags:

Parameters:

method format [line 247]

Tags:

Parameters:

method getDate [line 170]

Tags:

Parameters:

method getDay [line 934]

Tags:

method getDayName [line 802]

Tags:

Parameters:

method getDayOfWeek [line 736]

Tags:

method getDaysInMonth [line 775]

Tags:

method getHour [line 947]

Tags:

method getJulianDate [line 723]

Tags:

method getMinute [line 960]

Tags:

method getMonth [line 921]

Tags:

method getMonthName [line 819]

Tags:

Parameters:

method getNextDay [line 836]

Tags:

method getNextWeekday [line 872]

Tags:

method getPrevDay [line 854]

Tags:

method getPrevWeekday [line 890]

Tags: