Date
A simple API extension for DateTime.
<autodoc generated by composer phpdoc
>
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
- addCenturies() : CarbonInterface
- addCenturiesNoOverflow() : CarbonInterface
- addCenturiesWithNoOverflow() : CarbonInterface
- addCenturiesWithoutOverflow() : CarbonInterface
- addCenturiesWithOverflow() : CarbonInterface
- addCentury() : CarbonInterface
- addCenturyNoOverflow() : CarbonInterface
- addCenturyWithNoOverflow() : CarbonInterface
- addCenturyWithoutOverflow() : CarbonInterface
- addCenturyWithOverflow() : CarbonInterface
- addDay() : CarbonInterface
- addDays() : CarbonInterface
- addDecade() : CarbonInterface
- addDecadeNoOverflow() : CarbonInterface
- addDecades() : CarbonInterface
- addDecadesNoOverflow() : CarbonInterface
- addDecadesWithNoOverflow() : CarbonInterface
- addDecadesWithoutOverflow() : CarbonInterface
- addDecadesWithOverflow() : CarbonInterface
- addDecadeWithNoOverflow() : CarbonInterface
- addDecadeWithoutOverflow() : CarbonInterface
- addDecadeWithOverflow() : CarbonInterface
- addHour() : CarbonInterface
- addHours() : CarbonInterface
- addMicro() : CarbonInterface
- addMicros() : CarbonInterface
- addMicrosecond() : CarbonInterface
- addMicroseconds() : CarbonInterface
- addMillennia() : CarbonInterface
- addMillenniaNoOverflow() : CarbonInterface
- addMillenniaWithNoOverflow() : CarbonInterface
- addMillenniaWithoutOverflow() : CarbonInterface
- addMillenniaWithOverflow() : CarbonInterface
- addMillennium() : CarbonInterface
- addMillenniumNoOverflow() : CarbonInterface
- addMillenniumWithNoOverflow() : CarbonInterface
- addMillenniumWithoutOverflow() : CarbonInterface
- addMillenniumWithOverflow() : CarbonInterface
- addMilli() : CarbonInterface
- addMillis() : CarbonInterface
- addMillisecond() : CarbonInterface
- addMilliseconds() : CarbonInterface
- addMinute() : CarbonInterface
- addMinutes() : CarbonInterface
- addMonth() : CarbonInterface
- addMonthNoOverflow() : CarbonInterface
- addMonths() : CarbonInterface
- addMonthsNoOverflow() : CarbonInterface
- addMonthsWithNoOverflow() : CarbonInterface
- addMonthsWithoutOverflow() : CarbonInterface
- addMonthsWithOverflow() : CarbonInterface
- addMonthWithNoOverflow() : CarbonInterface
- addMonthWithoutOverflow() : CarbonInterface
- addMonthWithOverflow() : CarbonInterface
- addQuarter() : CarbonInterface
- addQuarterNoOverflow() : CarbonInterface
- addQuarters() : CarbonInterface
- addQuartersNoOverflow() : CarbonInterface
- addQuartersWithNoOverflow() : CarbonInterface
- addQuartersWithoutOverflow() : CarbonInterface
- addQuartersWithOverflow() : CarbonInterface
- addQuarterWithNoOverflow() : CarbonInterface
- addQuarterWithoutOverflow() : CarbonInterface
- addQuarterWithOverflow() : CarbonInterface
- addRealCenturies() : CarbonInterface
- addRealCentury() : CarbonInterface
- addRealDay() : CarbonInterface
- addRealDays() : CarbonInterface
- addRealDecade() : CarbonInterface
- addRealDecades() : CarbonInterface
- addRealHour() : CarbonInterface
- addRealHours() : CarbonInterface
- addRealMicro() : CarbonInterface
- addRealMicros() : CarbonInterface
- addRealMicrosecond() : CarbonInterface
- addRealMicroseconds() : CarbonInterface
- addRealMillennia() : CarbonInterface
- addRealMillennium() : CarbonInterface
- addRealMilli() : CarbonInterface
- addRealMillis() : CarbonInterface
- addRealMillisecond() : CarbonInterface
- addRealMilliseconds() : CarbonInterface
- addRealMinute() : CarbonInterface
- addRealMinutes() : CarbonInterface
- addRealMonth() : CarbonInterface
- addRealMonths() : CarbonInterface
- addRealQuarter() : CarbonInterface
- addRealQuarters() : CarbonInterface
- addRealSecond() : CarbonInterface
- addRealSeconds() : CarbonInterface
- addRealWeek() : CarbonInterface
- addRealWeeks() : CarbonInterface
- addRealYear() : CarbonInterface
- addRealYears() : CarbonInterface
- addSecond() : CarbonInterface
- addSeconds() : CarbonInterface
- addUnitNoOverflow() : static
- Add any unit to a new value without overflowing current other unit given.
- addWeek() : CarbonInterface
- addWeekday() : CarbonInterface
- addWeekdays() : CarbonInterface
- addWeeks() : CarbonInterface
- addYear() : CarbonInterface
- addYearNoOverflow() : CarbonInterface
- addYears() : CarbonInterface
- addYearsNoOverflow() : CarbonInterface
- addYearsWithNoOverflow() : CarbonInterface
- addYearsWithoutOverflow() : CarbonInterface
- addYearsWithOverflow() : CarbonInterface
- addYearWithNoOverflow() : CarbonInterface
- addYearWithoutOverflow() : CarbonInterface
- addYearWithOverflow() : CarbonInterface
- 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() : CarbonInterface
- ceilCentury() : CarbonInterface
- ceilDay() : CarbonInterface
- ceilDays() : CarbonInterface
- ceilDecade() : CarbonInterface
- ceilDecades() : CarbonInterface
- ceilHour() : CarbonInterface
- ceilHours() : CarbonInterface
- ceilMicrosecond() : CarbonInterface
- ceilMicroseconds() : CarbonInterface
- ceilMillennia() : CarbonInterface
- ceilMillennium() : CarbonInterface
- ceilMillisecond() : CarbonInterface
- ceilMilliseconds() : CarbonInterface
- ceilMinute() : CarbonInterface
- ceilMinutes() : CarbonInterface
- ceilMonth() : CarbonInterface
- ceilMonths() : CarbonInterface
- ceilQuarter() : CarbonInterface
- ceilQuarters() : CarbonInterface
- ceilSecond() : CarbonInterface
- ceilSeconds() : CarbonInterface
- ceilYear() : CarbonInterface
- ceilYears() : CarbonInterface
- centuriesUntil() : CarbonPeriod
- clone() : static
- copy() : static
- Get a copy of the instance.
- day() : CarbonInterface
- dayOfYear() : static|int
- Get/set the day of year.
- days() : CarbonInterface
- daysUntil() : CarbonPeriod
- decadesUntil() : CarbonPeriod
- floorCenturies() : CarbonInterface
- floorCentury() : CarbonInterface
- floorDay() : CarbonInterface
- floorDays() : CarbonInterface
- floorDecade() : CarbonInterface
- floorDecades() : CarbonInterface
- floorHour() : CarbonInterface
- floorHours() : CarbonInterface
- floorMicrosecond() : CarbonInterface
- floorMicroseconds() : CarbonInterface
- floorMillennia() : CarbonInterface
- floorMillennium() : CarbonInterface
- floorMillisecond() : CarbonInterface
- floorMilliseconds() : CarbonInterface
- floorMinute() : CarbonInterface
- floorMinutes() : CarbonInterface
- floorMonth() : CarbonInterface
- floorMonths() : CarbonInterface
- floorQuarter() : CarbonInterface
- floorQuarters() : CarbonInterface
- floorSecond() : CarbonInterface
- floorSeconds() : CarbonInterface
- floorYear() : CarbonInterface
- floorYears() : CarbonInterface
- 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() : CarbonInterface
- hours() : CarbonInterface
- 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
- 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() : CarbonInterface
- micros() : CarbonInterface
- microsecond() : CarbonInterface
- microseconds() : CarbonInterface
- microsecondsUntil() : CarbonPeriod
- microsUntil() : CarbonPeriod
- millenniaUntil() : CarbonPeriod
- milli() : CarbonInterface
- millis() : CarbonInterface
- millisecond() : CarbonInterface
- milliseconds() : CarbonInterface
- millisecondsUntil() : CarbonPeriod
- millisUntil() : CarbonPeriod
- minute() : CarbonInterface
- minutes() : CarbonInterface
- minutesUntil() : CarbonPeriod
- month() : CarbonInterface
- months() : CarbonInterface
- 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() : CarbonInterface
- roundCentury() : CarbonInterface
- roundDay() : CarbonInterface
- roundDays() : CarbonInterface
- roundDecade() : CarbonInterface
- roundDecades() : CarbonInterface
- roundHour() : CarbonInterface
- roundHours() : CarbonInterface
- roundMicrosecond() : CarbonInterface
- roundMicroseconds() : CarbonInterface
- roundMillennia() : CarbonInterface
- roundMillennium() : CarbonInterface
- roundMillisecond() : CarbonInterface
- roundMilliseconds() : CarbonInterface
- roundMinute() : CarbonInterface
- roundMinutes() : CarbonInterface
- roundMonth() : CarbonInterface
- roundMonths() : CarbonInterface
- roundQuarter() : CarbonInterface
- roundQuarters() : CarbonInterface
- roundSecond() : CarbonInterface
- roundSeconds() : CarbonInterface
- roundYear() : CarbonInterface
- roundYears() : CarbonInterface
- second() : CarbonInterface
- seconds() : CarbonInterface
- 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() : CarbonInterface
- setDays() : CarbonInterface
- setHour() : CarbonInterface
- setHours() : CarbonInterface
- setISODate() : static
- Set a date according to the ISO 8601 standard - using weeks and day offsets rather than specific dates.
- setMicro() : CarbonInterface
- setMicros() : CarbonInterface
- setMicrosecond() : CarbonInterface
- setMicroseconds() : CarbonInterface
- setMilli() : CarbonInterface
- setMillis() : CarbonInterface
- setMillisecond() : CarbonInterface
- setMilliseconds() : CarbonInterface
- setMinute() : CarbonInterface
- setMinutes() : CarbonInterface
- setMonth() : CarbonInterface
- setMonths() : CarbonInterface
- setSecond() : CarbonInterface
- setSeconds() : CarbonInterface
- 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() : CarbonInterface
- setYears() : CarbonInterface
- 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() : CarbonInterface
- subCenturiesNoOverflow() : CarbonInterface
- subCenturiesWithNoOverflow() : CarbonInterface
- subCenturiesWithoutOverflow() : CarbonInterface
- subCenturiesWithOverflow() : CarbonInterface
- subCentury() : CarbonInterface
- subCenturyNoOverflow() : CarbonInterface
- subCenturyWithNoOverflow() : CarbonInterface
- subCenturyWithoutOverflow() : CarbonInterface
- subCenturyWithOverflow() : CarbonInterface
- subDay() : CarbonInterface
- subDays() : CarbonInterface
- subDecade() : CarbonInterface
- subDecadeNoOverflow() : CarbonInterface
- subDecades() : CarbonInterface
- subDecadesNoOverflow() : CarbonInterface
- subDecadesWithNoOverflow() : CarbonInterface
- subDecadesWithoutOverflow() : CarbonInterface
- subDecadesWithOverflow() : CarbonInterface
- subDecadeWithNoOverflow() : CarbonInterface
- subDecadeWithoutOverflow() : CarbonInterface
- subDecadeWithOverflow() : CarbonInterface
- subHour() : CarbonInterface
- subHours() : CarbonInterface
- subMicro() : CarbonInterface
- subMicros() : CarbonInterface
- subMicrosecond() : CarbonInterface
- subMicroseconds() : CarbonInterface
- subMillennia() : CarbonInterface
- subMillenniaNoOverflow() : CarbonInterface
- subMillenniaWithNoOverflow() : CarbonInterface
- subMillenniaWithoutOverflow() : CarbonInterface
- subMillenniaWithOverflow() : CarbonInterface
- subMillennium() : CarbonInterface
- subMillenniumNoOverflow() : CarbonInterface
- subMillenniumWithNoOverflow() : CarbonInterface
- subMillenniumWithoutOverflow() : CarbonInterface
- subMillenniumWithOverflow() : CarbonInterface
- subMilli() : CarbonInterface
- subMillis() : CarbonInterface
- subMillisecond() : CarbonInterface
- subMilliseconds() : CarbonInterface
- subMinute() : CarbonInterface
- subMinutes() : CarbonInterface
- subMonth() : CarbonInterface
- subMonthNoOverflow() : CarbonInterface
- subMonths() : CarbonInterface
- subMonthsNoOverflow() : CarbonInterface
- subMonthsWithNoOverflow() : CarbonInterface
- subMonthsWithoutOverflow() : CarbonInterface
- subMonthsWithOverflow() : CarbonInterface
- subMonthWithNoOverflow() : CarbonInterface
- subMonthWithoutOverflow() : CarbonInterface
- subMonthWithOverflow() : CarbonInterface
- subQuarter() : CarbonInterface
- subQuarterNoOverflow() : CarbonInterface
- subQuarters() : CarbonInterface
- subQuartersNoOverflow() : CarbonInterface
- subQuartersWithNoOverflow() : CarbonInterface
- subQuartersWithoutOverflow() : CarbonInterface
- subQuartersWithOverflow() : CarbonInterface
- subQuarterWithNoOverflow() : CarbonInterface
- subQuarterWithoutOverflow() : CarbonInterface
- subQuarterWithOverflow() : CarbonInterface
- subRealCenturies() : CarbonInterface
- subRealCentury() : CarbonInterface
- subRealDay() : CarbonInterface
- subRealDays() : CarbonInterface
- subRealDecade() : CarbonInterface
- subRealDecades() : CarbonInterface
- subRealHour() : CarbonInterface
- subRealHours() : CarbonInterface
- subRealMicro() : CarbonInterface
- subRealMicros() : CarbonInterface
- subRealMicrosecond() : CarbonInterface
- subRealMicroseconds() : CarbonInterface
- subRealMillennia() : CarbonInterface
- subRealMillennium() : CarbonInterface
- subRealMilli() : CarbonInterface
- subRealMillis() : CarbonInterface
- subRealMillisecond() : CarbonInterface
- subRealMilliseconds() : CarbonInterface
- subRealMinute() : CarbonInterface
- subRealMinutes() : CarbonInterface
- subRealMonth() : CarbonInterface
- subRealMonths() : CarbonInterface
- subRealQuarter() : CarbonInterface
- subRealQuarters() : CarbonInterface
- subRealSecond() : CarbonInterface
- subRealSeconds() : CarbonInterface
- subRealWeek() : CarbonInterface
- subRealWeeks() : CarbonInterface
- subRealYear() : CarbonInterface
- subRealYears() : CarbonInterface
- subSecond() : CarbonInterface
- subSeconds() : CarbonInterface
- subUnitNoOverflow() : static
- Subtract any unit to a new value without overflowing current other unit given.
- subWeek() : CarbonInterface
- subWeekday() : CarbonInterface
- subWeekdays() : CarbonInterface
- subWeeks() : CarbonInterface
- subYear() : CarbonInterface
- subYearNoOverflow() : CarbonInterface
- subYears() : CarbonInterface
- subYearsNoOverflow() : CarbonInterface
- subYearsWithNoOverflow() : CarbonInterface
- subYearsWithoutOverflow() : CarbonInterface
- subYearsWithOverflow() : CarbonInterface
- subYearWithNoOverflow() : CarbonInterface
- subYearWithoutOverflow() : CarbonInterface
- subYearWithOverflow() : CarbonInterface
- 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() : CarbonInterface
- years() : CarbonInterface
- 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
public
int
$century
the century of this instance
$day
public
int
$day
$dayName
public
string
$dayName
long name of weekday translated according to Carbon locale, in english if no translation available for current language
$dayOfWeek
public
int
$dayOfWeek
0 (for Sunday) through 6 (for Saturday)
$dayOfWeekIso
public
int
$dayOfWeekIso
1 (for Monday) through 7 (for Sunday)
$dayOfYear
public
int
$dayOfYear
1 through 366
$daysInMonth
public
int
$daysInMonth
number of days in the given month
$daysInYear
public
int
$daysInYear
365 or 366
$decade
public
int
$decade
the decade of this instance
$dst
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
public
int
$firstWeekDay
0 through 6
$hour
public
int
$hour
$isoWeek
public
int
$isoWeek
1 through 53
$isoWeeksInYear
public
int
$isoWeeksInYear
51 through 53
$isoWeekYear
public
int
$isoWeekYear
year according to ISO week format
$lastWeekDay
public
int
$lastWeekDay
0 through 6
$latinMeridiem
public
string
$latinMeridiem
"am"/"pm" (Ante meridiem or Post meridiem latin lowercase mark)
$latinUpperMeridiem
public
string
$latinUpperMeridiem
"AM"/"PM" (Ante meridiem or Post meridiem latin uppercase mark)
$local
public
bool
$local
checks if the timezone is local, true if local, false otherwise
$locale
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
public
string
$meridiem
lowercase meridiem mark translated according to Carbon locale, in latin if no translation available for current language
$micro
public
int
$micro
$microsecond
public
int
$microsecond
$millennium
public
int
$millennium
the millennium of this instance
$milli
public
int
$milli
$millisecond
public
int
$millisecond
$milliseconds
public
int
$milliseconds
$minDayName
public
string
$minDayName
very short name of weekday translated according to Carbon locale, in english if no translation available for current language
$minute
public
int
$minute
$month
public
int
$month
$monthName
public
string
$monthName
long name of month translated according to Carbon locale, in english if no translation available for current language
$noZeroHour
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
public
int
$quarter
the quarter of this instance, 1 - 4
$second
public
int
$second
$shortDayName
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
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
$timezone
public
CarbonTimeZone
$timezone
the current timezone
$timezoneAbbreviatedName
public
string
$timezoneAbbreviatedName
the current timezone abbreviated name
$timezoneName
public
string
$timezoneName
the current timezone name
$tz
public
CarbonTimeZone
$tz
alias of $timezone
$tzAbbrName
public
string
$tzAbbrName
alias of $timezoneAbbreviatedName
$tzName
public
string
$tzName
alias of $timezoneName
$upperMeridiem
public
string
$upperMeridiem
uppercase meridiem mark translated according to Carbon locale, in latin if no translation available for current language
$utc
public
bool
$utc
checks if the timezone is UTC, true if UTC, false otherwise
$week
public
int
$week
1 through 53
$weekNumberInMonth
public
int
$weekNumberInMonth
1 through 5
$weekOfMonth
public
int
$weekOfMonth
1 through 5
$weekOfYear
public
int
$weekOfYear
ISO-8601 week number of year, weeks starting on Monday
$weeksInYear
public
int
$weeksInYear
51 through 53
$weekYear
public
int
$weekYear
year according to week format
$year
public
int
$year
$yearIso
public
int
$yearIso
$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
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
Return values
mixed —__get()
Get a part of the Carbon object
public
__get(string $name) : string|int|bool|DateTimeZone|null
Parameters
- $name : string
Tags
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
Return values
void —addCenturies()
public
addCenturies(int $value = 1) : CarbonInterface
Add centuries (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addCenturiesNoOverflow()
public
addCenturiesNoOverflow(int $value = 1) : CarbonInterface
Add centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addCenturiesWithNoOverflow()
public
addCenturiesWithNoOverflow(int $value = 1) : CarbonInterface
Add centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addCenturiesWithoutOverflow()
public
addCenturiesWithoutOverflow(int $value = 1) : CarbonInterface
Add centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addCenturiesWithOverflow()
public
addCenturiesWithOverflow(int $value = 1) : CarbonInterface
Add centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addCentury()
public
addCentury() : CarbonInterface
Add one century to the instance (using date interval).
Return values
CarbonInterface —addCenturyNoOverflow()
public
addCenturyNoOverflow() : CarbonInterface
Add one century to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addCenturyWithNoOverflow()
public
addCenturyWithNoOverflow() : CarbonInterface
Add one century to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addCenturyWithoutOverflow()
public
addCenturyWithoutOverflow() : CarbonInterface
Add one century to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addCenturyWithOverflow()
public
addCenturyWithOverflow() : CarbonInterface
Add one century to the instance (using date interval) with overflow explicitly allowed.
Return values
CarbonInterface —addDay()
public
addDay() : CarbonInterface
Add one day to the instance (using date interval).
Return values
CarbonInterface —addDays()
public
addDays(int $value = 1) : CarbonInterface
Add days (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addDecade()
public
addDecade() : CarbonInterface
Add one decade to the instance (using date interval).
Return values
CarbonInterface —addDecadeNoOverflow()
public
addDecadeNoOverflow() : CarbonInterface
Add one decade to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addDecades()
public
addDecades(int $value = 1) : CarbonInterface
Add decades (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addDecadesNoOverflow()
public
addDecadesNoOverflow(int $value = 1) : CarbonInterface
Add decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addDecadesWithNoOverflow()
public
addDecadesWithNoOverflow(int $value = 1) : CarbonInterface
Add decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addDecadesWithoutOverflow()
public
addDecadesWithoutOverflow(int $value = 1) : CarbonInterface
Add decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addDecadesWithOverflow()
public
addDecadesWithOverflow(int $value = 1) : CarbonInterface
Add decades (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addDecadeWithNoOverflow()
public
addDecadeWithNoOverflow() : CarbonInterface
Add one decade to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addDecadeWithoutOverflow()
public
addDecadeWithoutOverflow() : CarbonInterface
Add one decade to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addDecadeWithOverflow()
public
addDecadeWithOverflow() : CarbonInterface
Add one decade to the instance (using date interval) with overflow explicitly allowed.
Return values
CarbonInterface —addHour()
public
addHour() : CarbonInterface
Add one hour to the instance (using date interval).
Return values
CarbonInterface —addHours()
public
addHours(int $value = 1) : CarbonInterface
Add hours (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMicro()
public
addMicro() : CarbonInterface
Add one microsecond to the instance (using date interval).
Return values
CarbonInterface —addMicros()
public
addMicros(int $value = 1) : CarbonInterface
Add microseconds (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMicrosecond()
public
addMicrosecond() : CarbonInterface
Add one microsecond to the instance (using date interval).
Return values
CarbonInterface —addMicroseconds()
public
addMicroseconds(int $value = 1) : CarbonInterface
Add microseconds (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMillennia()
public
addMillennia(int $value = 1) : CarbonInterface
Add millennia (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMillenniaNoOverflow()
public
addMillenniaNoOverflow(int $value = 1) : CarbonInterface
Add millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMillenniaWithNoOverflow()
public
addMillenniaWithNoOverflow(int $value = 1) : CarbonInterface
Add millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMillenniaWithoutOverflow()
public
addMillenniaWithoutOverflow(int $value = 1) : CarbonInterface
Add millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMillenniaWithOverflow()
public
addMillenniaWithOverflow(int $value = 1) : CarbonInterface
Add millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMillennium()
public
addMillennium() : CarbonInterface
Add one millennium to the instance (using date interval).
Return values
CarbonInterface —addMillenniumNoOverflow()
public
addMillenniumNoOverflow() : CarbonInterface
Add one millennium to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addMillenniumWithNoOverflow()
public
addMillenniumWithNoOverflow() : CarbonInterface
Add one millennium to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addMillenniumWithoutOverflow()
public
addMillenniumWithoutOverflow() : CarbonInterface
Add one millennium to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addMillenniumWithOverflow()
public
addMillenniumWithOverflow() : CarbonInterface
Add one millennium to the instance (using date interval) with overflow explicitly allowed.
Return values
CarbonInterface —addMilli()
public
addMilli() : CarbonInterface
Add one millisecond to the instance (using date interval).
Return values
CarbonInterface —addMillis()
public
addMillis(int $value = 1) : CarbonInterface
Add milliseconds (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMillisecond()
public
addMillisecond() : CarbonInterface
Add one millisecond to the instance (using date interval).
Return values
CarbonInterface —addMilliseconds()
public
addMilliseconds(int $value = 1) : CarbonInterface
Add milliseconds (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMinute()
public
addMinute() : CarbonInterface
Add one minute to the instance (using date interval).
Return values
CarbonInterface —addMinutes()
public
addMinutes(int $value = 1) : CarbonInterface
Add minutes (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMonth()
public
addMonth() : CarbonInterface
Add one month to the instance (using date interval).
Return values
CarbonInterface —addMonthNoOverflow()
public
addMonthNoOverflow() : CarbonInterface
Add one month to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addMonths()
public
addMonths(int $value = 1) : CarbonInterface
Add months (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMonthsNoOverflow()
public
addMonthsNoOverflow(int $value = 1) : CarbonInterface
Add months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMonthsWithNoOverflow()
public
addMonthsWithNoOverflow(int $value = 1) : CarbonInterface
Add months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMonthsWithoutOverflow()
public
addMonthsWithoutOverflow(int $value = 1) : CarbonInterface
Add months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMonthsWithOverflow()
public
addMonthsWithOverflow(int $value = 1) : CarbonInterface
Add months (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addMonthWithNoOverflow()
public
addMonthWithNoOverflow() : CarbonInterface
Add one month to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addMonthWithoutOverflow()
public
addMonthWithoutOverflow() : CarbonInterface
Add one month to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addMonthWithOverflow()
public
addMonthWithOverflow() : CarbonInterface
Add one month to the instance (using date interval) with overflow explicitly allowed.
Return values
CarbonInterface —addQuarter()
public
addQuarter() : CarbonInterface
Add one quarter to the instance (using date interval).
Return values
CarbonInterface —addQuarterNoOverflow()
public
addQuarterNoOverflow() : CarbonInterface
Add one quarter to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addQuarters()
public
addQuarters(int $value = 1) : CarbonInterface
Add quarters (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addQuartersNoOverflow()
public
addQuartersNoOverflow(int $value = 1) : CarbonInterface
Add quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addQuartersWithNoOverflow()
public
addQuartersWithNoOverflow(int $value = 1) : CarbonInterface
Add quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addQuartersWithoutOverflow()
public
addQuartersWithoutOverflow(int $value = 1) : CarbonInterface
Add quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addQuartersWithOverflow()
public
addQuartersWithOverflow(int $value = 1) : CarbonInterface
Add quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addQuarterWithNoOverflow()
public
addQuarterWithNoOverflow() : CarbonInterface
Add one quarter to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addQuarterWithoutOverflow()
public
addQuarterWithoutOverflow() : CarbonInterface
Add one quarter to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addQuarterWithOverflow()
public
addQuarterWithOverflow() : CarbonInterface
Add one quarter to the instance (using date interval) with overflow explicitly allowed.
Return values
CarbonInterface —addRealCenturies()
public
addRealCenturies(int $value = 1) : CarbonInterface
Add centuries (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealCentury()
public
addRealCentury() : CarbonInterface
Add one century to the instance (using timestamp).
Return values
CarbonInterface —addRealDay()
public
addRealDay() : CarbonInterface
Add one day to the instance (using timestamp).
Return values
CarbonInterface —addRealDays()
public
addRealDays(int $value = 1) : CarbonInterface
Add days (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealDecade()
public
addRealDecade() : CarbonInterface
Add one decade to the instance (using timestamp).
Return values
CarbonInterface —addRealDecades()
public
addRealDecades(int $value = 1) : CarbonInterface
Add decades (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealHour()
public
addRealHour() : CarbonInterface
Add one hour to the instance (using timestamp).
Return values
CarbonInterface —addRealHours()
public
addRealHours(int $value = 1) : CarbonInterface
Add hours (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealMicro()
public
addRealMicro() : CarbonInterface
Add one microsecond to the instance (using timestamp).
Return values
CarbonInterface —addRealMicros()
public
addRealMicros(int $value = 1) : CarbonInterface
Add microseconds (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealMicrosecond()
public
addRealMicrosecond() : CarbonInterface
Add one microsecond to the instance (using timestamp).
Return values
CarbonInterface —addRealMicroseconds()
public
addRealMicroseconds(int $value = 1) : CarbonInterface
Add microseconds (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealMillennia()
public
addRealMillennia(int $value = 1) : CarbonInterface
Add millennia (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealMillennium()
public
addRealMillennium() : CarbonInterface
Add one millennium to the instance (using timestamp).
Return values
CarbonInterface —addRealMilli()
public
addRealMilli() : CarbonInterface
Add one millisecond to the instance (using timestamp).
Return values
CarbonInterface —addRealMillis()
public
addRealMillis(int $value = 1) : CarbonInterface
Add milliseconds (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealMillisecond()
public
addRealMillisecond() : CarbonInterface
Add one millisecond to the instance (using timestamp).
Return values
CarbonInterface —addRealMilliseconds()
public
addRealMilliseconds(int $value = 1) : CarbonInterface
Add milliseconds (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealMinute()
public
addRealMinute() : CarbonInterface
Add one minute to the instance (using timestamp).
Return values
CarbonInterface —addRealMinutes()
public
addRealMinutes(int $value = 1) : CarbonInterface
Add minutes (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealMonth()
public
addRealMonth() : CarbonInterface
Add one month to the instance (using timestamp).
Return values
CarbonInterface —addRealMonths()
public
addRealMonths(int $value = 1) : CarbonInterface
Add months (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealQuarter()
public
addRealQuarter() : CarbonInterface
Add one quarter to the instance (using timestamp).
Return values
CarbonInterface —addRealQuarters()
public
addRealQuarters(int $value = 1) : CarbonInterface
Add quarters (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealSecond()
public
addRealSecond() : CarbonInterface
Add one second to the instance (using timestamp).
Return values
CarbonInterface —addRealSeconds()
public
addRealSeconds(int $value = 1) : CarbonInterface
Add seconds (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealWeek()
public
addRealWeek() : CarbonInterface
Add one week to the instance (using timestamp).
Return values
CarbonInterface —addRealWeeks()
public
addRealWeeks(int $value = 1) : CarbonInterface
Add weeks (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addRealYear()
public
addRealYear() : CarbonInterface
Add one year to the instance (using timestamp).
Return values
CarbonInterface —addRealYears()
public
addRealYears(int $value = 1) : CarbonInterface
Add years (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addSecond()
public
addSecond() : CarbonInterface
Add one second to the instance (using date interval).
Return values
CarbonInterface —addSeconds()
public
addSeconds(int $value = 1) : CarbonInterface
Add seconds (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —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() : CarbonInterface
Add one week to the instance (using date interval).
Return values
CarbonInterface —addWeekday()
public
addWeekday() : CarbonInterface
Add one weekday to the instance (using date interval).
Return values
CarbonInterface —addWeekdays()
public
addWeekdays(int $value = 1) : CarbonInterface
Add weekdays (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addWeeks()
public
addWeeks(int $value = 1) : CarbonInterface
Add weeks (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addYear()
public
addYear() : CarbonInterface
Add one year to the instance (using date interval).
Return values
CarbonInterface —addYearNoOverflow()
public
addYearNoOverflow() : CarbonInterface
Add one year to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addYears()
public
addYears(int $value = 1) : CarbonInterface
Add years (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —addYearsNoOverflow()
public
addYearsNoOverflow(int $value = 1) : CarbonInterface
Add years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addYearsWithNoOverflow()
public
addYearsWithNoOverflow(int $value = 1) : CarbonInterface
Add years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addYearsWithoutOverflow()
public
addYearsWithoutOverflow(int $value = 1) : CarbonInterface
Add years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addYearsWithOverflow()
public
addYearsWithOverflow(int $value = 1) : CarbonInterface
Add years (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
Parameters
- $value = 1 : int
Return values
CarbonInterface —addYearWithNoOverflow()
public
addYearWithNoOverflow() : CarbonInterface
Add one year to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addYearWithoutOverflow()
public
addYearWithoutOverflow() : CarbonInterface
Add one year to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —addYearWithOverflow()
public
addYearWithOverflow() : CarbonInterface
Add one year to the instance (using date interval) with overflow explicitly allowed.
Return values
CarbonInterface —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) : CarbonInterface
Ceil the current instance century with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilCentury()
public
ceilCentury(float $precision = 1) : CarbonInterface
Ceil the current instance century with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilDay()
public
ceilDay(float $precision = 1) : CarbonInterface
Ceil the current instance day with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilDays()
public
ceilDays(float $precision = 1) : CarbonInterface
Ceil the current instance day with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilDecade()
public
ceilDecade(float $precision = 1) : CarbonInterface
Ceil the current instance decade with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilDecades()
public
ceilDecades(float $precision = 1) : CarbonInterface
Ceil the current instance decade with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilHour()
public
ceilHour(float $precision = 1) : CarbonInterface
Ceil the current instance hour with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilHours()
public
ceilHours(float $precision = 1) : CarbonInterface
Ceil the current instance hour with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilMicrosecond()
public
ceilMicrosecond(float $precision = 1) : CarbonInterface
Ceil the current instance microsecond with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilMicroseconds()
public
ceilMicroseconds(float $precision = 1) : CarbonInterface
Ceil the current instance microsecond with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilMillennia()
public
ceilMillennia(float $precision = 1) : CarbonInterface
Ceil the current instance millennium with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilMillennium()
public
ceilMillennium(float $precision = 1) : CarbonInterface
Ceil the current instance millennium with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilMillisecond()
public
ceilMillisecond(float $precision = 1) : CarbonInterface
Ceil the current instance millisecond with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilMilliseconds()
public
ceilMilliseconds(float $precision = 1) : CarbonInterface
Ceil the current instance millisecond with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilMinute()
public
ceilMinute(float $precision = 1) : CarbonInterface
Ceil the current instance minute with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilMinutes()
public
ceilMinutes(float $precision = 1) : CarbonInterface
Ceil the current instance minute with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilMonth()
public
ceilMonth(float $precision = 1) : CarbonInterface
Ceil the current instance month with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilMonths()
public
ceilMonths(float $precision = 1) : CarbonInterface
Ceil the current instance month with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilQuarter()
public
ceilQuarter(float $precision = 1) : CarbonInterface
Ceil the current instance quarter with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilQuarters()
public
ceilQuarters(float $precision = 1) : CarbonInterface
Ceil the current instance quarter with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilSecond()
public
ceilSecond(float $precision = 1) : CarbonInterface
Ceil the current instance second with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilSeconds()
public
ceilSeconds(float $precision = 1) : CarbonInterface
Ceil the current instance second with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilYear()
public
ceilYear(float $precision = 1) : CarbonInterface
Ceil the current instance year with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —ceilYears()
public
ceilYears(float $precision = 1) : CarbonInterface
Ceil the current instance year with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —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
Return values
static —copy()
Get a copy of the instance.
public
copy() : static
Return values
static —day()
public
day(int $value) : CarbonInterface
Set current instance day to the given value.
Parameters
- $value : int
Return values
CarbonInterface —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) : CarbonInterface
Set current instance day to the given value.
Parameters
- $value : int
Return values
CarbonInterface —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) : CarbonInterface
Truncate the current instance century with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorCentury()
public
floorCentury(float $precision = 1) : CarbonInterface
Truncate the current instance century with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorDay()
public
floorDay(float $precision = 1) : CarbonInterface
Truncate the current instance day with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorDays()
public
floorDays(float $precision = 1) : CarbonInterface
Truncate the current instance day with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorDecade()
public
floorDecade(float $precision = 1) : CarbonInterface
Truncate the current instance decade with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorDecades()
public
floorDecades(float $precision = 1) : CarbonInterface
Truncate the current instance decade with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorHour()
public
floorHour(float $precision = 1) : CarbonInterface
Truncate the current instance hour with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorHours()
public
floorHours(float $precision = 1) : CarbonInterface
Truncate the current instance hour with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorMicrosecond()
public
floorMicrosecond(float $precision = 1) : CarbonInterface
Truncate the current instance microsecond with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorMicroseconds()
public
floorMicroseconds(float $precision = 1) : CarbonInterface
Truncate the current instance microsecond with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorMillennia()
public
floorMillennia(float $precision = 1) : CarbonInterface
Truncate the current instance millennium with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorMillennium()
public
floorMillennium(float $precision = 1) : CarbonInterface
Truncate the current instance millennium with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorMillisecond()
public
floorMillisecond(float $precision = 1) : CarbonInterface
Truncate the current instance millisecond with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorMilliseconds()
public
floorMilliseconds(float $precision = 1) : CarbonInterface
Truncate the current instance millisecond with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorMinute()
public
floorMinute(float $precision = 1) : CarbonInterface
Truncate the current instance minute with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorMinutes()
public
floorMinutes(float $precision = 1) : CarbonInterface
Truncate the current instance minute with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorMonth()
public
floorMonth(float $precision = 1) : CarbonInterface
Truncate the current instance month with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorMonths()
public
floorMonths(float $precision = 1) : CarbonInterface
Truncate the current instance month with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorQuarter()
public
floorQuarter(float $precision = 1) : CarbonInterface
Truncate the current instance quarter with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorQuarters()
public
floorQuarters(float $precision = 1) : CarbonInterface
Truncate the current instance quarter with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorSecond()
public
floorSecond(float $precision = 1) : CarbonInterface
Truncate the current instance second with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorSeconds()
public
floorSeconds(float $precision = 1) : CarbonInterface
Truncate the current instance second with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorYear()
public
floorYear(float $precision = 1) : CarbonInterface
Truncate the current instance year with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —floorYears()
public
floorYears(float $precision = 1) : CarbonInterface
Truncate the current instance year with given precision.
Parameters
- $precision = 1 : float
Return values
CarbonInterface —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
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 —getTimezone()
Get the TimeZone associated with the Carbon instance (as CarbonTimeZone).
public
getTimezone() : CarbonTimeZone
Tags
Return values
CarbonTimeZone —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) : CarbonInterface
Set current instance hour to the given value.
Parameters
- $value : int
Return values
CarbonInterface —hours()
public
hours(int $value) : CarbonInterface
Set current instance hour to the given value.
Parameters
- $value : int
Return values
CarbonInterface —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 —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) : CarbonInterface
Set current instance microsecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —micros()
public
micros(int $value) : CarbonInterface
Set current instance microsecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —microsecond()
public
microsecond(int $value) : CarbonInterface
Set current instance microsecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —microseconds()
public
microseconds(int $value) : CarbonInterface
Set current instance microsecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —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) : CarbonInterface
Set current instance millisecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —millis()
public
millis(int $value) : CarbonInterface
Set current instance millisecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —millisecond()
public
millisecond(int $value) : CarbonInterface
Set current instance millisecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —milliseconds()
public
milliseconds(int $value) : CarbonInterface
Set current instance millisecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —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) : CarbonInterface
Set current instance minute to the given value.
Parameters
- $value : int
Return values
CarbonInterface —minutes()
public
minutes(int $value) : CarbonInterface
Set current instance minute to the given value.
Parameters
- $value : int
Return values
CarbonInterface —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) : CarbonInterface
Set current instance month to the given value.
Parameters
- $value : int
Return values
CarbonInterface —months()
public
months(int $value) : CarbonInterface
Set current instance month to the given value.
Parameters
- $value : int
Return values
CarbonInterface —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") : CarbonInterface
Round the current instance century with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundCentury()
public
roundCentury(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance century with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundDay()
public
roundDay(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance day with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundDays()
public
roundDays(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance day with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundDecade()
public
roundDecade(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance decade with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundDecades()
public
roundDecades(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance decade with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundHour()
public
roundHour(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance hour with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundHours()
public
roundHours(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance hour with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundMicrosecond()
public
roundMicrosecond(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance microsecond with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundMicroseconds()
public
roundMicroseconds(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance microsecond with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundMillennia()
public
roundMillennia(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance millennium with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundMillennium()
public
roundMillennium(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance millennium with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundMillisecond()
public
roundMillisecond(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance millisecond with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundMilliseconds()
public
roundMilliseconds(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance millisecond with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundMinute()
public
roundMinute(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance minute with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundMinutes()
public
roundMinutes(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance minute with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundMonth()
public
roundMonth(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance month with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundMonths()
public
roundMonths(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance month with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundQuarter()
public
roundQuarter(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance quarter with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundQuarters()
public
roundQuarters(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance quarter with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundSecond()
public
roundSecond(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance second with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundSeconds()
public
roundSeconds(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance second with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundYear()
public
roundYear(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance year with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —roundYears()
public
roundYears(float $precision = 1, string $function = "round") : CarbonInterface
Round the current instance year with given precision using the given function.
Parameters
- $precision = 1 : float
- $function = "round" : string
Return values
CarbonInterface —second()
public
second(int $value) : CarbonInterface
Set current instance second to the given value.
Parameters
- $value : int
Return values
CarbonInterface —seconds()
public
seconds(int $value) : CarbonInterface
Set current instance second to the given value.
Parameters
- $value : int
Return values
CarbonInterface —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
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
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) : CarbonInterface
Set current instance day to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setDays()
public
setDays(int $value) : CarbonInterface
Set current instance day to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setHour()
public
setHour(int $value) : CarbonInterface
Set current instance hour to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setHours()
public
setHours(int $value) : CarbonInterface
Set current instance hour to the given value.
Parameters
- $value : int
Return values
CarbonInterface —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
Return values
static —setMicro()
public
setMicro(int $value) : CarbonInterface
Set current instance microsecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setMicros()
public
setMicros(int $value) : CarbonInterface
Set current instance microsecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setMicrosecond()
public
setMicrosecond(int $value) : CarbonInterface
Set current instance microsecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setMicroseconds()
public
setMicroseconds(int $value) : CarbonInterface
Set current instance microsecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setMilli()
public
setMilli(int $value) : CarbonInterface
Set current instance millisecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setMillis()
public
setMillis(int $value) : CarbonInterface
Set current instance millisecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setMillisecond()
public
setMillisecond(int $value) : CarbonInterface
Set current instance millisecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setMilliseconds()
public
setMilliseconds(int $value) : CarbonInterface
Set current instance millisecond to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setMinute()
public
setMinute(int $value) : CarbonInterface
Set current instance minute to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setMinutes()
public
setMinutes(int $value) : CarbonInterface
Set current instance minute to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setMonth()
public
setMonth(int $value) : CarbonInterface
Set current instance month to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setMonths()
public
setMonths(int $value) : CarbonInterface
Set current instance month to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setSecond()
public
setSecond(int $value) : CarbonInterface
Set current instance second to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setSeconds()
public
setSeconds(int $value) : CarbonInterface
Set current instance second to the given value.
Parameters
- $value : int
Return values
CarbonInterface —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
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 —setTimestamp()
Sets the date and time based on an Unix timestamp.
public
setTimestamp(int $unixtimestamp) : static
Parameters
- $unixtimestamp : int
Tags
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
Return values
mixed —setWeekendDays()
public
static setWeekendDays(array<string|int, mixed> $days) : void
Parameters
- $days : array<string|int, mixed>
Tags
Return values
void —setWeekEndsAt()
public
static setWeekEndsAt(int $day) : void
Parameters
- $day : int
Tags
Return values
void —setWeekStartsAt()
public
static setWeekStartsAt(int $day) : void
Parameters
- $day : int
-
week start day
Tags
Return values
void —setYear()
public
setYear(int $value) : CarbonInterface
Set current instance year to the given value.
Parameters
- $value : int
Return values
CarbonInterface —setYears()
public
setYears(int $value) : CarbonInterface
Set current instance year to the given value.
Parameters
- $value : int
Return values
CarbonInterface —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) : CarbonInterface
Sub centuries (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subCenturiesNoOverflow()
public
subCenturiesNoOverflow(int $value = 1) : CarbonInterface
Sub centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subCenturiesWithNoOverflow()
public
subCenturiesWithNoOverflow(int $value = 1) : CarbonInterface
Sub centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subCenturiesWithoutOverflow()
public
subCenturiesWithoutOverflow(int $value = 1) : CarbonInterface
Sub centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subCenturiesWithOverflow()
public
subCenturiesWithOverflow(int $value = 1) : CarbonInterface
Sub centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subCentury()
public
subCentury() : CarbonInterface
Sub one century to the instance (using date interval).
Return values
CarbonInterface —subCenturyNoOverflow()
public
subCenturyNoOverflow() : CarbonInterface
Sub one century to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subCenturyWithNoOverflow()
public
subCenturyWithNoOverflow() : CarbonInterface
Sub one century to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subCenturyWithoutOverflow()
public
subCenturyWithoutOverflow() : CarbonInterface
Sub one century to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subCenturyWithOverflow()
public
subCenturyWithOverflow() : CarbonInterface
Sub one century to the instance (using date interval) with overflow explicitly allowed.
Return values
CarbonInterface —subDay()
public
subDay() : CarbonInterface
Sub one day to the instance (using date interval).
Return values
CarbonInterface —subDays()
public
subDays(int $value = 1) : CarbonInterface
Sub days (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subDecade()
public
subDecade() : CarbonInterface
Sub one decade to the instance (using date interval).
Return values
CarbonInterface —subDecadeNoOverflow()
public
subDecadeNoOverflow() : CarbonInterface
Sub one decade to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subDecades()
public
subDecades(int $value = 1) : CarbonInterface
Sub decades (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subDecadesNoOverflow()
public
subDecadesNoOverflow(int $value = 1) : CarbonInterface
Sub decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subDecadesWithNoOverflow()
public
subDecadesWithNoOverflow(int $value = 1) : CarbonInterface
Sub decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subDecadesWithoutOverflow()
public
subDecadesWithoutOverflow(int $value = 1) : CarbonInterface
Sub decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subDecadesWithOverflow()
public
subDecadesWithOverflow(int $value = 1) : CarbonInterface
Sub decades (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subDecadeWithNoOverflow()
public
subDecadeWithNoOverflow() : CarbonInterface
Sub one decade to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subDecadeWithoutOverflow()
public
subDecadeWithoutOverflow() : CarbonInterface
Sub one decade to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subDecadeWithOverflow()
public
subDecadeWithOverflow() : CarbonInterface
Sub one decade to the instance (using date interval) with overflow explicitly allowed.
Return values
CarbonInterface —subHour()
public
subHour() : CarbonInterface
Sub one hour to the instance (using date interval).
Return values
CarbonInterface —subHours()
public
subHours(int $value = 1) : CarbonInterface
Sub hours (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMicro()
public
subMicro() : CarbonInterface
Sub one microsecond to the instance (using date interval).
Return values
CarbonInterface —subMicros()
public
subMicros(int $value = 1) : CarbonInterface
Sub microseconds (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMicrosecond()
public
subMicrosecond() : CarbonInterface
Sub one microsecond to the instance (using date interval).
Return values
CarbonInterface —subMicroseconds()
public
subMicroseconds(int $value = 1) : CarbonInterface
Sub microseconds (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMillennia()
public
subMillennia(int $value = 1) : CarbonInterface
Sub millennia (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMillenniaNoOverflow()
public
subMillenniaNoOverflow(int $value = 1) : CarbonInterface
Sub millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMillenniaWithNoOverflow()
public
subMillenniaWithNoOverflow(int $value = 1) : CarbonInterface
Sub millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMillenniaWithoutOverflow()
public
subMillenniaWithoutOverflow(int $value = 1) : CarbonInterface
Sub millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMillenniaWithOverflow()
public
subMillenniaWithOverflow(int $value = 1) : CarbonInterface
Sub millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMillennium()
public
subMillennium() : CarbonInterface
Sub one millennium to the instance (using date interval).
Return values
CarbonInterface —subMillenniumNoOverflow()
public
subMillenniumNoOverflow() : CarbonInterface
Sub one millennium to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subMillenniumWithNoOverflow()
public
subMillenniumWithNoOverflow() : CarbonInterface
Sub one millennium to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subMillenniumWithoutOverflow()
public
subMillenniumWithoutOverflow() : CarbonInterface
Sub one millennium to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subMillenniumWithOverflow()
public
subMillenniumWithOverflow() : CarbonInterface
Sub one millennium to the instance (using date interval) with overflow explicitly allowed.
Return values
CarbonInterface —subMilli()
public
subMilli() : CarbonInterface
Sub one millisecond to the instance (using date interval).
Return values
CarbonInterface —subMillis()
public
subMillis(int $value = 1) : CarbonInterface
Sub milliseconds (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMillisecond()
public
subMillisecond() : CarbonInterface
Sub one millisecond to the instance (using date interval).
Return values
CarbonInterface —subMilliseconds()
public
subMilliseconds(int $value = 1) : CarbonInterface
Sub milliseconds (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMinute()
public
subMinute() : CarbonInterface
Sub one minute to the instance (using date interval).
Return values
CarbonInterface —subMinutes()
public
subMinutes(int $value = 1) : CarbonInterface
Sub minutes (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMonth()
public
subMonth() : CarbonInterface
Sub one month to the instance (using date interval).
Return values
CarbonInterface —subMonthNoOverflow()
public
subMonthNoOverflow() : CarbonInterface
Sub one month to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subMonths()
public
subMonths(int $value = 1) : CarbonInterface
Sub months (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMonthsNoOverflow()
public
subMonthsNoOverflow(int $value = 1) : CarbonInterface
Sub months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMonthsWithNoOverflow()
public
subMonthsWithNoOverflow(int $value = 1) : CarbonInterface
Sub months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMonthsWithoutOverflow()
public
subMonthsWithoutOverflow(int $value = 1) : CarbonInterface
Sub months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMonthsWithOverflow()
public
subMonthsWithOverflow(int $value = 1) : CarbonInterface
Sub months (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subMonthWithNoOverflow()
public
subMonthWithNoOverflow() : CarbonInterface
Sub one month to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subMonthWithoutOverflow()
public
subMonthWithoutOverflow() : CarbonInterface
Sub one month to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subMonthWithOverflow()
public
subMonthWithOverflow() : CarbonInterface
Sub one month to the instance (using date interval) with overflow explicitly allowed.
Return values
CarbonInterface —subQuarter()
public
subQuarter() : CarbonInterface
Sub one quarter to the instance (using date interval).
Return values
CarbonInterface —subQuarterNoOverflow()
public
subQuarterNoOverflow() : CarbonInterface
Sub one quarter to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subQuarters()
public
subQuarters(int $value = 1) : CarbonInterface
Sub quarters (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subQuartersNoOverflow()
public
subQuartersNoOverflow(int $value = 1) : CarbonInterface
Sub quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subQuartersWithNoOverflow()
public
subQuartersWithNoOverflow(int $value = 1) : CarbonInterface
Sub quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subQuartersWithoutOverflow()
public
subQuartersWithoutOverflow(int $value = 1) : CarbonInterface
Sub quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subQuartersWithOverflow()
public
subQuartersWithOverflow(int $value = 1) : CarbonInterface
Sub quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subQuarterWithNoOverflow()
public
subQuarterWithNoOverflow() : CarbonInterface
Sub one quarter to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subQuarterWithoutOverflow()
public
subQuarterWithoutOverflow() : CarbonInterface
Sub one quarter to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subQuarterWithOverflow()
public
subQuarterWithOverflow() : CarbonInterface
Sub one quarter to the instance (using date interval) with overflow explicitly allowed.
Return values
CarbonInterface —subRealCenturies()
public
subRealCenturies(int $value = 1) : CarbonInterface
Sub centuries (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealCentury()
public
subRealCentury() : CarbonInterface
Sub one century to the instance (using timestamp).
Return values
CarbonInterface —subRealDay()
public
subRealDay() : CarbonInterface
Sub one day to the instance (using timestamp).
Return values
CarbonInterface —subRealDays()
public
subRealDays(int $value = 1) : CarbonInterface
Sub days (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealDecade()
public
subRealDecade() : CarbonInterface
Sub one decade to the instance (using timestamp).
Return values
CarbonInterface —subRealDecades()
public
subRealDecades(int $value = 1) : CarbonInterface
Sub decades (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealHour()
public
subRealHour() : CarbonInterface
Sub one hour to the instance (using timestamp).
Return values
CarbonInterface —subRealHours()
public
subRealHours(int $value = 1) : CarbonInterface
Sub hours (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealMicro()
public
subRealMicro() : CarbonInterface
Sub one microsecond to the instance (using timestamp).
Return values
CarbonInterface —subRealMicros()
public
subRealMicros(int $value = 1) : CarbonInterface
Sub microseconds (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealMicrosecond()
public
subRealMicrosecond() : CarbonInterface
Sub one microsecond to the instance (using timestamp).
Return values
CarbonInterface —subRealMicroseconds()
public
subRealMicroseconds(int $value = 1) : CarbonInterface
Sub microseconds (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealMillennia()
public
subRealMillennia(int $value = 1) : CarbonInterface
Sub millennia (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealMillennium()
public
subRealMillennium() : CarbonInterface
Sub one millennium to the instance (using timestamp).
Return values
CarbonInterface —subRealMilli()
public
subRealMilli() : CarbonInterface
Sub one millisecond to the instance (using timestamp).
Return values
CarbonInterface —subRealMillis()
public
subRealMillis(int $value = 1) : CarbonInterface
Sub milliseconds (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealMillisecond()
public
subRealMillisecond() : CarbonInterface
Sub one millisecond to the instance (using timestamp).
Return values
CarbonInterface —subRealMilliseconds()
public
subRealMilliseconds(int $value = 1) : CarbonInterface
Sub milliseconds (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealMinute()
public
subRealMinute() : CarbonInterface
Sub one minute to the instance (using timestamp).
Return values
CarbonInterface —subRealMinutes()
public
subRealMinutes(int $value = 1) : CarbonInterface
Sub minutes (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealMonth()
public
subRealMonth() : CarbonInterface
Sub one month to the instance (using timestamp).
Return values
CarbonInterface —subRealMonths()
public
subRealMonths(int $value = 1) : CarbonInterface
Sub months (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealQuarter()
public
subRealQuarter() : CarbonInterface
Sub one quarter to the instance (using timestamp).
Return values
CarbonInterface —subRealQuarters()
public
subRealQuarters(int $value = 1) : CarbonInterface
Sub quarters (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealSecond()
public
subRealSecond() : CarbonInterface
Sub one second to the instance (using timestamp).
Return values
CarbonInterface —subRealSeconds()
public
subRealSeconds(int $value = 1) : CarbonInterface
Sub seconds (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealWeek()
public
subRealWeek() : CarbonInterface
Sub one week to the instance (using timestamp).
Return values
CarbonInterface —subRealWeeks()
public
subRealWeeks(int $value = 1) : CarbonInterface
Sub weeks (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subRealYear()
public
subRealYear() : CarbonInterface
Sub one year to the instance (using timestamp).
Return values
CarbonInterface —subRealYears()
public
subRealYears(int $value = 1) : CarbonInterface
Sub years (the $value count passed in) to the instance (using timestamp).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subSecond()
public
subSecond() : CarbonInterface
Sub one second to the instance (using date interval).
Return values
CarbonInterface —subSeconds()
public
subSeconds(int $value = 1) : CarbonInterface
Sub seconds (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —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() : CarbonInterface
Sub one week to the instance (using date interval).
Return values
CarbonInterface —subWeekday()
public
subWeekday() : CarbonInterface
Sub one weekday to the instance (using date interval).
Return values
CarbonInterface —subWeekdays()
public
subWeekdays(int $value = 1) : CarbonInterface
Sub weekdays (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subWeeks()
public
subWeeks(int $value = 1) : CarbonInterface
Sub weeks (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subYear()
public
subYear() : CarbonInterface
Sub one year to the instance (using date interval).
Return values
CarbonInterface —subYearNoOverflow()
public
subYearNoOverflow() : CarbonInterface
Sub one year to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subYears()
public
subYears(int $value = 1) : CarbonInterface
Sub years (the $value count passed in) to the instance (using date interval).
Parameters
- $value = 1 : int
Return values
CarbonInterface —subYearsNoOverflow()
public
subYearsNoOverflow(int $value = 1) : CarbonInterface
Sub years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subYearsWithNoOverflow()
public
subYearsWithNoOverflow(int $value = 1) : CarbonInterface
Sub years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subYearsWithoutOverflow()
public
subYearsWithoutOverflow(int $value = 1) : CarbonInterface
Sub years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subYearsWithOverflow()
public
subYearsWithOverflow(int $value = 1) : CarbonInterface
Sub years (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
Parameters
- $value = 1 : int
Return values
CarbonInterface —subYearWithNoOverflow()
public
subYearWithNoOverflow() : CarbonInterface
Sub one year to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subYearWithoutOverflow()
public
subYearWithoutOverflow() : CarbonInterface
Sub one year to the instance (using date interval) with overflow explicitly forbidden.
Return values
CarbonInterface —subYearWithOverflow()
public
subYearWithOverflow() : CarbonInterface
Sub one year to the instance (using date interval) with overflow explicitly allowed.
Return values
CarbonInterface —timezone()
public
timezone(DateTimeZone|string $value) : static
Parameters
- $value : DateTimeZone|string
Tags
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) : CarbonInterface
Set current instance year to the given value.
Parameters
- $value : int
Return values
CarbonInterface —years()
public
years(int $value) : CarbonInterface
Set current instance year to the given value.
Parameters
- $value : int
Return values
CarbonInterface —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
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.