FileAccess Orion

Carbon extends DateTime
in package
implements CarbonInterface Uses Date

A simple API extension for DateTime.

<autodoc generated by composer phpdoc>

Interfaces, Classes, Traits and Enums

CarbonInterface
Common interface for Carbon and CarbonImmutable.

Table of Contents

$age  : int
$century  : int
$day  : int
$dayName  : string
$dayOfWeek  : int
$dayOfWeekIso  : int
$dayOfYear  : int
$daysInMonth  : int
$daysInYear  : int
$decade  : int
$dst  : bool
$englishDayOfWeek  : string
$englishMonth  : string
$firstWeekDay  : int
$hour  : int
$isoWeek  : int
$isoWeeksInYear  : int
$isoWeekYear  : int
$lastWeekDay  : int
$latinMeridiem  : string
$latinUpperMeridiem  : string
$local  : bool
$locale  : string
$localeDayOfWeek  : string
$localeMonth  : string
$meridiem  : string
$micro  : int
$microsecond  : int
$millennium  : int
$milli  : int
$millisecond  : int
$milliseconds  : int
$minDayName  : string
$minute  : int
$month  : int
$monthName  : string
$noZeroHour  : int
$offset  : int
$offsetHours  : int
$offsetMinutes  : int
$quarter  : int
$second  : int
$shortDayName  : string
$shortEnglishDayOfWeek  : string
$shortEnglishMonth  : string
$shortLocaleDayOfWeek  : string
$shortLocaleMonth  : string
$shortMonthName  : string
$timestamp  : int
$timezone  : CarbonTimeZone
$timezoneAbbreviatedName  : string
$timezoneName  : string
$tz  : CarbonTimeZone
$tzAbbrName  : string
$tzName  : string
$upperMeridiem  : string
$utc  : bool
$week  : int
$weekNumberInMonth  : int
$weekOfMonth  : int
$weekOfYear  : int
$weeksInYear  : int
$weekYear  : int
$year  : int
$yearIso  : int
$days  : array<string|int, mixed>
Names of days of the week.
$units  : array<string|int, mixed>
List of unit and magic methods associated as doc-comments.
$utf8  : bool
Will UTF8 encoding be used to print localized date/time ?
__call()  : mixed
Dynamically handle calls to the class.
__callStatic()  : mixed
Dynamically handle calls to the class.
__get()  : string|int|bool|DateTimeZone|null
Get a part of the Carbon object
__isset()  : bool
Check if an attribute exists on the object
__set()  : void
Set a part of the Carbon object
__set_state()  : static
The __set_state handler.
addCenturies()  : Carbon
addCenturiesNoOverflow()  : Carbon
addCenturiesWithNoOverflow()  : Carbon
addCenturiesWithoutOverflow()  : Carbon
addCenturiesWithOverflow()  : Carbon
addCentury()  : Carbon
addCenturyNoOverflow()  : Carbon
addCenturyWithNoOverflow()  : Carbon
addCenturyWithoutOverflow()  : Carbon
addCenturyWithOverflow()  : Carbon
addDay()  : Carbon
addDays()  : Carbon
addDecade()  : Carbon
addDecadeNoOverflow()  : Carbon
addDecades()  : Carbon
addDecadesNoOverflow()  : Carbon
addDecadesWithNoOverflow()  : Carbon
addDecadesWithoutOverflow()  : Carbon
addDecadesWithOverflow()  : Carbon
addDecadeWithNoOverflow()  : Carbon
addDecadeWithoutOverflow()  : Carbon
addDecadeWithOverflow()  : Carbon
addHour()  : Carbon
addHours()  : Carbon
addMicro()  : Carbon
addMicros()  : Carbon
addMicrosecond()  : Carbon
addMicroseconds()  : Carbon
addMillennia()  : Carbon
addMillenniaNoOverflow()  : Carbon
addMillenniaWithNoOverflow()  : Carbon
addMillenniaWithoutOverflow()  : Carbon
addMillenniaWithOverflow()  : Carbon
addMillennium()  : Carbon
addMillenniumNoOverflow()  : Carbon
addMillenniumWithNoOverflow()  : Carbon
addMillenniumWithoutOverflow()  : Carbon
addMillenniumWithOverflow()  : Carbon
addMilli()  : Carbon
addMillis()  : Carbon
addMillisecond()  : Carbon
addMilliseconds()  : Carbon
addMinute()  : Carbon
addMinutes()  : Carbon
addMonth()  : Carbon
addMonthNoOverflow()  : Carbon
addMonths()  : Carbon
addMonthsNoOverflow()  : Carbon
addMonthsWithNoOverflow()  : Carbon
addMonthsWithoutOverflow()  : Carbon
addMonthsWithOverflow()  : Carbon
addMonthWithNoOverflow()  : Carbon
addMonthWithoutOverflow()  : Carbon
addMonthWithOverflow()  : Carbon
addQuarter()  : Carbon
addQuarterNoOverflow()  : Carbon
addQuarters()  : Carbon
addQuartersNoOverflow()  : Carbon
addQuartersWithNoOverflow()  : Carbon
addQuartersWithoutOverflow()  : Carbon
addQuartersWithOverflow()  : Carbon
addQuarterWithNoOverflow()  : Carbon
addQuarterWithoutOverflow()  : Carbon
addQuarterWithOverflow()  : Carbon
addRealCenturies()  : Carbon
addRealCentury()  : Carbon
addRealDay()  : Carbon
addRealDays()  : Carbon
addRealDecade()  : Carbon
addRealDecades()  : Carbon
addRealHour()  : Carbon
addRealHours()  : Carbon
addRealMicro()  : Carbon
addRealMicros()  : Carbon
addRealMicrosecond()  : Carbon
addRealMicroseconds()  : Carbon
addRealMillennia()  : Carbon
addRealMillennium()  : Carbon
addRealMilli()  : Carbon
addRealMillis()  : Carbon
addRealMillisecond()  : Carbon
addRealMilliseconds()  : Carbon
addRealMinute()  : Carbon
addRealMinutes()  : Carbon
addRealMonth()  : Carbon
addRealMonths()  : Carbon
addRealQuarter()  : Carbon
addRealQuarters()  : Carbon
addRealSecond()  : Carbon
addRealSeconds()  : Carbon
addRealWeek()  : Carbon
addRealWeeks()  : Carbon
addRealYear()  : Carbon
addRealYears()  : Carbon
addSecond()  : Carbon
addSeconds()  : Carbon
addUnitNoOverflow()  : static
Add any unit to a new value without overflowing current other unit given.
addWeek()  : Carbon
addWeekday()  : Carbon
addWeekdays()  : Carbon
addWeeks()  : Carbon
addYear()  : Carbon
addYearNoOverflow()  : Carbon
addYears()  : Carbon
addYearsNoOverflow()  : Carbon
addYearsWithNoOverflow()  : Carbon
addYearsWithoutOverflow()  : Carbon
addYearsWithOverflow()  : Carbon
addYearWithNoOverflow()  : Carbon
addYearWithoutOverflow()  : Carbon
addYearWithOverflow()  : Carbon
carbonize()  : static
Return the Carbon instance passed through, a now instance in the same timezone if null given or parse the input if string given.
ceilCenturies()  : Carbon
ceilCentury()  : Carbon
ceilDay()  : Carbon
ceilDays()  : Carbon
ceilDecade()  : Carbon
ceilDecades()  : Carbon
ceilHour()  : Carbon
ceilHours()  : Carbon
ceilMicrosecond()  : Carbon
ceilMicroseconds()  : Carbon
ceilMillennia()  : Carbon
ceilMillennium()  : Carbon
ceilMillisecond()  : Carbon
ceilMilliseconds()  : Carbon
ceilMinute()  : Carbon
ceilMinutes()  : Carbon
ceilMonth()  : Carbon
ceilMonths()  : Carbon
ceilQuarter()  : Carbon
ceilQuarters()  : Carbon
ceilSecond()  : Carbon
ceilSeconds()  : Carbon
ceilYear()  : Carbon
ceilYears()  : Carbon
centuriesUntil()  : CarbonPeriod
clone()  : static
copy()  : static
Get a copy of the instance.
createFromFormat()  : static|false
Create a Carbon instance from a specific format.
createFromImmutable()  : Carbon
day()  : Carbon
dayOfYear()  : static|int
Get/set the day of year.
days()  : Carbon
daysUntil()  : CarbonPeriod
decadesUntil()  : CarbonPeriod
floorCenturies()  : Carbon
floorCentury()  : Carbon
floorDay()  : Carbon
floorDays()  : Carbon
floorDecade()  : Carbon
floorDecades()  : Carbon
floorHour()  : Carbon
floorHours()  : Carbon
floorMicrosecond()  : Carbon
floorMicroseconds()  : Carbon
floorMillennia()  : Carbon
floorMillennium()  : Carbon
floorMillisecond()  : Carbon
floorMilliseconds()  : Carbon
floorMinute()  : Carbon
floorMinutes()  : Carbon
floorMonth()  : Carbon
floorMonths()  : Carbon
floorQuarter()  : Carbon
floorQuarters()  : Carbon
floorSecond()  : Carbon
floorSeconds()  : Carbon
floorYear()  : Carbon
floorYears()  : Carbon
formatLocalized()  : string
Format the instance with the current locale. You can set the current locale using setlocale() http://php.net/setlocale.
get()  : string|int|bool|DateTimeZone|null
Get a part of the Carbon object
getAltNumber()  : string
Returns the alternative number for a given date property if available in the current locale.
getCalendarFormats()  : array<string|int, mixed>
Returns list of calendar formats for ISO formatting.
getDays()  : array<string|int, mixed>
Get the days of the week
getFormatsToIsoReplacements()  : array<string|int, mixed>
List of replacements from date() format to isoFormat().
getIsoFormats()  : array<string|int, mixed>
Returns list of locale formats for ISO formatting.
getIsoUnits()  : array<string|int, mixed>
Returns list of locale units for ISO formatting.
getOffsetString()  : string
Returns the offset hour and minute formatted with +/- and a given separator (":" by default).
getPaddedUnit()  : string
Returns a unit of the instance padded with 0 by default or any other string if specified.
getTimezone()  : CarbonTimeZone
Get the TimeZone associated with the Carbon instance (as CarbonTimeZone).
getTranslatedDayName()  : string
Get the translation of the current week day name (with context for languages with multiple forms).
getTranslatedMinDayName()  : string
Get the translation of the current abbreviated week day name (with context for languages with multiple forms).
getTranslatedMonthName()  : string
Get the translation of the current month day name (with context for languages with multiple forms).
getTranslatedShortDayName()  : string
Get the translation of the current short week day name (with context for languages with multiple forms).
getTranslatedShortMonthName()  : string
Get the translation of the current short month day name (with context for languages with multiple forms).
getWeekendDays()  : array<string|int, mixed>
Get weekend days
getWeekEndsAt()  : int
Get the last day of week
getWeekStartsAt()  : int
Get the first day of week
hasRelativeKeywords()  : bool
Determine if a time string will produce a relative date.
hour()  : Carbon
hours()  : Carbon
hoursUntil()  : CarbonPeriod
isCurrentCentury()  : bool
isCurrentDay()  : bool
isCurrentDecade()  : bool
isCurrentHour()  : bool
isCurrentMicro()  : bool
isCurrentMicrosecond()  : bool
isCurrentMillennium()  : bool
isCurrentMinute()  : bool
isCurrentMonth()  : bool
isCurrentQuarter()  : bool
isCurrentSecond()  : bool
isCurrentWeek()  : bool
isCurrentYear()  : bool
isDST()  : bool
isFriday()  : bool
isLastCentury()  : bool
isLastDay()  : bool
isLastDecade()  : bool
isLastHour()  : bool
isLastMicro()  : bool
isLastMicrosecond()  : bool
isLastMillennium()  : bool
isLastMinute()  : bool
isLastMonth()  : bool
isLastQuarter()  : bool
isLastSecond()  : bool
isLastWeek()  : bool
isLastYear()  : bool
isLocal()  : bool
isMonday()  : bool
isMutable()  : bool
Returns true if the current class/instance is mutable.
isNextCentury()  : bool
isNextDay()  : bool
isNextDecade()  : bool
isNextHour()  : bool
isNextMicro()  : bool
isNextMicrosecond()  : bool
isNextMillennium()  : bool
isNextMinute()  : bool
isNextMonth()  : bool
isNextQuarter()  : bool
isNextSecond()  : bool
isNextWeek()  : bool
isNextYear()  : bool
isoFormat()  : string
Format in the current language using ISO replacement patterns.
isoWeekday()  : static|int
Get/set the ISO weekday from 1 (Monday) to 7 (Sunday).
isSameCentury()  : bool
isSameDay()  : bool
isSameDecade()  : bool
isSameHour()  : bool
isSameMicro()  : bool
isSameMicrosecond()  : bool
isSameMillennium()  : bool
isSameMinute()  : bool
isSameSecond()  : bool
isSameWeek()  : bool
isSameYear()  : bool
isSaturday()  : bool
isSunday()  : bool
isThursday()  : bool
isTuesday()  : bool
isUtc()  : bool
isValid()  : bool
isWednesday()  : bool
longAbsoluteDiffForHumans()  : string
longRelativeDiffForHumans()  : string
longRelativeToNowDiffForHumans()  : string
longRelativeToOtherDiffForHumans()  : string
meridiem()  : string
Return the meridiem of the current time in the current locale.
micro()  : Carbon
micros()  : Carbon
microsecond()  : Carbon
microseconds()  : Carbon
microsecondsUntil()  : CarbonPeriod
microsUntil()  : CarbonPeriod
millenniaUntil()  : CarbonPeriod
milli()  : Carbon
millis()  : Carbon
millisecond()  : Carbon
milliseconds()  : Carbon
millisecondsUntil()  : CarbonPeriod
millisUntil()  : CarbonPeriod
minute()  : Carbon
minutes()  : Carbon
minutesUntil()  : CarbonPeriod
month()  : Carbon
months()  : Carbon
monthsUntil()  : CarbonPeriod
nowWithSameTz()  : static
Returns a present instance in the same timezone.
ordinal()  : string
Return a property with its ordinal.
pluralUnit()  : string
Returns standardized plural of a given singular/plural unit name (in English).
quartersUntil()  : CarbonPeriod
roundCenturies()  : Carbon
roundCentury()  : Carbon
roundDay()  : Carbon
roundDays()  : Carbon
roundDecade()  : Carbon
roundDecades()  : Carbon
roundHour()  : Carbon
roundHours()  : Carbon
roundMicrosecond()  : Carbon
roundMicroseconds()  : Carbon
roundMillennia()  : Carbon
roundMillennium()  : Carbon
roundMillisecond()  : Carbon
roundMilliseconds()  : Carbon
roundMinute()  : Carbon
roundMinutes()  : Carbon
roundMonth()  : Carbon
roundMonths()  : Carbon
roundQuarter()  : Carbon
roundQuarters()  : Carbon
roundSecond()  : Carbon
roundSeconds()  : Carbon
roundYear()  : Carbon
roundYears()  : Carbon
second()  : Carbon
seconds()  : Carbon
secondsUntil()  : CarbonPeriod
set()  : $this
Set a part of the Carbon object
setDate()  : static
Set the date with gregorian year, month and day numbers.
setDateFrom()  : static
Set the year, month, and date for this instance to that of the passed instance.
setDateTime()  : static
Set the date and time all together.
setDateTimeFrom()  : static
Set the date and time for this instance to that of the passed instance.
setDay()  : Carbon
setDays()  : Carbon
setHour()  : Carbon
setHours()  : Carbon
setISODate()  : static
Set a date according to the ISO 8601 standard - using weeks and day offsets rather than specific dates.
setMicro()  : Carbon
setMicros()  : Carbon
setMicrosecond()  : Carbon
setMicroseconds()  : Carbon
setMilli()  : Carbon
setMillis()  : Carbon
setMillisecond()  : Carbon
setMilliseconds()  : Carbon
setMinute()  : Carbon
setMinutes()  : Carbon
setMonth()  : Carbon
setMonths()  : Carbon
setSecond()  : Carbon
setSeconds()  : Carbon
setTime()  : static
Resets the current time of the DateTime object to a different time.
setTimeFrom()  : static
Set the hour, minute, second and microseconds for this instance to that of the passed instance.
setTimeFromTimeString()  : static
Set the time by time string.
setTimestamp()  : static
Sets the date and time based on an Unix timestamp.
setTimezone()  : static
Set the instance's timezone from a string or object.
setUnit()  : static
Set specified unit to new given value.
setUnitNoOverflow()  : static
Set any unit to a new value without overflowing current other unit given.
setUtf8()  : mixed
setWeekendDays()  : void
setWeekEndsAt()  : void
setWeekStartsAt()  : void
setYear()  : Carbon
setYears()  : Carbon
shiftTimezone()  : static
Set the instance's timezone from a string or object and add/subtract the offset difference.
shortAbsoluteDiffForHumans()  : string
shortRelativeDiffForHumans()  : string
shortRelativeToNowDiffForHumans()  : string
shortRelativeToOtherDiffForHumans()  : string
singularUnit()  : string
Returns standardized singular of a given singular/plural unit name (in English).
subCenturies()  : Carbon
subCenturiesNoOverflow()  : Carbon
subCenturiesWithNoOverflow()  : Carbon
subCenturiesWithoutOverflow()  : Carbon
subCenturiesWithOverflow()  : Carbon
subCentury()  : Carbon
subCenturyNoOverflow()  : Carbon
subCenturyWithNoOverflow()  : Carbon
subCenturyWithoutOverflow()  : Carbon
subCenturyWithOverflow()  : Carbon
subDay()  : Carbon
subDays()  : Carbon
subDecade()  : Carbon
subDecadeNoOverflow()  : Carbon
subDecades()  : Carbon
subDecadesNoOverflow()  : Carbon
subDecadesWithNoOverflow()  : Carbon
subDecadesWithoutOverflow()  : Carbon
subDecadesWithOverflow()  : Carbon
subDecadeWithNoOverflow()  : Carbon
subDecadeWithoutOverflow()  : Carbon
subDecadeWithOverflow()  : Carbon
subHour()  : Carbon
subHours()  : Carbon
subMicro()  : Carbon
subMicros()  : Carbon
subMicrosecond()  : Carbon
subMicroseconds()  : Carbon
subMillennia()  : Carbon
subMillenniaNoOverflow()  : Carbon
subMillenniaWithNoOverflow()  : Carbon
subMillenniaWithoutOverflow()  : Carbon
subMillenniaWithOverflow()  : Carbon
subMillennium()  : Carbon
subMillenniumNoOverflow()  : Carbon
subMillenniumWithNoOverflow()  : Carbon
subMillenniumWithoutOverflow()  : Carbon
subMillenniumWithOverflow()  : Carbon
subMilli()  : Carbon
subMillis()  : Carbon
subMillisecond()  : Carbon
subMilliseconds()  : Carbon
subMinute()  : Carbon
subMinutes()  : Carbon
subMonth()  : Carbon
subMonthNoOverflow()  : Carbon
subMonths()  : Carbon
subMonthsNoOverflow()  : Carbon
subMonthsWithNoOverflow()  : Carbon
subMonthsWithoutOverflow()  : Carbon
subMonthsWithOverflow()  : Carbon
subMonthWithNoOverflow()  : Carbon
subMonthWithoutOverflow()  : Carbon
subMonthWithOverflow()  : Carbon
subQuarter()  : Carbon
subQuarterNoOverflow()  : Carbon
subQuarters()  : Carbon
subQuartersNoOverflow()  : Carbon
subQuartersWithNoOverflow()  : Carbon
subQuartersWithoutOverflow()  : Carbon
subQuartersWithOverflow()  : Carbon
subQuarterWithNoOverflow()  : Carbon
subQuarterWithoutOverflow()  : Carbon
subQuarterWithOverflow()  : Carbon
subRealCenturies()  : Carbon
subRealCentury()  : Carbon
subRealDay()  : Carbon
subRealDays()  : Carbon
subRealDecade()  : Carbon
subRealDecades()  : Carbon
subRealHour()  : Carbon
subRealHours()  : Carbon
subRealMicro()  : Carbon
subRealMicros()  : Carbon
subRealMicrosecond()  : Carbon
subRealMicroseconds()  : Carbon
subRealMillennia()  : Carbon
subRealMillennium()  : Carbon
subRealMilli()  : Carbon
subRealMillis()  : Carbon
subRealMillisecond()  : Carbon
subRealMilliseconds()  : Carbon
subRealMinute()  : Carbon
subRealMinutes()  : Carbon
subRealMonth()  : Carbon
subRealMonths()  : Carbon
subRealQuarter()  : Carbon
subRealQuarters()  : Carbon
subRealSecond()  : Carbon
subRealSeconds()  : Carbon
subRealWeek()  : Carbon
subRealWeeks()  : Carbon
subRealYear()  : Carbon
subRealYears()  : Carbon
subSecond()  : Carbon
subSeconds()  : Carbon
subUnitNoOverflow()  : static
Subtract any unit to a new value without overflowing current other unit given.
subWeek()  : Carbon
subWeekday()  : Carbon
subWeekdays()  : Carbon
subWeeks()  : Carbon
subYear()  : Carbon
subYearNoOverflow()  : Carbon
subYears()  : Carbon
subYearsNoOverflow()  : Carbon
subYearsWithNoOverflow()  : Carbon
subYearsWithoutOverflow()  : Carbon
subYearsWithOverflow()  : Carbon
subYearWithNoOverflow()  : Carbon
subYearWithoutOverflow()  : Carbon
subYearWithOverflow()  : Carbon
timezone()  : static
translatedFormat()  : string
Format as ->format() do (using date replacements patterns from http://php.net/manual/fr/function.date.php) but translate words whenever possible (months, day names, etc.) using the current locale.
tz()  : static|string
Set the timezone or returns the timezone name if no arguments passed.
utc()  : static
Set the instance's timezone to UTC.
utcOffset()  : int|static
Returns the minutes offset to UTC if no arguments passed, else set the timezone with given minutes shift passed.
weekday()  : static|int
Get/set the weekday from 0 (Sunday) to 6 (Saturday).
weeksUntil()  : CarbonPeriod
year()  : Carbon
years()  : Carbon
yearsUntil()  : CarbonPeriod
executeCallable()  : mixed
executeCallableWithContext()  : mixed
executeStaticCallable()  : mixed
expectDateTime()  : mixed
Throws an exception if the given object is not a DateTime and does not implement DateTimeInterface.
getGenericMacros()  : mixed
getRangesByUnit()  : array<string|int, mixed>
List of minimum and maximums for each unit.
getTranslatedFormByRegExp()  : mixed
resolveCarbon()  : static
Return the Carbon instance passed through, a now instance in the same timezone if null given or parse the input if string given.
safeCreateDateTimeZone()  : CarbonTimeZone|false
Creates a DateTimeZone from a string, DateTimeZone or integer offset.

Properties

$age

public int $age

does a diffInYears() with default parameters

$century read-only

public int $century

the century of this instance

$dayName read-only

public string $dayName

long name of weekday translated according to Carbon locale, in english if no translation available for current language

$dayOfWeek read-only

public int $dayOfWeek

0 (for Sunday) through 6 (for Saturday)

$dayOfWeekIso read-only

public int $dayOfWeekIso

1 (for Monday) through 7 (for Sunday)

$dayOfYear

public int $dayOfYear

1 through 366

$daysInMonth read-only

public int $daysInMonth

number of days in the given month

$daysInYear read-only

public int $daysInYear

365 or 366

$decade read-only

public int $decade

the decade of this instance

$dst read-only

public bool $dst

daylight savings time indicator, true if DST, false otherwise

$englishDayOfWeek

public string $englishDayOfWeek

the day of week in English

$englishMonth

public string $englishMonth

the month in English

$firstWeekDay read-only

public int $firstWeekDay

0 through 6

$isoWeek

public int $isoWeek

1 through 53

$isoWeeksInYear read-only

public int $isoWeeksInYear

51 through 53

$isoWeekYear

public int $isoWeekYear

year according to ISO week format

$lastWeekDay read-only

public int $lastWeekDay

0 through 6

$latinMeridiem read-only

public string $latinMeridiem

"am"/"pm" (Ante meridiem or Post meridiem latin lowercase mark)

$latinUpperMeridiem read-only

public string $latinUpperMeridiem

"AM"/"PM" (Ante meridiem or Post meridiem latin uppercase mark)

$local read-only

public bool $local

checks if the timezone is local, true if local, false otherwise

$locale read-only

public string $locale

locale of the current instance

$localeDayOfWeek

public string $localeDayOfWeek

the day of week in current locale LC_TIME

$localeMonth

public string $localeMonth

the month in current locale LC_TIME

$meridiem read-only

public string $meridiem

lowercase meridiem mark translated according to Carbon locale, in latin if no translation available for current language

$microsecond

public int $microsecond

$millennium read-only

public int $millennium

the millennium of this instance

$millisecond

public int $millisecond

$milliseconds

public int $milliseconds

$minDayName read-only

public string $minDayName

very short name of weekday translated according to Carbon locale, in english if no translation available for current language

$monthName read-only

public string $monthName

long name of month translated according to Carbon locale, in english if no translation available for current language

$noZeroHour read-only

public int $noZeroHour

current hour from 1 to 24

$offset

public int $offset

the timezone offset in seconds from UTC

$offsetHours

public int $offsetHours

the timezone offset in hours from UTC

$offsetMinutes

public int $offsetMinutes

the timezone offset in minutes from UTC

$quarter read-only

public int $quarter

the quarter of this instance, 1 - 4

$shortDayName read-only

public string $shortDayName

short name of weekday translated according to Carbon locale, in english if no translation available for current language

$shortEnglishDayOfWeek

public string $shortEnglishDayOfWeek

the abbreviated day of week in English

$shortEnglishMonth

public string $shortEnglishMonth

the abbreviated month in English

$shortLocaleDayOfWeek

public string $shortLocaleDayOfWeek

the abbreviated day of week in current locale LC_TIME

$shortLocaleMonth

public string $shortLocaleMonth

the abbreviated month in current locale LC_TIME

$shortMonthName read-only

public string $shortMonthName

short name of month translated according to Carbon locale, in english if no translation available for current language

$timestamp

public int $timestamp

seconds since the Unix Epoch

$timezoneAbbreviatedName read-only

public string $timezoneAbbreviatedName

the current timezone abbreviated name

$timezoneName read-only

public string $timezoneName

the current timezone name

$tzAbbrName read-only

public string $tzAbbrName

alias of $timezoneAbbreviatedName

$tzName read-only

public string $tzName

alias of $timezoneName

$upperMeridiem read-only

public string $upperMeridiem

uppercase meridiem mark translated according to Carbon locale, in latin if no translation available for current language

$utc read-only

public bool $utc

checks if the timezone is UTC, true if UTC, false otherwise

$week

public int $week

1 through 53

$weekNumberInMonth read-only

public int $weekNumberInMonth

1 through 5

$weekOfMonth read-only

public int $weekOfMonth

1 through 5

$weekOfYear read-only

public int $weekOfYear

ISO-8601 week number of year, weeks starting on Monday

$weeksInYear read-only

public int $weeksInYear

51 through 53

$weekYear

public int $weekYear

year according to week format

$days

Names of days of the week.

protected static array<string|int, mixed> $days = [ // @call isDayOfWeek \Carbon\CarbonInterface::SUNDAY => 'Sunday', // @call isDayOfWeek \Carbon\CarbonInterface::MONDAY => 'Monday', // @call isDayOfWeek \Carbon\CarbonInterface::TUESDAY => 'Tuesday', // @call isDayOfWeek \Carbon\CarbonInterface::WEDNESDAY => 'Wednesday', // @call isDayOfWeek \Carbon\CarbonInterface::THURSDAY => 'Thursday', // @call isDayOfWeek \Carbon\CarbonInterface::FRIDAY => 'Friday', // @call isDayOfWeek \Carbon\CarbonInterface::SATURDAY => 'Saturday', ]

$units

List of unit and magic methods associated as doc-comments.

protected static array<string|int, mixed> $units = [ // @call setUnit // @call addUnit 'year', // @call setUnit // @call addUnit 'month', // @call setUnit // @call addUnit 'day', // @call setUnit // @call addUnit 'hour', // @call setUnit // @call addUnit 'minute', // @call setUnit // @call addUnit 'second', // @call setUnit // @call addUnit 'milli', // @call setUnit // @call addUnit 'millisecond', // @call setUnit // @call addUnit 'micro', // @call setUnit // @call addUnit 'microsecond', ]

$utf8

Will UTF8 encoding be used to print localized date/time ?

protected static bool $utf8 = false

Methods

__call()

Dynamically handle calls to the class.

public __call(string $method, array<string|int, mixed> $parameters) : mixed
Parameters
$method : string

magic method name called

$parameters : array<string|int, mixed>

parameters list

Tags
throws
UnknownMethodException|BadMethodCallException|ReflectionException|Throwable
Return values
mixed —

__callStatic()

Dynamically handle calls to the class.

public static __callStatic(string $method, array<string|int, mixed> $parameters) : mixed
Parameters
$method : string

magic method name called

$parameters : array<string|int, mixed>

parameters list

Tags
throws
BadMethodCallException
Return values
mixed —

__get()

Get a part of the Carbon object

public __get(string $name) : string|int|bool|DateTimeZone|null
Parameters
$name : string
Tags
throws
UnknownGetterException
Return values
string|int|bool|DateTimeZone|null —

__isset()

Check if an attribute exists on the object

public __isset(string $name) : bool
Parameters
$name : string
Return values
bool —

__set()

Set a part of the Carbon object

public __set(string $name, string|int|DateTimeZone $value) : void
Parameters
$name : string
$value : string|int|DateTimeZone
Tags
throws
UnknownSetterException|ReflectionException
Return values
void —

__set_state()

The __set_state handler.

public static __set_state(array<string|int, mixed> $array) : static

https://php.net/manual/en/datetime.set-state.php

Parameters
$array : array<string|int, mixed>
Return values
static —

addCenturies()

public addCenturies(int $value = 1) : Carbon

Add centuries (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addCenturiesNoOverflow()

public addCenturiesNoOverflow(int $value = 1) : Carbon

Add centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addCenturiesWithNoOverflow()

public addCenturiesWithNoOverflow(int $value = 1) : Carbon

Add centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addCenturiesWithoutOverflow()

public addCenturiesWithoutOverflow(int $value = 1) : Carbon

Add centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addCenturiesWithOverflow()

public addCenturiesWithOverflow(int $value = 1) : Carbon

Add centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.

Parameters
$value = 1 : int
Return values
Carbon —

addCentury()

public addCentury() : Carbon

Add one century to the instance (using date interval).

Return values
Carbon —

addCenturyNoOverflow()

public addCenturyNoOverflow() : Carbon

Add one century to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addCenturyWithNoOverflow()

public addCenturyWithNoOverflow() : Carbon

Add one century to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addCenturyWithoutOverflow()

public addCenturyWithoutOverflow() : Carbon

Add one century to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addCenturyWithOverflow()

public addCenturyWithOverflow() : Carbon

Add one century to the instance (using date interval) with overflow explicitly allowed.

Return values
Carbon —

addDay()

public addDay() : Carbon

Add one day to the instance (using date interval).

Return values
Carbon —

addDays()

public addDays(int $value = 1) : Carbon

Add days (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addDecade()

public addDecade() : Carbon

Add one decade to the instance (using date interval).

Return values
Carbon —

addDecadeNoOverflow()

public addDecadeNoOverflow() : Carbon

Add one decade to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addDecades()

public addDecades(int $value = 1) : Carbon

Add decades (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addDecadesNoOverflow()

public addDecadesNoOverflow(int $value = 1) : Carbon

Add decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addDecadesWithNoOverflow()

public addDecadesWithNoOverflow(int $value = 1) : Carbon

Add decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addDecadesWithoutOverflow()

public addDecadesWithoutOverflow(int $value = 1) : Carbon

Add decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addDecadesWithOverflow()

public addDecadesWithOverflow(int $value = 1) : Carbon

Add decades (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.

Parameters
$value = 1 : int
Return values
Carbon —

addDecadeWithNoOverflow()

public addDecadeWithNoOverflow() : Carbon

Add one decade to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addDecadeWithoutOverflow()

public addDecadeWithoutOverflow() : Carbon

Add one decade to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addDecadeWithOverflow()

public addDecadeWithOverflow() : Carbon

Add one decade to the instance (using date interval) with overflow explicitly allowed.

Return values
Carbon —

addHour()

public addHour() : Carbon

Add one hour to the instance (using date interval).

Return values
Carbon —

addHours()

public addHours(int $value = 1) : Carbon

Add hours (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addMicro()

public addMicro() : Carbon

Add one microsecond to the instance (using date interval).

Return values
Carbon —

addMicros()

public addMicros(int $value = 1) : Carbon

Add microseconds (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addMicrosecond()

public addMicrosecond() : Carbon

Add one microsecond to the instance (using date interval).

Return values
Carbon —

addMicroseconds()

public addMicroseconds(int $value = 1) : Carbon

Add microseconds (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addMillennia()

public addMillennia(int $value = 1) : Carbon

Add millennia (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addMillenniaNoOverflow()

public addMillenniaNoOverflow(int $value = 1) : Carbon

Add millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addMillenniaWithNoOverflow()

public addMillenniaWithNoOverflow(int $value = 1) : Carbon

Add millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addMillenniaWithoutOverflow()

public addMillenniaWithoutOverflow(int $value = 1) : Carbon

Add millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addMillenniaWithOverflow()

public addMillenniaWithOverflow(int $value = 1) : Carbon

Add millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.

Parameters
$value = 1 : int
Return values
Carbon —

addMillennium()

public addMillennium() : Carbon

Add one millennium to the instance (using date interval).

Return values
Carbon —

addMillenniumNoOverflow()

public addMillenniumNoOverflow() : Carbon

Add one millennium to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addMillenniumWithNoOverflow()

public addMillenniumWithNoOverflow() : Carbon

Add one millennium to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addMillenniumWithoutOverflow()

public addMillenniumWithoutOverflow() : Carbon

Add one millennium to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addMillenniumWithOverflow()

public addMillenniumWithOverflow() : Carbon

Add one millennium to the instance (using date interval) with overflow explicitly allowed.

Return values
Carbon —

addMilli()

public addMilli() : Carbon

Add one millisecond to the instance (using date interval).

Return values
Carbon —

addMillis()

public addMillis(int $value = 1) : Carbon

Add milliseconds (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addMillisecond()

public addMillisecond() : Carbon

Add one millisecond to the instance (using date interval).

Return values
Carbon —

addMilliseconds()

public addMilliseconds(int $value = 1) : Carbon

Add milliseconds (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addMinute()

public addMinute() : Carbon

Add one minute to the instance (using date interval).

Return values
Carbon —

addMinutes()

public addMinutes(int $value = 1) : Carbon

Add minutes (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addMonth()

public addMonth() : Carbon

Add one month to the instance (using date interval).

Return values
Carbon —

addMonthNoOverflow()

public addMonthNoOverflow() : Carbon

Add one month to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addMonths()

public addMonths(int $value = 1) : Carbon

Add months (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addMonthsNoOverflow()

public addMonthsNoOverflow(int $value = 1) : Carbon

Add months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addMonthsWithNoOverflow()

public addMonthsWithNoOverflow(int $value = 1) : Carbon

Add months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addMonthsWithoutOverflow()

public addMonthsWithoutOverflow(int $value = 1) : Carbon

Add months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addMonthsWithOverflow()

public addMonthsWithOverflow(int $value = 1) : Carbon

Add months (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.

Parameters
$value = 1 : int
Return values
Carbon —

addMonthWithNoOverflow()

public addMonthWithNoOverflow() : Carbon

Add one month to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addMonthWithoutOverflow()

public addMonthWithoutOverflow() : Carbon

Add one month to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addMonthWithOverflow()

public addMonthWithOverflow() : Carbon

Add one month to the instance (using date interval) with overflow explicitly allowed.

Return values
Carbon —

addQuarter()

public addQuarter() : Carbon

Add one quarter to the instance (using date interval).

Return values
Carbon —

addQuarterNoOverflow()

public addQuarterNoOverflow() : Carbon

Add one quarter to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addQuarters()

public addQuarters(int $value = 1) : Carbon

Add quarters (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addQuartersNoOverflow()

public addQuartersNoOverflow(int $value = 1) : Carbon

Add quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addQuartersWithNoOverflow()

public addQuartersWithNoOverflow(int $value = 1) : Carbon

Add quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addQuartersWithoutOverflow()

public addQuartersWithoutOverflow(int $value = 1) : Carbon

Add quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addQuartersWithOverflow()

public addQuartersWithOverflow(int $value = 1) : Carbon

Add quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.

Parameters
$value = 1 : int
Return values
Carbon —

addQuarterWithNoOverflow()

public addQuarterWithNoOverflow() : Carbon

Add one quarter to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addQuarterWithoutOverflow()

public addQuarterWithoutOverflow() : Carbon

Add one quarter to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addQuarterWithOverflow()

public addQuarterWithOverflow() : Carbon

Add one quarter to the instance (using date interval) with overflow explicitly allowed.

Return values
Carbon —

addRealCenturies()

public addRealCenturies(int $value = 1) : Carbon

Add centuries (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealCentury()

public addRealCentury() : Carbon

Add one century to the instance (using timestamp).

Return values
Carbon —

addRealDay()

public addRealDay() : Carbon

Add one day to the instance (using timestamp).

Return values
Carbon —

addRealDays()

public addRealDays(int $value = 1) : Carbon

Add days (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealDecade()

public addRealDecade() : Carbon

Add one decade to the instance (using timestamp).

Return values
Carbon —

addRealDecades()

public addRealDecades(int $value = 1) : Carbon

Add decades (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealHour()

public addRealHour() : Carbon

Add one hour to the instance (using timestamp).

Return values
Carbon —

addRealHours()

public addRealHours(int $value = 1) : Carbon

Add hours (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealMicro()

public addRealMicro() : Carbon

Add one microsecond to the instance (using timestamp).

Return values
Carbon —

addRealMicros()

public addRealMicros(int $value = 1) : Carbon

Add microseconds (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealMicrosecond()

public addRealMicrosecond() : Carbon

Add one microsecond to the instance (using timestamp).

Return values
Carbon —

addRealMicroseconds()

public addRealMicroseconds(int $value = 1) : Carbon

Add microseconds (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealMillennia()

public addRealMillennia(int $value = 1) : Carbon

Add millennia (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealMillennium()

public addRealMillennium() : Carbon

Add one millennium to the instance (using timestamp).

Return values
Carbon —

addRealMilli()

public addRealMilli() : Carbon

Add one millisecond to the instance (using timestamp).

Return values
Carbon —

addRealMillis()

public addRealMillis(int $value = 1) : Carbon

Add milliseconds (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealMillisecond()

public addRealMillisecond() : Carbon

Add one millisecond to the instance (using timestamp).

Return values
Carbon —

addRealMilliseconds()

public addRealMilliseconds(int $value = 1) : Carbon

Add milliseconds (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealMinute()

public addRealMinute() : Carbon

Add one minute to the instance (using timestamp).

Return values
Carbon —

addRealMinutes()

public addRealMinutes(int $value = 1) : Carbon

Add minutes (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealMonth()

public addRealMonth() : Carbon

Add one month to the instance (using timestamp).

Return values
Carbon —

addRealMonths()

public addRealMonths(int $value = 1) : Carbon

Add months (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealQuarter()

public addRealQuarter() : Carbon

Add one quarter to the instance (using timestamp).

Return values
Carbon —

addRealQuarters()

public addRealQuarters(int $value = 1) : Carbon

Add quarters (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealSecond()

public addRealSecond() : Carbon

Add one second to the instance (using timestamp).

Return values
Carbon —

addRealSeconds()

public addRealSeconds(int $value = 1) : Carbon

Add seconds (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealWeek()

public addRealWeek() : Carbon

Add one week to the instance (using timestamp).

Return values
Carbon —

addRealWeeks()

public addRealWeeks(int $value = 1) : Carbon

Add weeks (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addRealYear()

public addRealYear() : Carbon

Add one year to the instance (using timestamp).

Return values
Carbon —

addRealYears()

public addRealYears(int $value = 1) : Carbon

Add years (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

addSecond()

public addSecond() : Carbon

Add one second to the instance (using date interval).

Return values
Carbon —

addSeconds()

public addSeconds(int $value = 1) : Carbon

Add seconds (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addUnitNoOverflow()

Add any unit to a new value without overflowing current other unit given.

public addUnitNoOverflow(string $valueUnit, int $value, string $overflowUnit) : static
Parameters
$valueUnit : string

unit name to modify

$value : int

amount to add to the input unit

$overflowUnit : string

unit name to not overflow

Return values
static —

addWeek()

public addWeek() : Carbon

Add one week to the instance (using date interval).

Return values
Carbon —

addWeekday()

public addWeekday() : Carbon

Add one weekday to the instance (using date interval).

Return values
Carbon —

addWeekdays()

public addWeekdays(int $value = 1) : Carbon

Add weekdays (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addWeeks()

public addWeeks(int $value = 1) : Carbon

Add weeks (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addYear()

public addYear() : Carbon

Add one year to the instance (using date interval).

Return values
Carbon —

addYearNoOverflow()

public addYearNoOverflow() : Carbon

Add one year to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addYears()

public addYears(int $value = 1) : Carbon

Add years (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

addYearsNoOverflow()

public addYearsNoOverflow(int $value = 1) : Carbon

Add years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addYearsWithNoOverflow()

public addYearsWithNoOverflow(int $value = 1) : Carbon

Add years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addYearsWithoutOverflow()

public addYearsWithoutOverflow(int $value = 1) : Carbon

Add years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

addYearsWithOverflow()

public addYearsWithOverflow(int $value = 1) : Carbon

Add years (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.

Parameters
$value = 1 : int
Return values
Carbon —

addYearWithNoOverflow()

public addYearWithNoOverflow() : Carbon

Add one year to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addYearWithoutOverflow()

public addYearWithoutOverflow() : Carbon

Add one year to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

addYearWithOverflow()

public addYearWithOverflow() : Carbon

Add one year to the instance (using date interval) with overflow explicitly allowed.

Return values
Carbon —

carbonize()

Return the Carbon instance passed through, a now instance in the same timezone if null given or parse the input if string given.

public carbonize([Carbon|CarbonPeriod|CarbonInterval|DateInterval|DatePeriod|DateTimeInterface|string|null $date = null ]) : static
Parameters
$date : Carbon|CarbonPeriod|CarbonInterval|DateInterval|DatePeriod|DateTimeInterface|string|null = null
Return values
static —

ceilCenturies()

public ceilCenturies(float $precision = 1) : Carbon

Ceil the current instance century with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilCentury()

public ceilCentury(float $precision = 1) : Carbon

Ceil the current instance century with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilDay()

public ceilDay(float $precision = 1) : Carbon

Ceil the current instance day with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilDays()

public ceilDays(float $precision = 1) : Carbon

Ceil the current instance day with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilDecade()

public ceilDecade(float $precision = 1) : Carbon

Ceil the current instance decade with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilDecades()

public ceilDecades(float $precision = 1) : Carbon

Ceil the current instance decade with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilHour()

public ceilHour(float $precision = 1) : Carbon

Ceil the current instance hour with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilHours()

public ceilHours(float $precision = 1) : Carbon

Ceil the current instance hour with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilMicrosecond()

public ceilMicrosecond(float $precision = 1) : Carbon

Ceil the current instance microsecond with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilMicroseconds()

public ceilMicroseconds(float $precision = 1) : Carbon

Ceil the current instance microsecond with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilMillennia()

public ceilMillennia(float $precision = 1) : Carbon

Ceil the current instance millennium with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilMillennium()

public ceilMillennium(float $precision = 1) : Carbon

Ceil the current instance millennium with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilMillisecond()

public ceilMillisecond(float $precision = 1) : Carbon

Ceil the current instance millisecond with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilMilliseconds()

public ceilMilliseconds(float $precision = 1) : Carbon

Ceil the current instance millisecond with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilMinute()

public ceilMinute(float $precision = 1) : Carbon

Ceil the current instance minute with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilMinutes()

public ceilMinutes(float $precision = 1) : Carbon

Ceil the current instance minute with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilMonth()

public ceilMonth(float $precision = 1) : Carbon

Ceil the current instance month with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilMonths()

public ceilMonths(float $precision = 1) : Carbon

Ceil the current instance month with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilQuarter()

public ceilQuarter(float $precision = 1) : Carbon

Ceil the current instance quarter with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilQuarters()

public ceilQuarters(float $precision = 1) : Carbon

Ceil the current instance quarter with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilSecond()

public ceilSecond(float $precision = 1) : Carbon

Ceil the current instance second with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilSeconds()

public ceilSeconds(float $precision = 1) : Carbon

Ceil the current instance second with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilYear()

public ceilYear(float $precision = 1) : Carbon

Ceil the current instance year with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

ceilYears()

public ceilYears(float $precision = 1) : Carbon

Ceil the current instance year with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

centuriesUntil()

public centuriesUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each century or every X centuries if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

clone()

public clone() : static
Tags
alias

copy

Get a copy of the instance.

Return values
static —

copy()

Get a copy of the instance.

public copy() : static
Return values
static —

createFromFormat()

Create a Carbon instance from a specific format.

public static createFromFormat(string $format, string $time, string|DateTimeZone $timezone = null) : static|false

Parse a string into a new Carbon object according to the specified format.

Parameters
$format : string

Datetime format

$time : string
$timezone = null : string|DateTimeZone
Return values
static|false —

createFromImmutable()

public static createFromImmutable(DateTimeImmutable $dateTime) : Carbon

Create a new Carbon object from an immutable date.

Parameters
$dateTime : DateTimeImmutable
Return values
Carbon —

day()

public day(int $value) : Carbon

Set current instance day to the given value.

Parameters
$value : int
Return values
Carbon —

dayOfYear()

Get/set the day of year.

public dayOfYear([int|null $value = null ]) : static|int
Parameters
$value : int|null = null

new value for day of year if using as setter.

Return values
static|int —

days()

public days(int $value) : Carbon

Set current instance day to the given value.

Parameters
$value : int
Return values
Carbon —

daysUntil()

public daysUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each day or every X days if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

decadesUntil()

public decadesUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each decade or every X decades if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

floorCenturies()

public floorCenturies(float $precision = 1) : Carbon

Truncate the current instance century with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorCentury()

public floorCentury(float $precision = 1) : Carbon

Truncate the current instance century with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorDay()

public floorDay(float $precision = 1) : Carbon

Truncate the current instance day with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorDays()

public floorDays(float $precision = 1) : Carbon

Truncate the current instance day with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorDecade()

public floorDecade(float $precision = 1) : Carbon

Truncate the current instance decade with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorDecades()

public floorDecades(float $precision = 1) : Carbon

Truncate the current instance decade with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorHour()

public floorHour(float $precision = 1) : Carbon

Truncate the current instance hour with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorHours()

public floorHours(float $precision = 1) : Carbon

Truncate the current instance hour with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorMicrosecond()

public floorMicrosecond(float $precision = 1) : Carbon

Truncate the current instance microsecond with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorMicroseconds()

public floorMicroseconds(float $precision = 1) : Carbon

Truncate the current instance microsecond with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorMillennia()

public floorMillennia(float $precision = 1) : Carbon

Truncate the current instance millennium with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorMillennium()

public floorMillennium(float $precision = 1) : Carbon

Truncate the current instance millennium with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorMillisecond()

public floorMillisecond(float $precision = 1) : Carbon

Truncate the current instance millisecond with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorMilliseconds()

public floorMilliseconds(float $precision = 1) : Carbon

Truncate the current instance millisecond with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorMinute()

public floorMinute(float $precision = 1) : Carbon

Truncate the current instance minute with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorMinutes()

public floorMinutes(float $precision = 1) : Carbon

Truncate the current instance minute with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorMonth()

public floorMonth(float $precision = 1) : Carbon

Truncate the current instance month with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorMonths()

public floorMonths(float $precision = 1) : Carbon

Truncate the current instance month with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorQuarter()

public floorQuarter(float $precision = 1) : Carbon

Truncate the current instance quarter with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorQuarters()

public floorQuarters(float $precision = 1) : Carbon

Truncate the current instance quarter with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorSecond()

public floorSecond(float $precision = 1) : Carbon

Truncate the current instance second with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorSeconds()

public floorSeconds(float $precision = 1) : Carbon

Truncate the current instance second with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorYear()

public floorYear(float $precision = 1) : Carbon

Truncate the current instance year with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

floorYears()

public floorYears(float $precision = 1) : Carbon

Truncate the current instance year with given precision.

Parameters
$precision = 1 : float
Return values
Carbon —

formatLocalized()

Format the instance with the current locale. You can set the current locale using setlocale() http://php.net/setlocale.

public formatLocalized(string $format) : string
Parameters
$format : string
Return values
string —

get()

Get a part of the Carbon object

public get(string $name) : string|int|bool|DateTimeZone|null
Parameters
$name : string
Tags
throws
UnknownGetterException
Return values
string|int|bool|DateTimeZone|null —

getAltNumber()

Returns the alternative number for a given date property if available in the current locale.

public getAltNumber(string $key) : string
Parameters
$key : string

date property

Return values
string —

getCalendarFormats()

Returns list of calendar formats for ISO formatting.

public getCalendarFormats([string|null $locale = null ]) : array<string|int, mixed>
Parameters
$locale : string|null = null

current locale used if null

Return values
array<string|int, mixed> —

getDays()

Get the days of the week

public static getDays() : array<string|int, mixed>
Return values
array<string|int, mixed> —

getFormatsToIsoReplacements()

List of replacements from date() format to isoFormat().

public static getFormatsToIsoReplacements() : array<string|int, mixed>
Return values
array<string|int, mixed> —

getIsoFormats()

Returns list of locale formats for ISO formatting.

public getIsoFormats([string|null $locale = null ]) : array<string|int, mixed>
Parameters
$locale : string|null = null

current locale used if null

Return values
array<string|int, mixed> —

getIsoUnits()

Returns list of locale units for ISO formatting.

public static getIsoUnits() : array<string|int, mixed>
Return values
array<string|int, mixed> —

getOffsetString()

Returns the offset hour and minute formatted with +/- and a given separator (":" by default).

public getOffsetString([string $separator = ':' ]) : string

For example, if the time zone is 9 hours 30 minutes, you'll get "+09:30", with "@@" as first argument, "+09@@30", with "" as first argument, "+0930". Negative offset will return something like "-12:00".

Parameters
$separator : string = ':'

string to place between hours and minutes (":" by default)

Return values
string —

getPaddedUnit()

Returns a unit of the instance padded with 0 by default or any other string if specified.

public getPaddedUnit(string $unit[, int $length = 2 ][, string $padString = '0' ][, int $padType = STR_PAD_LEFT ]) : string
Parameters
$unit : string

Carbon unit name

$length : int = 2

Length of the output (2 by default)

$padString : string = '0'

String to use for padding ("0" by default)

$padType : int = STR_PAD_LEFT

Side(s) to pad (STR_PAD_LEFT by default)

Return values
string —

getTranslatedDayName()

Get the translation of the current week day name (with context for languages with multiple forms).

public getTranslatedDayName([string|null $context = null ][, string $keySuffix = '' ][, string|null $defaultValue = null ]) : string
Parameters
$context : string|null = null

whole format string

$keySuffix : string = ''

"", "_short" or "_min"

$defaultValue : string|null = null

default value if translation missing

Return values
string —

getTranslatedMinDayName()

Get the translation of the current abbreviated week day name (with context for languages with multiple forms).

public getTranslatedMinDayName([string|null $context = null ]) : string
Parameters
$context : string|null = null

whole format string

Return values
string —

getTranslatedMonthName()

Get the translation of the current month day name (with context for languages with multiple forms).

public getTranslatedMonthName([string|null $context = null ][, string $keySuffix = '' ][, string|null $defaultValue = null ]) : string
Parameters
$context : string|null = null

whole format string

$keySuffix : string = ''

"" or "_short"

$defaultValue : string|null = null

default value if translation missing

Return values
string —

getTranslatedShortDayName()

Get the translation of the current short week day name (with context for languages with multiple forms).

public getTranslatedShortDayName([string|null $context = null ]) : string
Parameters
$context : string|null = null

whole format string

Return values
string —

getTranslatedShortMonthName()

Get the translation of the current short month day name (with context for languages with multiple forms).

public getTranslatedShortMonthName([string|null $context = null ]) : string
Parameters
$context : string|null = null

whole format string

Return values
string —

getWeekendDays()

Get weekend days

public static getWeekendDays() : array<string|int, mixed>
Return values
array<string|int, mixed> —

getWeekEndsAt()

Get the last day of week

public static getWeekEndsAt() : int
Return values
int —

getWeekStartsAt()

Get the first day of week

public static getWeekStartsAt() : int
Return values
int —

hasRelativeKeywords()

Determine if a time string will produce a relative date.

public static hasRelativeKeywords(string $time) : bool
Parameters
$time : string
Return values
bool —

true if time match a relative date, false if absolute or invalid time string

hour()

public hour(int $value) : Carbon

Set current instance hour to the given value.

Parameters
$value : int
Return values
Carbon —

hours()

public hours(int $value) : Carbon

Set current instance hour to the given value.

Parameters
$value : int
Return values
Carbon —

hoursUntil()

public hoursUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each hour or every X hours if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

isCurrentCentury()

public isCurrentCentury() : bool

Checks if the instance is in the same century as the current moment.

Return values
bool —

isCurrentDay()

public isCurrentDay() : bool

Checks if the instance is in the same day as the current moment.

Return values
bool —

isCurrentDecade()

public isCurrentDecade() : bool

Checks if the instance is in the same decade as the current moment.

Return values
bool —

isCurrentHour()

public isCurrentHour() : bool

Checks if the instance is in the same hour as the current moment.

Return values
bool —

isCurrentMicro()

public isCurrentMicro() : bool

Checks if the instance is in the same microsecond as the current moment.

Return values
bool —

isCurrentMicrosecond()

public isCurrentMicrosecond() : bool

Checks if the instance is in the same microsecond as the current moment.

Return values
bool —

isCurrentMillennium()

public isCurrentMillennium() : bool

Checks if the instance is in the same millennium as the current moment.

Return values
bool —

isCurrentMinute()

public isCurrentMinute() : bool

Checks if the instance is in the same minute as the current moment.

Return values
bool —

isCurrentMonth()

public isCurrentMonth() : bool

Checks if the instance is in the same month as the current moment.

Return values
bool —

isCurrentQuarter()

public isCurrentQuarter() : bool

Checks if the instance is in the same quarter as the current moment.

Return values
bool —

isCurrentSecond()

public isCurrentSecond() : bool

Checks if the instance is in the same second as the current moment.

Return values
bool —

isCurrentWeek()

public isCurrentWeek() : bool

Checks if the instance is in the same week as the current moment.

Return values
bool —

isCurrentYear()

public isCurrentYear() : bool

Checks if the instance is in the same year as the current moment.

Return values
bool —

isDST()

public isDST() : bool

Check if the current instance is in a daylight saving time.

Return values
bool —

isFriday()

public isFriday() : bool

Checks if the instance day is friday.

Return values
bool —

isLastCentury()

public isLastCentury() : bool

Checks if the instance is in the same century as the current moment last century.

Return values
bool —

isLastDay()

public isLastDay() : bool

Checks if the instance is in the same day as the current moment last day.

Return values
bool —

isLastDecade()

public isLastDecade() : bool

Checks if the instance is in the same decade as the current moment last decade.

Return values
bool —

isLastHour()

public isLastHour() : bool

Checks if the instance is in the same hour as the current moment last hour.

Return values
bool —

isLastMicro()

public isLastMicro() : bool

Checks if the instance is in the same microsecond as the current moment last microsecond.

Return values
bool —

isLastMicrosecond()

public isLastMicrosecond() : bool

Checks if the instance is in the same microsecond as the current moment last microsecond.

Return values
bool —

isLastMillennium()

public isLastMillennium() : bool

Checks if the instance is in the same millennium as the current moment last millennium.

Return values
bool —

isLastMinute()

public isLastMinute() : bool

Checks if the instance is in the same minute as the current moment last minute.

Return values
bool —

isLastMonth()

public isLastMonth() : bool

Checks if the instance is in the same month as the current moment last month.

Return values
bool —

isLastQuarter()

public isLastQuarter() : bool

Checks if the instance is in the same quarter as the current moment last quarter.

Return values
bool —

isLastSecond()

public isLastSecond() : bool

Checks if the instance is in the same second as the current moment last second.

Return values
bool —

isLastWeek()

public isLastWeek() : bool

Checks if the instance is in the same week as the current moment last week.

Return values
bool —

isLastYear()

public isLastYear() : bool

Checks if the instance is in the same year as the current moment last year.

Return values
bool —

isLocal()

public isLocal() : bool

Check if the current instance has non-UTC timezone.

Return values
bool —

isMonday()

public isMonday() : bool

Checks if the instance day is monday.

Return values
bool —

isMutable()

Returns true if the current class/instance is mutable.

public static isMutable() : bool
Return values
bool —

isNextCentury()

public isNextCentury() : bool

Checks if the instance is in the same century as the current moment next century.

Return values
bool —

isNextDay()

public isNextDay() : bool

Checks if the instance is in the same day as the current moment next day.

Return values
bool —

isNextDecade()

public isNextDecade() : bool

Checks if the instance is in the same decade as the current moment next decade.

Return values
bool —

isNextHour()

public isNextHour() : bool

Checks if the instance is in the same hour as the current moment next hour.

Return values
bool —

isNextMicro()

public isNextMicro() : bool

Checks if the instance is in the same microsecond as the current moment next microsecond.

Return values
bool —

isNextMicrosecond()

public isNextMicrosecond() : bool

Checks if the instance is in the same microsecond as the current moment next microsecond.

Return values
bool —

isNextMillennium()

public isNextMillennium() : bool

Checks if the instance is in the same millennium as the current moment next millennium.

Return values
bool —

isNextMinute()

public isNextMinute() : bool

Checks if the instance is in the same minute as the current moment next minute.

Return values
bool —

isNextMonth()

public isNextMonth() : bool

Checks if the instance is in the same month as the current moment next month.

Return values
bool —

isNextQuarter()

public isNextQuarter() : bool

Checks if the instance is in the same quarter as the current moment next quarter.

Return values
bool —

isNextSecond()

public isNextSecond() : bool

Checks if the instance is in the same second as the current moment next second.

Return values
bool —

isNextWeek()

public isNextWeek() : bool

Checks if the instance is in the same week as the current moment next week.

Return values
bool —

isNextYear()

public isNextYear() : bool

Checks if the instance is in the same year as the current moment next year.

Return values
bool —

isoFormat()

Format in the current language using ISO replacement patterns.

public isoFormat(string $format[, string|null $originalFormat = null ]) : string
Parameters
$format : string
$originalFormat : string|null = null

provide context if a chunk has been passed alone

Return values
string —

isoWeekday()

Get/set the ISO weekday from 1 (Monday) to 7 (Sunday).

public isoWeekday([int|null $value = null ]) : static|int
Parameters
$value : int|null = null

new value for weekday if using as setter.

Return values
static|int —

isSameCentury()

public isSameCentury(Carbon|DateTimeInterface|string|null $date = null) : bool

Checks if the given date is in the same century as the instance. If null passed, compare to now (with the same timezone).

Parameters
$date = null : Carbon|DateTimeInterface|string|null
Return values
bool —

isSameDay()

public isSameDay(Carbon|DateTimeInterface|string|null $date = null) : bool

Checks if the given date is in the same day as the instance. If null passed, compare to now (with the same timezone).

Parameters
$date = null : Carbon|DateTimeInterface|string|null
Return values
bool —

isSameDecade()

public isSameDecade(Carbon|DateTimeInterface|string|null $date = null) : bool

Checks if the given date is in the same decade as the instance. If null passed, compare to now (with the same timezone).

Parameters
$date = null : Carbon|DateTimeInterface|string|null
Return values
bool —

isSameHour()

public isSameHour(Carbon|DateTimeInterface|string|null $date = null) : bool

Checks if the given date is in the same hour as the instance. If null passed, compare to now (with the same timezone).

Parameters
$date = null : Carbon|DateTimeInterface|string|null
Return values
bool —

isSameMicro()

public isSameMicro(Carbon|DateTimeInterface|string|null $date = null) : bool

Checks if the given date is in the same microsecond as the instance. If null passed, compare to now (with the same timezone).

Parameters
$date = null : Carbon|DateTimeInterface|string|null
Return values
bool —

isSameMicrosecond()

public isSameMicrosecond(Carbon|DateTimeInterface|string|null $date = null) : bool

Checks if the given date is in the same microsecond as the instance. If null passed, compare to now (with the same timezone).

Parameters
$date = null : Carbon|DateTimeInterface|string|null
Return values
bool —

isSameMillennium()

public isSameMillennium(Carbon|DateTimeInterface|string|null $date = null) : bool

Checks if the given date is in the same millennium as the instance. If null passed, compare to now (with the same timezone).

Parameters
$date = null : Carbon|DateTimeInterface|string|null
Return values
bool —

isSameMinute()

public isSameMinute(Carbon|DateTimeInterface|string|null $date = null) : bool

Checks if the given date is in the same minute as the instance. If null passed, compare to now (with the same timezone).

Parameters
$date = null : Carbon|DateTimeInterface|string|null
Return values
bool —

isSameSecond()

public isSameSecond(Carbon|DateTimeInterface|string|null $date = null) : bool

Checks if the given date is in the same second as the instance. If null passed, compare to now (with the same timezone).

Parameters
$date = null : Carbon|DateTimeInterface|string|null
Return values
bool —

isSameWeek()

public isSameWeek(Carbon|DateTimeInterface|string|null $date = null) : bool

Checks if the given date is in the same week as the instance. If null passed, compare to now (with the same timezone).

Parameters
$date = null : Carbon|DateTimeInterface|string|null
Return values
bool —

isSameYear()

public isSameYear(Carbon|DateTimeInterface|string|null $date = null) : bool

Checks if the given date is in the same year as the instance. If null passed, compare to now (with the same timezone).

Parameters
$date = null : Carbon|DateTimeInterface|string|null
Return values
bool —

isSaturday()

public isSaturday() : bool

Checks if the instance day is saturday.

Return values
bool —

isSunday()

public isSunday() : bool

Checks if the instance day is sunday.

Return values
bool —

isThursday()

public isThursday() : bool

Checks if the instance day is thursday.

Return values
bool —

isTuesday()

public isTuesday() : bool

Checks if the instance day is tuesday.

Return values
bool —

isUtc()

public isUtc() : bool

Check if the current instance has UTC timezone. (Both isUtc and isUTC cases are valid.)

Return values
bool —

isValid()

public isValid() : bool

Check if the current instance is a valid date.

Return values
bool —

isWednesday()

public isWednesday() : bool

Checks if the instance day is wednesday.

Return values
bool —

longAbsoluteDiffForHumans()

public longAbsoluteDiffForHumans(DateTimeInterface $other = null, int $parts = 1) : string

Get the difference (long format, 'Absolute' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)

Parameters
$other = null : DateTimeInterface
$parts = 1 : int
Return values
string —

longRelativeDiffForHumans()

public longRelativeDiffForHumans(DateTimeInterface $other = null, int $parts = 1) : string

Get the difference (long format, 'Relative' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)

Parameters
$other = null : DateTimeInterface
$parts = 1 : int
Return values
string —

longRelativeToNowDiffForHumans()

public longRelativeToNowDiffForHumans(DateTimeInterface $other = null, int $parts = 1) : string

Get the difference (long format, 'RelativeToNow' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)

Parameters
$other = null : DateTimeInterface
$parts = 1 : int
Return values
string —

longRelativeToOtherDiffForHumans()

public longRelativeToOtherDiffForHumans(DateTimeInterface $other = null, int $parts = 1) : string

Get the difference (long format, 'RelativeToOther' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)

Parameters
$other = null : DateTimeInterface
$parts = 1 : int
Return values
string —

meridiem()

Return the meridiem of the current time in the current locale.

public meridiem([bool $isLower = false ]) : string
Parameters
$isLower : bool = false

if true, returns lowercase variant if available in the current locale.

Return values
string —

micro()

public micro(int $value) : Carbon

Set current instance microsecond to the given value.

Parameters
$value : int
Return values
Carbon —

micros()

public micros(int $value) : Carbon

Set current instance microsecond to the given value.

Parameters
$value : int
Return values
Carbon —

microsecond()

public microsecond(int $value) : Carbon

Set current instance microsecond to the given value.

Parameters
$value : int
Return values
Carbon —

microseconds()

public microseconds(int $value) : Carbon

Set current instance microsecond to the given value.

Parameters
$value : int
Return values
Carbon —

microsecondsUntil()

public microsecondsUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each microsecond or every X microseconds if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

microsUntil()

public microsUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each microsecond or every X microseconds if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

millenniaUntil()

public millenniaUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each millennium or every X millennia if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

milli()

public milli(int $value) : Carbon

Set current instance millisecond to the given value.

Parameters
$value : int
Return values
Carbon —

millis()

public millis(int $value) : Carbon

Set current instance millisecond to the given value.

Parameters
$value : int
Return values
Carbon —

millisecond()

public millisecond(int $value) : Carbon

Set current instance millisecond to the given value.

Parameters
$value : int
Return values
Carbon —

milliseconds()

public milliseconds(int $value) : Carbon

Set current instance millisecond to the given value.

Parameters
$value : int
Return values
Carbon —

millisecondsUntil()

public millisecondsUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each millisecond or every X milliseconds if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

millisUntil()

public millisUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each millisecond or every X milliseconds if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

minute()

public minute(int $value) : Carbon

Set current instance minute to the given value.

Parameters
$value : int
Return values
Carbon —

minutes()

public minutes(int $value) : Carbon

Set current instance minute to the given value.

Parameters
$value : int
Return values
Carbon —

minutesUntil()

public minutesUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each minute or every X minutes if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

month()

public month(int $value) : Carbon

Set current instance month to the given value.

Parameters
$value : int
Return values
Carbon —

months()

public months(int $value) : Carbon

Set current instance month to the given value.

Parameters
$value : int
Return values
Carbon —

monthsUntil()

public monthsUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each month or every X months if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

nowWithSameTz()

Returns a present instance in the same timezone.

public nowWithSameTz() : static
Return values
static —

ordinal()

Return a property with its ordinal.

public ordinal(string $key[, string|null $period = null ]) : string
Parameters
$key : string
$period : string|null = null
Return values
string —

pluralUnit()

Returns standardized plural of a given singular/plural unit name (in English).

public static pluralUnit(string $unit) : string
Parameters
$unit : string
Return values
string —

quartersUntil()

public quartersUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each quarter or every X quarters if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

roundCenturies()

public roundCenturies(float $precision = 1, string $function = "round") : Carbon

Round the current instance century with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundCentury()

public roundCentury(float $precision = 1, string $function = "round") : Carbon

Round the current instance century with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundDay()

public roundDay(float $precision = 1, string $function = "round") : Carbon

Round the current instance day with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundDays()

public roundDays(float $precision = 1, string $function = "round") : Carbon

Round the current instance day with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundDecade()

public roundDecade(float $precision = 1, string $function = "round") : Carbon

Round the current instance decade with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundDecades()

public roundDecades(float $precision = 1, string $function = "round") : Carbon

Round the current instance decade with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundHour()

public roundHour(float $precision = 1, string $function = "round") : Carbon

Round the current instance hour with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundHours()

public roundHours(float $precision = 1, string $function = "round") : Carbon

Round the current instance hour with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundMicrosecond()

public roundMicrosecond(float $precision = 1, string $function = "round") : Carbon

Round the current instance microsecond with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundMicroseconds()

public roundMicroseconds(float $precision = 1, string $function = "round") : Carbon

Round the current instance microsecond with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundMillennia()

public roundMillennia(float $precision = 1, string $function = "round") : Carbon

Round the current instance millennium with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundMillennium()

public roundMillennium(float $precision = 1, string $function = "round") : Carbon

Round the current instance millennium with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundMillisecond()

public roundMillisecond(float $precision = 1, string $function = "round") : Carbon

Round the current instance millisecond with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundMilliseconds()

public roundMilliseconds(float $precision = 1, string $function = "round") : Carbon

Round the current instance millisecond with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundMinute()

public roundMinute(float $precision = 1, string $function = "round") : Carbon

Round the current instance minute with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundMinutes()

public roundMinutes(float $precision = 1, string $function = "round") : Carbon

Round the current instance minute with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundMonth()

public roundMonth(float $precision = 1, string $function = "round") : Carbon

Round the current instance month with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundMonths()

public roundMonths(float $precision = 1, string $function = "round") : Carbon

Round the current instance month with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundQuarter()

public roundQuarter(float $precision = 1, string $function = "round") : Carbon

Round the current instance quarter with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundQuarters()

public roundQuarters(float $precision = 1, string $function = "round") : Carbon

Round the current instance quarter with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundSecond()

public roundSecond(float $precision = 1, string $function = "round") : Carbon

Round the current instance second with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundSeconds()

public roundSeconds(float $precision = 1, string $function = "round") : Carbon

Round the current instance second with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundYear()

public roundYear(float $precision = 1, string $function = "round") : Carbon

Round the current instance year with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

roundYears()

public roundYears(float $precision = 1, string $function = "round") : Carbon

Round the current instance year with given precision using the given function.

Parameters
$precision = 1 : float
$function = "round" : string
Return values
Carbon —

second()

public second(int $value) : Carbon

Set current instance second to the given value.

Parameters
$value : int
Return values
Carbon —

seconds()

public seconds(int $value) : Carbon

Set current instance second to the given value.

Parameters
$value : int
Return values
Carbon —

secondsUntil()

public secondsUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each second or every X seconds if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

set()

Set a part of the Carbon object

public set(string|array<string|int, mixed> $name[, string|int|DateTimeZone $value = null ]) : $this
Parameters
$name : string|array<string|int, mixed>
$value : string|int|DateTimeZone = null
Tags
throws
ImmutableException|UnknownSetterException
Return values
$this —

setDate()

Set the date with gregorian year, month and day numbers.

public setDate(int $year, int $month, int $day) : static
Parameters
$year : int
$month : int
$day : int
Tags
see
https://php.net/manual/en/datetime.setdate.php
Return values
static —

setDateFrom()

Set the year, month, and date for this instance to that of the passed instance.

public setDateFrom([Carbon|DateTimeInterface $date = null ]) : static
Parameters
$date : Carbon|DateTimeInterface = null

now if null

Return values
static —

setDateTime()

Set the date and time all together.

public setDateTime(int $year, int $month, int $day, int $hour, int $minute, int $second, int $microseconds) : static
Parameters
$year : int
$month : int
$day : int
$hour : int
$minute : int
$second : int
$microseconds : int
Return values
static —

setDateTimeFrom()

Set the date and time for this instance to that of the passed instance.

public setDateTimeFrom([Carbon|DateTimeInterface $date = null ]) : static
Parameters
$date : Carbon|DateTimeInterface = null
Return values
static —

setDay()

public setDay(int $value) : Carbon

Set current instance day to the given value.

Parameters
$value : int
Return values
Carbon —

setDays()

public setDays(int $value) : Carbon

Set current instance day to the given value.

Parameters
$value : int
Return values
Carbon —

setHour()

public setHour(int $value) : Carbon

Set current instance hour to the given value.

Parameters
$value : int
Return values
Carbon —

setHours()

public setHours(int $value) : Carbon

Set current instance hour to the given value.

Parameters
$value : int
Return values
Carbon —

setISODate()

Set a date according to the ISO 8601 standard - using weeks and day offsets rather than specific dates.

public setISODate(int $year, int $week[, int $day = 1 ]) : static
Parameters
$year : int
$week : int
$day : int = 1
Tags
see
https://php.net/manual/en/datetime.setisodate.php
Return values
static —

setMicro()

public setMicro(int $value) : Carbon

Set current instance microsecond to the given value.

Parameters
$value : int
Return values
Carbon —

setMicros()

public setMicros(int $value) : Carbon

Set current instance microsecond to the given value.

Parameters
$value : int
Return values
Carbon —

setMicrosecond()

public setMicrosecond(int $value) : Carbon

Set current instance microsecond to the given value.

Parameters
$value : int
Return values
Carbon —

setMicroseconds()

public setMicroseconds(int $value) : Carbon

Set current instance microsecond to the given value.

Parameters
$value : int
Return values
Carbon —

setMilli()

public setMilli(int $value) : Carbon

Set current instance millisecond to the given value.

Parameters
$value : int
Return values
Carbon —

setMillis()

public setMillis(int $value) : Carbon

Set current instance millisecond to the given value.

Parameters
$value : int
Return values
Carbon —

setMillisecond()

public setMillisecond(int $value) : Carbon

Set current instance millisecond to the given value.

Parameters
$value : int
Return values
Carbon —

setMilliseconds()

public setMilliseconds(int $value) : Carbon

Set current instance millisecond to the given value.

Parameters
$value : int
Return values
Carbon —

setMinute()

public setMinute(int $value) : Carbon

Set current instance minute to the given value.

Parameters
$value : int
Return values
Carbon —

setMinutes()

public setMinutes(int $value) : Carbon

Set current instance minute to the given value.

Parameters
$value : int
Return values
Carbon —

setMonth()

public setMonth(int $value) : Carbon

Set current instance month to the given value.

Parameters
$value : int
Return values
Carbon —

setMonths()

public setMonths(int $value) : Carbon

Set current instance month to the given value.

Parameters
$value : int
Return values
Carbon —

setSecond()

public setSecond(int $value) : Carbon

Set current instance second to the given value.

Parameters
$value : int
Return values
Carbon —

setSeconds()

public setSeconds(int $value) : Carbon

Set current instance second to the given value.

Parameters
$value : int
Return values
Carbon —

setTime()

Resets the current time of the DateTime object to a different time.

public setTime(int $hour, int $minute, int $second, int $microseconds) : static
Parameters
$hour : int
$minute : int
$second : int
$microseconds : int
Tags
see
https://php.net/manual/en/datetime.settime.php
Return values
static —

setTimeFrom()

Set the hour, minute, second and microseconds for this instance to that of the passed instance.

public setTimeFrom([Carbon|DateTimeInterface $date = null ]) : static
Parameters
$date : Carbon|DateTimeInterface = null

now if null

Return values
static —

setTimeFromTimeString()

Set the time by time string.

public setTimeFromTimeString(string $time) : static
Parameters
$time : string
Return values
static —

setTimezone()

Set the instance's timezone from a string or object.

public setTimezone(DateTimeZone|string $value) : static
Parameters
$value : DateTimeZone|string
Return values
static —

setUnit()

Set specified unit to new given value.

public setUnit(string $unit[, int $value = null ]) : static
Parameters
$unit : string

year, month, day, hour, minute, second or microsecond

$value : int = null

new value for given unit

Return values
static —

setUnitNoOverflow()

Set any unit to a new value without overflowing current other unit given.

public setUnitNoOverflow(string $valueUnit, int $value, string $overflowUnit) : static
Parameters
$valueUnit : string

unit name to modify

$value : int

new value for the input unit

$overflowUnit : string

unit name to not overflow

Return values
static —

setUtf8()

public static setUtf8(bool $utf8) : mixed
Parameters
$utf8 : bool
Tags
deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather use UTF-8 language packages on every machine.

Set if UTF8 will be used for localized date/time.

Return values
mixed —

setWeekendDays()

public static setWeekendDays(array<string|int, mixed> $days) : void
Parameters
$days : array<string|int, mixed>
Tags
deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather consider week-end is always saturday and sunday, and if you have some custom week-end days to handle, give to those days an other name and create a macro for them:

        ```
        Carbon::macro('isDayOff', function ($date) {
            return $date->isSunday() || $date->isMonday();
        });
        Carbon::macro('isNotDayOff', function ($date) {
            return !$date->isDayOff();
        });
        if ($someDate->isDayOff()) ...
        if ($someDate->isNotDayOff()) ...
        // Add 5 not-off days
        $count = 5;
        while ($someDate->isDayOff() || ($count-- > 0)) {
            $someDate->addDay();
        }
        ```

Set weekend days

Return values
void —

setWeekEndsAt()

public static setWeekEndsAt(int $day) : void
Parameters
$day : int
Tags
deprecated

To avoid conflict between different third-party libraries, static setters should not be used. Use $weekStartsAt optional parameter instead when using startOfWeek, floorWeek, ceilWeek or roundWeek method. You can also use the 'first_day_of_week' locale setting to change the start of week according to current locale selected and implicitly the end of week.

Set the last day of week

Return values
void —

setWeekStartsAt()

public static setWeekStartsAt(int $day) : void
Parameters
$day : int

week start day

Tags
deprecated

To avoid conflict between different third-party libraries, static setters should not be used. Use $weekEndsAt optional parameter instead when using endOfWeek method. You can also use the 'first_day_of_week' locale setting to change the start of week according to current locale selected and implicitly the end of week.

Set the first day of week

Return values
void —

setYear()

public setYear(int $value) : Carbon

Set current instance year to the given value.

Parameters
$value : int
Return values
Carbon —

setYears()

public setYears(int $value) : Carbon

Set current instance year to the given value.

Parameters
$value : int
Return values
Carbon —

shiftTimezone()

Set the instance's timezone from a string or object and add/subtract the offset difference.

public shiftTimezone(DateTimeZone|string $value) : static
Parameters
$value : DateTimeZone|string
Return values
static —

shortAbsoluteDiffForHumans()

public shortAbsoluteDiffForHumans(DateTimeInterface $other = null, int $parts = 1) : string

Get the difference (short format, 'Absolute' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)

Parameters
$other = null : DateTimeInterface
$parts = 1 : int
Return values
string —

shortRelativeDiffForHumans()

public shortRelativeDiffForHumans(DateTimeInterface $other = null, int $parts = 1) : string

Get the difference (short format, 'Relative' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)

Parameters
$other = null : DateTimeInterface
$parts = 1 : int
Return values
string —

shortRelativeToNowDiffForHumans()

public shortRelativeToNowDiffForHumans(DateTimeInterface $other = null, int $parts = 1) : string

Get the difference (short format, 'RelativeToNow' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)

Parameters
$other = null : DateTimeInterface
$parts = 1 : int
Return values
string —

shortRelativeToOtherDiffForHumans()

public shortRelativeToOtherDiffForHumans(DateTimeInterface $other = null, int $parts = 1) : string

Get the difference (short format, 'RelativeToOther' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)

Parameters
$other = null : DateTimeInterface
$parts = 1 : int
Return values
string —

singularUnit()

Returns standardized singular of a given singular/plural unit name (in English).

public static singularUnit(string $unit) : string
Parameters
$unit : string
Return values
string —

subCenturies()

public subCenturies(int $value = 1) : Carbon

Sub centuries (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subCenturiesNoOverflow()

public subCenturiesNoOverflow(int $value = 1) : Carbon

Sub centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subCenturiesWithNoOverflow()

public subCenturiesWithNoOverflow(int $value = 1) : Carbon

Sub centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subCenturiesWithoutOverflow()

public subCenturiesWithoutOverflow(int $value = 1) : Carbon

Sub centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subCenturiesWithOverflow()

public subCenturiesWithOverflow(int $value = 1) : Carbon

Sub centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.

Parameters
$value = 1 : int
Return values
Carbon —

subCentury()

public subCentury() : Carbon

Sub one century to the instance (using date interval).

Return values
Carbon —

subCenturyNoOverflow()

public subCenturyNoOverflow() : Carbon

Sub one century to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subCenturyWithNoOverflow()

public subCenturyWithNoOverflow() : Carbon

Sub one century to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subCenturyWithoutOverflow()

public subCenturyWithoutOverflow() : Carbon

Sub one century to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subCenturyWithOverflow()

public subCenturyWithOverflow() : Carbon

Sub one century to the instance (using date interval) with overflow explicitly allowed.

Return values
Carbon —

subDay()

public subDay() : Carbon

Sub one day to the instance (using date interval).

Return values
Carbon —

subDays()

public subDays(int $value = 1) : Carbon

Sub days (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subDecade()

public subDecade() : Carbon

Sub one decade to the instance (using date interval).

Return values
Carbon —

subDecadeNoOverflow()

public subDecadeNoOverflow() : Carbon

Sub one decade to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subDecades()

public subDecades(int $value = 1) : Carbon

Sub decades (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subDecadesNoOverflow()

public subDecadesNoOverflow(int $value = 1) : Carbon

Sub decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subDecadesWithNoOverflow()

public subDecadesWithNoOverflow(int $value = 1) : Carbon

Sub decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subDecadesWithoutOverflow()

public subDecadesWithoutOverflow(int $value = 1) : Carbon

Sub decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subDecadesWithOverflow()

public subDecadesWithOverflow(int $value = 1) : Carbon

Sub decades (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.

Parameters
$value = 1 : int
Return values
Carbon —

subDecadeWithNoOverflow()

public subDecadeWithNoOverflow() : Carbon

Sub one decade to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subDecadeWithoutOverflow()

public subDecadeWithoutOverflow() : Carbon

Sub one decade to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subDecadeWithOverflow()

public subDecadeWithOverflow() : Carbon

Sub one decade to the instance (using date interval) with overflow explicitly allowed.

Return values
Carbon —

subHour()

public subHour() : Carbon

Sub one hour to the instance (using date interval).

Return values
Carbon —

subHours()

public subHours(int $value = 1) : Carbon

Sub hours (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subMicro()

public subMicro() : Carbon

Sub one microsecond to the instance (using date interval).

Return values
Carbon —

subMicros()

public subMicros(int $value = 1) : Carbon

Sub microseconds (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subMicrosecond()

public subMicrosecond() : Carbon

Sub one microsecond to the instance (using date interval).

Return values
Carbon —

subMicroseconds()

public subMicroseconds(int $value = 1) : Carbon

Sub microseconds (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subMillennia()

public subMillennia(int $value = 1) : Carbon

Sub millennia (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subMillenniaNoOverflow()

public subMillenniaNoOverflow(int $value = 1) : Carbon

Sub millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subMillenniaWithNoOverflow()

public subMillenniaWithNoOverflow(int $value = 1) : Carbon

Sub millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subMillenniaWithoutOverflow()

public subMillenniaWithoutOverflow(int $value = 1) : Carbon

Sub millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subMillenniaWithOverflow()

public subMillenniaWithOverflow(int $value = 1) : Carbon

Sub millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.

Parameters
$value = 1 : int
Return values
Carbon —

subMillennium()

public subMillennium() : Carbon

Sub one millennium to the instance (using date interval).

Return values
Carbon —

subMillenniumNoOverflow()

public subMillenniumNoOverflow() : Carbon

Sub one millennium to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subMillenniumWithNoOverflow()

public subMillenniumWithNoOverflow() : Carbon

Sub one millennium to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subMillenniumWithoutOverflow()

public subMillenniumWithoutOverflow() : Carbon

Sub one millennium to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subMillenniumWithOverflow()

public subMillenniumWithOverflow() : Carbon

Sub one millennium to the instance (using date interval) with overflow explicitly allowed.

Return values
Carbon —

subMilli()

public subMilli() : Carbon

Sub one millisecond to the instance (using date interval).

Return values
Carbon —

subMillis()

public subMillis(int $value = 1) : Carbon

Sub milliseconds (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subMillisecond()

public subMillisecond() : Carbon

Sub one millisecond to the instance (using date interval).

Return values
Carbon —

subMilliseconds()

public subMilliseconds(int $value = 1) : Carbon

Sub milliseconds (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subMinute()

public subMinute() : Carbon

Sub one minute to the instance (using date interval).

Return values
Carbon —

subMinutes()

public subMinutes(int $value = 1) : Carbon

Sub minutes (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subMonth()

public subMonth() : Carbon

Sub one month to the instance (using date interval).

Return values
Carbon —

subMonthNoOverflow()

public subMonthNoOverflow() : Carbon

Sub one month to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subMonths()

public subMonths(int $value = 1) : Carbon

Sub months (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subMonthsNoOverflow()

public subMonthsNoOverflow(int $value = 1) : Carbon

Sub months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subMonthsWithNoOverflow()

public subMonthsWithNoOverflow(int $value = 1) : Carbon

Sub months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subMonthsWithoutOverflow()

public subMonthsWithoutOverflow(int $value = 1) : Carbon

Sub months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subMonthsWithOverflow()

public subMonthsWithOverflow(int $value = 1) : Carbon

Sub months (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.

Parameters
$value = 1 : int
Return values
Carbon —

subMonthWithNoOverflow()

public subMonthWithNoOverflow() : Carbon

Sub one month to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subMonthWithoutOverflow()

public subMonthWithoutOverflow() : Carbon

Sub one month to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subMonthWithOverflow()

public subMonthWithOverflow() : Carbon

Sub one month to the instance (using date interval) with overflow explicitly allowed.

Return values
Carbon —

subQuarter()

public subQuarter() : Carbon

Sub one quarter to the instance (using date interval).

Return values
Carbon —

subQuarterNoOverflow()

public subQuarterNoOverflow() : Carbon

Sub one quarter to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subQuarters()

public subQuarters(int $value = 1) : Carbon

Sub quarters (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subQuartersNoOverflow()

public subQuartersNoOverflow(int $value = 1) : Carbon

Sub quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subQuartersWithNoOverflow()

public subQuartersWithNoOverflow(int $value = 1) : Carbon

Sub quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subQuartersWithoutOverflow()

public subQuartersWithoutOverflow(int $value = 1) : Carbon

Sub quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subQuartersWithOverflow()

public subQuartersWithOverflow(int $value = 1) : Carbon

Sub quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.

Parameters
$value = 1 : int
Return values
Carbon —

subQuarterWithNoOverflow()

public subQuarterWithNoOverflow() : Carbon

Sub one quarter to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subQuarterWithoutOverflow()

public subQuarterWithoutOverflow() : Carbon

Sub one quarter to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subQuarterWithOverflow()

public subQuarterWithOverflow() : Carbon

Sub one quarter to the instance (using date interval) with overflow explicitly allowed.

Return values
Carbon —

subRealCenturies()

public subRealCenturies(int $value = 1) : Carbon

Sub centuries (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealCentury()

public subRealCentury() : Carbon

Sub one century to the instance (using timestamp).

Return values
Carbon —

subRealDay()

public subRealDay() : Carbon

Sub one day to the instance (using timestamp).

Return values
Carbon —

subRealDays()

public subRealDays(int $value = 1) : Carbon

Sub days (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealDecade()

public subRealDecade() : Carbon

Sub one decade to the instance (using timestamp).

Return values
Carbon —

subRealDecades()

public subRealDecades(int $value = 1) : Carbon

Sub decades (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealHour()

public subRealHour() : Carbon

Sub one hour to the instance (using timestamp).

Return values
Carbon —

subRealHours()

public subRealHours(int $value = 1) : Carbon

Sub hours (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealMicro()

public subRealMicro() : Carbon

Sub one microsecond to the instance (using timestamp).

Return values
Carbon —

subRealMicros()

public subRealMicros(int $value = 1) : Carbon

Sub microseconds (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealMicrosecond()

public subRealMicrosecond() : Carbon

Sub one microsecond to the instance (using timestamp).

Return values
Carbon —

subRealMicroseconds()

public subRealMicroseconds(int $value = 1) : Carbon

Sub microseconds (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealMillennia()

public subRealMillennia(int $value = 1) : Carbon

Sub millennia (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealMillennium()

public subRealMillennium() : Carbon

Sub one millennium to the instance (using timestamp).

Return values
Carbon —

subRealMilli()

public subRealMilli() : Carbon

Sub one millisecond to the instance (using timestamp).

Return values
Carbon —

subRealMillis()

public subRealMillis(int $value = 1) : Carbon

Sub milliseconds (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealMillisecond()

public subRealMillisecond() : Carbon

Sub one millisecond to the instance (using timestamp).

Return values
Carbon —

subRealMilliseconds()

public subRealMilliseconds(int $value = 1) : Carbon

Sub milliseconds (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealMinute()

public subRealMinute() : Carbon

Sub one minute to the instance (using timestamp).

Return values
Carbon —

subRealMinutes()

public subRealMinutes(int $value = 1) : Carbon

Sub minutes (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealMonth()

public subRealMonth() : Carbon

Sub one month to the instance (using timestamp).

Return values
Carbon —

subRealMonths()

public subRealMonths(int $value = 1) : Carbon

Sub months (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealQuarter()

public subRealQuarter() : Carbon

Sub one quarter to the instance (using timestamp).

Return values
Carbon —

subRealQuarters()

public subRealQuarters(int $value = 1) : Carbon

Sub quarters (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealSecond()

public subRealSecond() : Carbon

Sub one second to the instance (using timestamp).

Return values
Carbon —

subRealSeconds()

public subRealSeconds(int $value = 1) : Carbon

Sub seconds (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealWeek()

public subRealWeek() : Carbon

Sub one week to the instance (using timestamp).

Return values
Carbon —

subRealWeeks()

public subRealWeeks(int $value = 1) : Carbon

Sub weeks (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subRealYear()

public subRealYear() : Carbon

Sub one year to the instance (using timestamp).

Return values
Carbon —

subRealYears()

public subRealYears(int $value = 1) : Carbon

Sub years (the $value count passed in) to the instance (using timestamp).

Parameters
$value = 1 : int
Return values
Carbon —

subSecond()

public subSecond() : Carbon

Sub one second to the instance (using date interval).

Return values
Carbon —

subSeconds()

public subSeconds(int $value = 1) : Carbon

Sub seconds (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subUnitNoOverflow()

Subtract any unit to a new value without overflowing current other unit given.

public subUnitNoOverflow(string $valueUnit, int $value, string $overflowUnit) : static
Parameters
$valueUnit : string

unit name to modify

$value : int

amount to subtract to the input unit

$overflowUnit : string

unit name to not overflow

Return values
static —

subWeek()

public subWeek() : Carbon

Sub one week to the instance (using date interval).

Return values
Carbon —

subWeekday()

public subWeekday() : Carbon

Sub one weekday to the instance (using date interval).

Return values
Carbon —

subWeekdays()

public subWeekdays(int $value = 1) : Carbon

Sub weekdays (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subWeeks()

public subWeeks(int $value = 1) : Carbon

Sub weeks (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subYear()

public subYear() : Carbon

Sub one year to the instance (using date interval).

Return values
Carbon —

subYearNoOverflow()

public subYearNoOverflow() : Carbon

Sub one year to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subYears()

public subYears(int $value = 1) : Carbon

Sub years (the $value count passed in) to the instance (using date interval).

Parameters
$value = 1 : int
Return values
Carbon —

subYearsNoOverflow()

public subYearsNoOverflow(int $value = 1) : Carbon

Sub years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subYearsWithNoOverflow()

public subYearsWithNoOverflow(int $value = 1) : Carbon

Sub years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subYearsWithoutOverflow()

public subYearsWithoutOverflow(int $value = 1) : Carbon

Sub years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.

Parameters
$value = 1 : int
Return values
Carbon —

subYearsWithOverflow()

public subYearsWithOverflow(int $value = 1) : Carbon

Sub years (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.

Parameters
$value = 1 : int
Return values
Carbon —

subYearWithNoOverflow()

public subYearWithNoOverflow() : Carbon

Sub one year to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subYearWithoutOverflow()

public subYearWithoutOverflow() : Carbon

Sub one year to the instance (using date interval) with overflow explicitly forbidden.

Return values
Carbon —

subYearWithOverflow()

public subYearWithOverflow() : Carbon

Sub one year to the instance (using date interval) with overflow explicitly allowed.

Return values
Carbon —

timezone()

public timezone(DateTimeZone|string $value) : static
Parameters
$value : DateTimeZone|string
Tags
alias

setTimezone

Return values
static —

translatedFormat()

Format as ->format() do (using date replacements patterns from http://php.net/manual/fr/function.date.php) but translate words whenever possible (months, day names, etc.) using the current locale.

public translatedFormat(string $format) : string
Parameters
$format : string
Return values
string —

tz()

Set the timezone or returns the timezone name if no arguments passed.

public tz([DateTimeZone|string $value = null ]) : static|string
Parameters
$value : DateTimeZone|string = null
Return values
static|string —

utc()

Set the instance's timezone to UTC.

public utc() : static
Return values
static —

utcOffset()

Returns the minutes offset to UTC if no arguments passed, else set the timezone with given minutes shift passed.

public utcOffset([int|null $offset = null ]) : int|static
Parameters
$offset : int|null = null
Return values
int|static —

weekday()

Get/set the weekday from 0 (Sunday) to 6 (Saturday).

public weekday([int|null $value = null ]) : static|int
Parameters
$value : int|null = null

new value for weekday if using as setter.

Return values
static|int —

weeksUntil()

public weeksUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each week or every X weeks if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

year()

public year(int $value) : Carbon

Set current instance year to the given value.

Parameters
$value : int
Return values
Carbon —

years()

public years(int $value) : Carbon

Set current instance year to the given value.

Parameters
$value : int
Return values
Carbon —

yearsUntil()

public yearsUntil(mixed $endDate, int $factor = 1) : CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each year or every X years if a factor is given.

Parameters
$endDate : mixed
$factor = 1 : int
Return values
CarbonPeriod —

executeCallable()

protected executeCallable(mixed $macro, mixed ...$parameters) : mixed
Parameters
$macro : mixed
$parameters : mixed
Return values
mixed —

executeCallableWithContext()

protected executeCallableWithContext(mixed $macro, mixed ...$parameters) : mixed
Parameters
$macro : mixed
$parameters : mixed
Return values
mixed —

executeStaticCallable()

protected static executeStaticCallable(mixed $macro, mixed ...$parameters) : mixed
Parameters
$macro : mixed
$parameters : mixed
Return values
mixed —

expectDateTime()

Throws an exception if the given object is not a DateTime and does not implement DateTimeInterface.

protected static expectDateTime(mixed $date[, string|array<string|int, mixed> $other = [] ]) : mixed
Parameters
$date : mixed
$other : string|array<string|int, mixed> = []
Tags
throws
InvalidTypeException
Return values
mixed —

getGenericMacros()

protected static getGenericMacros() : mixed
Return values
mixed —

getRangesByUnit()

List of minimum and maximums for each unit.

protected static getRangesByUnit() : array<string|int, mixed>
Return values
array<string|int, mixed> —

getTranslatedFormByRegExp()

protected getTranslatedFormByRegExp(mixed $baseKey, mixed $keySuffix, mixed $context, mixed $subKey, mixed $defaultValue) : mixed
Parameters
$baseKey : mixed
$keySuffix : mixed
$context : mixed
$subKey : mixed
$defaultValue : mixed
Return values
mixed —

resolveCarbon()

Return the Carbon instance passed through, a now instance in the same timezone if null given or parse the input if string given.

protected resolveCarbon([Carbon|DateTimeInterface|string|null $date = null ]) : static
Parameters
$date : Carbon|DateTimeInterface|string|null = null
Return values
static —

safeCreateDateTimeZone()

Creates a DateTimeZone from a string, DateTimeZone or integer offset.

protected static safeCreateDateTimeZone(DateTimeZone|string|int|null $object[, DateTimeZone|string|int|null $objectDump = null ]) : CarbonTimeZone|false
Parameters
$object : DateTimeZone|string|int|null

original value to get CarbonTimeZone from it.

$objectDump : DateTimeZone|string|int|null = null

dump of the object for error messages.

Tags
throws
InvalidTimeZoneException
Return values
CarbonTimeZone|false —

Search results