PHP Класс ExpressiveDate

Наследование: extends DateTime
Показать файл Открыть проект Примеры использования класса

Защищенные свойства (Protected)

Свойство Тип Описание
$defaultDateFormat string Default date format used when casting object to string.
$weekStartDay integer Starting day of the week, where 0 is Sunday and 1 is Monday.

Открытые методы

Метод Описание
__call ( string $method, array $parameters ) : mixed Dynamically handle calls for date attributes and testers.
__construct ( string $time = null, string | DateTimeZone $timezone = null ) : void Create a new ExpressiveDate instance.
__toString ( ) : string Return the default date format when casting to string.
addDays ( integer $amount ) : ExpressiveDate Add a given amount of days.
addHours ( integer $amount ) : ExpressiveDate Add a given amount of hours.
addMinutes ( integer $amount ) : ExpressiveDate Add a given amount of minutes.
addMonths ( integer $amount ) : ExpressiveDate Add a given amount of months.
addOneDay ( ) : ExpressiveDate Add one day.
addOneHour ( ) : ExpressiveDate Add one hour.
addOneMinute ( ) : ExpressiveDate Add one minute.
addOneMonth ( ) : ExpressiveDate Add one month.
addOneSecond ( ) : ExpressiveDate Add one second.
addOneWeek ( ) : ExpressiveDate Add one week.
addOneYear ( ) : ExpressiveDate Add one year.
addSeconds ( integer $amount ) : ExpressiveDate Add a given amount of seconds.
addWeeks ( integer $amount ) : ExpressiveDate Add a given amount of weeks.
addYears ( integer $amount ) : ExpressiveDate Add a given amount of years.
copy ( ) : ExpressiveDate Return copy of expressive date object
endOfDay ( ) : ExpressiveDate Use the end of the day.
endOfMonth ( ) : ExpressiveDate Use the end of the month.
endOfWeek ( ) : ExpressiveDate Use the end of the week.
equalTo ( ExpressiveDate $date ) : boolean Determine if date is equal to another Expressive Date instance.
getDate ( ) : string Get a date string in the format of 2012-12-04.
getDateTime ( ) : string Get a date and time string in the format of 2012-12-04 23:43:27.
getDefaultDate ( ) : string Get a date string in the default format.
getDifferenceInDays ( ExpressiveDate $compare = null ) : string Get the difference in days.
getDifferenceInHours ( ExpressiveDate $compare = null ) : string Get the difference in hours.
getDifferenceInMinutes ( ExpressiveDate $compare = null ) : string Get the difference in minutes.
getDifferenceInMonths ( ExpressiveDate $compare = null ) : string Get the difference in months.
getDifferenceInSeconds ( ExpressiveDate $compare = null ) : string Get the difference in seconds.
getDifferenceInYears ( ExpressiveDate $compare = null ) : string Get the difference in years.
getLongDate ( ) : string Get a date string in the format of January 31st, 1991 at 7:45am.
getRelativeDate ( ExpressiveDate $compare = null ) : string Get a relative date string, e.g., 3 days ago.
getShortDate ( ) : string Get a date string in the format of Jan 31, 1991.
getTime ( ) : string Get a date string in the format of 07:42:32.
getWeekStartDay ( ) : integer Get the starting day of the week, where 0 is Sunday and 1 is Monday
greaterOrEqualTo ( ExpressiveDate $date ) : boolean Determine if date is greater than or equal to another Expressive Date instance.
greaterThan ( ExpressiveDate $date ) : boolean Determine if date is greater than another Expressive Date instance.
isWeekday ( ) : boolean Determine if day is a weekday.
isWeekend ( ) : boolean Determine if day is a weekend.
lessOrEqualTo ( ExpressiveDate $date ) : boolean Determine if date is less than or equal to another Expressive Date instance.
lessThan ( ExpressiveDate $date ) : boolean Determine if date is less than another Expressive Date instance.
make ( string $time = null, string | DateTimeZone $timezone = null ) : ExpressiveDate Make and return new ExpressiveDate instance.
makeFromDate ( integer $year = null, integer $month = null, integer $day = null, string | DateTimeZone $timezone = null ) : ExpressiveDate Make and return a new ExpressiveDate instance with defined year, month, and day.
makeFromDateTime ( integer $year = null, integer $month = null, integer $day = null, integer $hour = null, integer $minute = null, integer $second = null, string | DateTimeZone $timezone = null ) : ExpressiveDate Make and return a new ExpressiveDate instance with defined year, month, day, hour, minute, and second.
makeFromTime ( integer $hour = null, integer $minute = null, integer $second = null, string | DateTimeZone $timezone = null ) : ExpressiveDate Make and return a new ExpressiveDate instance with defined hour, minute, and second.
minusDays ( integer $amount ) : ExpressiveDate Minus a given amount of days.
minusHours ( integer $amount ) : ExpressiveDate Minus a given amount of hours.
minusMinutes ( integer $amount ) : ExpressiveDate Minus a given amount of minutes.
minusMonths ( integer $amount ) : ExpressiveDate Minus a given amount of months.
minusOneDay ( ) : ExpressiveDate Minus one day.
minusOneHour ( ) : ExpressiveDate Minus one hour.
minusOneMinute ( ) : ExpressiveDate Minus one minute.
minusOneMonth ( ) : ExpressiveDate Minus one month.
minusOneSecond ( ) : ExpressiveDate Minus one second.
minusOneWeek ( ) : ExpressiveDate Minus one week.
minusOneYear ( ) : ExpressiveDate Minus one year.
minusSeconds ( integer $amount ) : ExpressiveDate Minus a given amount of seconds.
minusWeeks ( integer $amount ) : ExpressiveDate Minus a given amount of weeks.
minusYears ( integer $amount ) : ExpressiveDate Minus a given amount of years.
notEqualTo ( ExpressiveDate $date ) : boolean Determine if date is not equal to another Expressive Date instance.
now ( ) : ExpressiveDate Use the current date and time.
sameAs ( ExpressiveDate $date ) : boolean Alias for ExpressiveDate::equalTo()
setDefaultDateFormat ( string $format ) : ExpressiveDate Set the default date format.
setTimestampFromString ( string $string ) : ExpressiveDate Sets the timestamp from a human readable string.
setTimezone ( string | DateTimeZone $timezone ) : ExpressiveDate Set the timezone.
setWeekStartDay ( integer | string $weekStartDay ) : void Set the starting day of the week, where 0 is Sunday and 1 is Monday.
startOfDay ( ) : ExpressiveDate Use the start of the day.
startOfMonth ( ) : ExpressiveDate Use the start of the month.
startOfWeek ( ) : ExpressiveDate Use the start of the week.
today ( ) : ExpressiveDate Use today's date and time at midnight.
tomorrow ( ) : ExpressiveDate Use tomorrow's date and time at midnight.
yesterday ( ) : ExpressiveDate Use yesterday's date and time at midnight.

Защищенные методы

Метод Описание
getDateAttribute ( string $attribute ) : mixed Get a date attribute.
isDateAttribute ( string $attribute ) : mixed Syntactical sugar for determining if date object "is" a condition.
isFloat ( integer | float $amount ) : boolean Determine if a given amount is a floating point number.
modifyDays ( integer $amount, boolean $invert = false ) : ExpressiveDate Modify by an amount of days.
modifyFromInterval ( DateInterval $interval, boolean $invert = false ) : ExpressiveDate Modify from a DateInterval object.
modifyHours ( integer $amount, boolean $invert = false ) : ExpressiveDate Modify by an amount of hours.
modifyMinutes ( integer $amount, boolean $invert = false ) : ExpressiveDate Modify by an amount of minutes.
modifyMonths ( integer $amount, boolean $invert = false ) : ExpressiveDate Modify by an amount of months.
modifySeconds ( integer $amount, boolean $invert = false ) : ExpressiveDate Modify by an amount of seconds.
modifyWeeks ( integer $amount, boolean $invert = false ) : ExpressiveDate Modify by an amount of weeks.
modifyYears ( integer $amount, boolean $invert = false ) : ExpressiveDate Modify by an amount of Years.
parseSuppliedTimezone ( string | DateTimeZone $timezone ) : DateTimeZone Parse a supplied timezone.
setDateAttribute ( string $attribute, $value ) : mixed Set a date attribute.

Описание методов

__call() публичный Метод

Dynamically handle calls for date attributes and testers.
public __call ( string $method, array $parameters ) : mixed
$method string
$parameters array
Результат mixed

__construct() публичный Метод

Create a new ExpressiveDate instance.
public __construct ( string $time = null, string | DateTimeZone $timezone = null ) : void
$time string
$timezone string | DateTimeZone
Результат void

__toString() публичный Метод

Return the default date format when casting to string.
public __toString ( ) : string
Результат string

addDays() публичный Метод

Add a given amount of days.
public addDays ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

addHours() публичный Метод

Add a given amount of hours.
public addHours ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

addMinutes() публичный Метод

Add a given amount of minutes.
public addMinutes ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

addMonths() публичный Метод

Add a given amount of months.
public addMonths ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

addOneDay() публичный Метод

Add one day.
public addOneDay ( ) : ExpressiveDate
Результат ExpressiveDate

addOneHour() публичный Метод

Add one hour.
public addOneHour ( ) : ExpressiveDate
Результат ExpressiveDate

addOneMinute() публичный Метод

Add one minute.
public addOneMinute ( ) : ExpressiveDate
Результат ExpressiveDate

addOneMonth() публичный Метод

Add one month.
public addOneMonth ( ) : ExpressiveDate
Результат ExpressiveDate

addOneSecond() публичный Метод

Add one second.
public addOneSecond ( ) : ExpressiveDate
Результат ExpressiveDate

addOneWeek() публичный Метод

Add one week.
public addOneWeek ( ) : ExpressiveDate
Результат ExpressiveDate

addOneYear() публичный Метод

Add one year.
public addOneYear ( ) : ExpressiveDate
Результат ExpressiveDate

addSeconds() публичный Метод

Add a given amount of seconds.
public addSeconds ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

addWeeks() публичный Метод

Add a given amount of weeks.
public addWeeks ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

addYears() публичный Метод

Add a given amount of years.
public addYears ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

copy() публичный Метод

Return copy of expressive date object
public copy ( ) : ExpressiveDate
Результат ExpressiveDate

endOfDay() публичный Метод

Use the end of the day.
public endOfDay ( ) : ExpressiveDate
Результат ExpressiveDate

endOfMonth() публичный Метод

Use the end of the month.
public endOfMonth ( ) : ExpressiveDate
Результат ExpressiveDate

endOfWeek() публичный Метод

Use the end of the week.
public endOfWeek ( ) : ExpressiveDate
Результат ExpressiveDate

equalTo() публичный Метод

Determine if date is equal to another Expressive Date instance.
public equalTo ( ExpressiveDate $date ) : boolean
$date ExpressiveDate
Результат boolean

getDate() публичный Метод

Get a date string in the format of 2012-12-04.
public getDate ( ) : string
Результат string

getDateAttribute() защищенный Метод

Get a date attribute.
protected getDateAttribute ( string $attribute ) : mixed
$attribute string
Результат mixed

getDateTime() публичный Метод

Get a date and time string in the format of 2012-12-04 23:43:27.
public getDateTime ( ) : string
Результат string

getDefaultDate() публичный Метод

Get a date string in the default format.
public getDefaultDate ( ) : string
Результат string

getDifferenceInDays() публичный Метод

Get the difference in days.
public getDifferenceInDays ( ExpressiveDate $compare = null ) : string
$compare ExpressiveDate
Результат string

getDifferenceInHours() публичный Метод

Get the difference in hours.
public getDifferenceInHours ( ExpressiveDate $compare = null ) : string
$compare ExpressiveDate
Результат string

getDifferenceInMinutes() публичный Метод

Get the difference in minutes.
public getDifferenceInMinutes ( ExpressiveDate $compare = null ) : string
$compare ExpressiveDate
Результат string

getDifferenceInMonths() публичный Метод

Get the difference in months.
public getDifferenceInMonths ( ExpressiveDate $compare = null ) : string
$compare ExpressiveDate
Результат string

getDifferenceInSeconds() публичный Метод

Get the difference in seconds.
public getDifferenceInSeconds ( ExpressiveDate $compare = null ) : string
$compare ExpressiveDate
Результат string

getDifferenceInYears() публичный Метод

Get the difference in years.
public getDifferenceInYears ( ExpressiveDate $compare = null ) : string
$compare ExpressiveDate
Результат string

getLongDate() публичный Метод

Get a date string in the format of January 31st, 1991 at 7:45am.
public getLongDate ( ) : string
Результат string

getRelativeDate() публичный Метод

Get a relative date string, e.g., 3 days ago.
public getRelativeDate ( ExpressiveDate $compare = null ) : string
$compare ExpressiveDate
Результат string

getShortDate() публичный Метод

Get a date string in the format of Jan 31, 1991.
public getShortDate ( ) : string
Результат string

getTime() публичный Метод

Get a date string in the format of 07:42:32.
public getTime ( ) : string
Результат string

getWeekStartDay() публичный Метод

Get the starting day of the week, where 0 is Sunday and 1 is Monday
public getWeekStartDay ( ) : integer
Результат integer

greaterOrEqualTo() публичный Метод

Determine if date is greater than or equal to another Expressive Date instance.
public greaterOrEqualTo ( ExpressiveDate $date ) : boolean
$date ExpressiveDate
Результат boolean

greaterThan() публичный Метод

Determine if date is greater than another Expressive Date instance.
public greaterThan ( ExpressiveDate $date ) : boolean
$date ExpressiveDate
Результат boolean

isDateAttribute() защищенный Метод

Syntactical sugar for determining if date object "is" a condition.
protected isDateAttribute ( string $attribute ) : mixed
$attribute string
Результат mixed

isFloat() защищенный Метод

Determine if a given amount is a floating point number.
protected isFloat ( integer | float $amount ) : boolean
$amount integer | float
Результат boolean

isWeekday() публичный Метод

Determine if day is a weekday.
public isWeekday ( ) : boolean
Результат boolean

isWeekend() публичный Метод

Determine if day is a weekend.
public isWeekend ( ) : boolean
Результат boolean

lessOrEqualTo() публичный Метод

Determine if date is less than or equal to another Expressive Date instance.
public lessOrEqualTo ( ExpressiveDate $date ) : boolean
$date ExpressiveDate
Результат boolean

lessThan() публичный Метод

Determine if date is less than another Expressive Date instance.
public lessThan ( ExpressiveDate $date ) : boolean
$date ExpressiveDate
Результат boolean

make() публичный статический Метод

Make and return new ExpressiveDate instance.
public static make ( string $time = null, string | DateTimeZone $timezone = null ) : ExpressiveDate
$time string
$timezone string | DateTimeZone
Результат ExpressiveDate

makeFromDate() публичный статический Метод

Make and return a new ExpressiveDate instance with defined year, month, and day.
public static makeFromDate ( integer $year = null, integer $month = null, integer $day = null, string | DateTimeZone $timezone = null ) : ExpressiveDate
$year integer
$month integer
$day integer
$timezone string | DateTimeZone
Результат ExpressiveDate

makeFromDateTime() публичный статический Метод

Make and return a new ExpressiveDate instance with defined year, month, day, hour, minute, and second.
public static makeFromDateTime ( integer $year = null, integer $month = null, integer $day = null, integer $hour = null, integer $minute = null, integer $second = null, string | DateTimeZone $timezone = null ) : ExpressiveDate
$year integer
$month integer
$day integer
$hour integer
$minute integer
$second integer
$timezone string | DateTimeZone
Результат ExpressiveDate

makeFromTime() публичный статический Метод

Make and return a new ExpressiveDate instance with defined hour, minute, and second.
public static makeFromTime ( integer $hour = null, integer $minute = null, integer $second = null, string | DateTimeZone $timezone = null ) : ExpressiveDate
$hour integer
$minute integer
$second integer
$timezone string | DateTimeZone
Результат ExpressiveDate

minusDays() публичный Метод

Minus a given amount of days.
public minusDays ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

minusHours() публичный Метод

Minus a given amount of hours.
public minusHours ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

minusMinutes() публичный Метод

Minus a given amount of minutes.
public minusMinutes ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

minusMonths() публичный Метод

Minus a given amount of months.
public minusMonths ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

minusOneDay() публичный Метод

Minus one day.
public minusOneDay ( ) : ExpressiveDate
Результат ExpressiveDate

minusOneHour() публичный Метод

Minus one hour.
public minusOneHour ( ) : ExpressiveDate
Результат ExpressiveDate

minusOneMinute() публичный Метод

Minus one minute.
public minusOneMinute ( ) : ExpressiveDate
Результат ExpressiveDate

minusOneMonth() публичный Метод

Minus one month.
public minusOneMonth ( ) : ExpressiveDate
Результат ExpressiveDate

minusOneSecond() публичный Метод

Minus one second.
public minusOneSecond ( ) : ExpressiveDate
Результат ExpressiveDate

minusOneWeek() публичный Метод

Minus one week.
public minusOneWeek ( ) : ExpressiveDate
Результат ExpressiveDate

minusOneYear() публичный Метод

Minus one year.
public minusOneYear ( ) : ExpressiveDate
Результат ExpressiveDate

minusSeconds() публичный Метод

Minus a given amount of seconds.
public minusSeconds ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

minusWeeks() публичный Метод

Minus a given amount of weeks.
public minusWeeks ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

minusYears() публичный Метод

Minus a given amount of years.
public minusYears ( integer $amount ) : ExpressiveDate
$amount integer
Результат ExpressiveDate

modifyDays() защищенный Метод

Modify by an amount of days.
protected modifyDays ( integer $amount, boolean $invert = false ) : ExpressiveDate
$amount integer
$invert boolean
Результат ExpressiveDate

modifyFromInterval() защищенный Метод

Modify from a DateInterval object.
protected modifyFromInterval ( DateInterval $interval, boolean $invert = false ) : ExpressiveDate
$interval DateInterval
$invert boolean
Результат ExpressiveDate

modifyHours() защищенный Метод

Modify by an amount of hours.
protected modifyHours ( integer $amount, boolean $invert = false ) : ExpressiveDate
$amount integer
$invert boolean
Результат ExpressiveDate

modifyMinutes() защищенный Метод

Modify by an amount of minutes.
protected modifyMinutes ( integer $amount, boolean $invert = false ) : ExpressiveDate
$amount integer
$invert boolean
Результат ExpressiveDate

modifyMonths() защищенный Метод

Modify by an amount of months.
protected modifyMonths ( integer $amount, boolean $invert = false ) : ExpressiveDate
$amount integer
$invert boolean
Результат ExpressiveDate

modifySeconds() защищенный Метод

Modify by an amount of seconds.
protected modifySeconds ( integer $amount, boolean $invert = false ) : ExpressiveDate
$amount integer
$invert boolean
Результат ExpressiveDate

modifyWeeks() защищенный Метод

Modify by an amount of weeks.
protected modifyWeeks ( integer $amount, boolean $invert = false ) : ExpressiveDate
$amount integer
$invert boolean
Результат ExpressiveDate

modifyYears() защищенный Метод

Modify by an amount of Years.
protected modifyYears ( integer $amount, boolean $invert = false ) : ExpressiveDate
$amount integer
$invert boolean
Результат ExpressiveDate

notEqualTo() публичный Метод

Determine if date is not equal to another Expressive Date instance.
public notEqualTo ( ExpressiveDate $date ) : boolean
$date ExpressiveDate
Результат boolean

now() публичный Метод

Use the current date and time.
public now ( ) : ExpressiveDate
Результат ExpressiveDate

parseSuppliedTimezone() защищенный Метод

Parse a supplied timezone.
protected parseSuppliedTimezone ( string | DateTimeZone $timezone ) : DateTimeZone
$timezone string | DateTimeZone
Результат DateTimeZone

sameAs() публичный Метод

Alias for ExpressiveDate::equalTo()
public sameAs ( ExpressiveDate $date ) : boolean
$date ExpressiveDate
Результат boolean

setDateAttribute() защищенный Метод

Set a date attribute.
protected setDateAttribute ( string $attribute, $value ) : mixed
$attribute string
Результат mixed

setDefaultDateFormat() публичный Метод

Set the default date format.
public setDefaultDateFormat ( string $format ) : ExpressiveDate
$format string
Результат ExpressiveDate

setTimestampFromString() публичный Метод

Sets the timestamp from a human readable string.
public setTimestampFromString ( string $string ) : ExpressiveDate
$string string
Результат ExpressiveDate

setTimezone() публичный Метод

Set the timezone.
public setTimezone ( string | DateTimeZone $timezone ) : ExpressiveDate
$timezone string | DateTimeZone
Результат ExpressiveDate

setWeekStartDay() публичный Метод

Set the starting day of the week, where 0 is Sunday and 1 is Monday.
public setWeekStartDay ( integer | string $weekStartDay ) : void
$weekStartDay integer | string
Результат void

startOfDay() публичный Метод

Use the start of the day.
public startOfDay ( ) : ExpressiveDate
Результат ExpressiveDate

startOfMonth() публичный Метод

Use the start of the month.
public startOfMonth ( ) : ExpressiveDate
Результат ExpressiveDate

startOfWeek() публичный Метод

Use the start of the week.
public startOfWeek ( ) : ExpressiveDate
Результат ExpressiveDate

today() публичный Метод

Use today's date and time at midnight.
public today ( ) : ExpressiveDate
Результат ExpressiveDate

tomorrow() публичный Метод

Use tomorrow's date and time at midnight.
public tomorrow ( ) : ExpressiveDate
Результат ExpressiveDate

yesterday() публичный Метод

Use yesterday's date and time at midnight.
public yesterday ( ) : ExpressiveDate
Результат ExpressiveDate

Описание свойств

$defaultDateFormat защищенное свойство

Default date format used when casting object to string.
protected string $defaultDateFormat
Результат string

$weekStartDay защищенное свойство

Starting day of the week, where 0 is Sunday and 1 is Monday.
protected int $weekStartDay
Результат integer