Interface Carbon\CarbonInterface

`extends`	`DateTimeInterface, JsonSerializable, DiffOptions, Format, TranslationOptions, UnitValue`


					
	public

__call(string $method, array $parameters): mixed

Dynamically handle calls to the class.

Parameters

`$method`	magic method name called
`$parameters`	parameters list

Throws

Carbon\Exceptions\UnknownMethodException|BadMethodCallException|ReflectionException|Throwable

#


					
	public
					static

__callStatic(string $method, array $parameters): mixed

Dynamically handle calls to the class.

Parameters

`$method`	magic method name called
`$parameters`	parameters list

Throws

BadMethodCallException

#


					
	public

__clone(): void

Update constructedObjectId on cloned.

Implemented by

Carbon\CarbonImmutable::__clone()

#


					
	public

__construct(
	DateTimeInterface|WeekDay|Month|string|int|float|null $time = null,
	DateTimeZone|string|int|null $timezone = null,
)

Create a new Carbon instance.

Please see the testing aids section (specifically static::setTestNow()) for more on the possibility of this constructor returning a test instance.

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public

__debugInfo(): array

Show truthy properties on var_dump().

#


					
	public

__get(string $name): string|int|bool|DateTimeZone|null

Get a part of the Carbon object.

Throws

Carbon\Exceptions\UnknownGetterException

#


					
	public

__isset(string $name): bool

Check if an attribute exists on the object

#


					
	public

__set(string $name, string|int|DateTimeZone $value): void

Set a part of the Carbon object

Throws

Carbon\Exceptions\UnknownSetterException|ReflectionException

#


					
	public
					static

__set_state(string|array $dump): static

The __set_state handler.

#


					
	public

__toString()

Format the instance as a string using the set format

#


					
	public

add(
	Unit|int|string|DateInterval|Closure|CarbonConverterInterface $unit,
	Unit|int|float|string $value = 1,
	bool|null $overflow = null,
): static

Add given units or interval to the current instance.

#


					
	public

addRealUnit(string $unit, int|float|null $value = 1): static

Deprecated

Prefer to use add addUTCUnit() which more accurately defines what it's doing.

#


					
	public

addUTCUnit(string $unit, int|float|null $value = 1): static

Add seconds to the instance using timestamp. Positive $value travels forward while negative $value travels into the…

Add seconds to the instance using timestamp. Positive $value travels forward while negative $value travels into the past.

#


					
	public

addUnit(Unit|string $unit, $value = 1, ?bool $overflow = null): static

Add given units to the current instance.

#


					
	public

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

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

Parameters

`$valueUnit`	unit name to modify
`$value`	amount to add to the input unit
`$overflowUnit`	unit name to not overflow

#


					
	public

ago(int|array $syntax = null, bool $short = false, int $parts = 1, int $options = null): string

Get the difference in a human readable format in the current locale from an other instance given to now

Parameters

`$syntax`	if array passed, parameters will be extracted from it, the array may contains: - 'syntax' entry (see below) - 'short' entry (see below) - 'parts' entry (see below) - 'options' entry (see below) - 'join' entry determines how to join multiple parts of the string `- if $join is a string, it's used as a joiner glue` - if $join is a callable/closure, it get the list of string and should return a string `- if $join is an array, the first item will be the default glue, and the second item` will be used instead of the glue for the last item `- if $join is true, it will be guessed from the locale ('list' translation file entry)` - if $join is missing, a space will be used as glue if int passed, it add modifiers: Possible values: - CarbonInterface::DIFF_ABSOLUTE no modifiers - CarbonInterface::DIFF_RELATIVE_TO_NOW add ago/from now modifier - CarbonInterface::DIFF_RELATIVE_TO_OTHER add before/after modifier Default value: CarbonInterface::DIFF_ABSOLUTE
`$short`	displays short format of time units
`$parts`	maximum number of parts to display (default value: 1: single part)
`$options`	human diff options

#


					
	public

average(Carbon|DateTimeInterface|null $date = null): static

Modify the current instance to the average of a given instance (default now) and the current instance (second-precision…

Modify the current instance to the average of a given instance (default now) and the current instance (second-precision).

#


					
	public

avoidMutation(): static

Clone the current instance if it's mutable.

This method is convenient to ensure you don't mutate the initial object but avoid to make a useless copy of it if it's already immutable.

#


					
	public

between(DateTimeInterface|string $date1, DateTimeInterface|string $date2, bool $equal = true): bool

Determines if the instance is between two others.

The third argument allow you to specify if bounds are included or not (true by default) but for when you including/excluding bounds may produce different results in your application, we recommend to use the explicit methods ->betweenIncluded() or ->betweenExcluded() instead.

Parameters

$equal

Indicates if an equal to comparison should be done

#


					
	public

betweenExcluded(DateTimeInterface|string $date1, DateTimeInterface|string $date2): bool

Determines if the instance is between two others, bounds excluded.

#


					
	public

betweenIncluded(DateTimeInterface|string $date1, DateTimeInterface|string $date2): bool

Determines if the instance is between two others, bounds included.

#


					
	public

calendar(Carbon|DateTimeInterface|string|null $referenceTime = null, array $formats = []): string

Returns either day of week + time (e.g. "Last Friday at 3:30 PM") if reference time is within 7 days, or a calendar…

Returns either day of week + time (e.g. "Last Friday at 3:30 PM") if reference time is within 7 days, or a calendar date (e.g. "10/29/2017") otherwise.

Language, date and time formats will change according to the current locale.

#


					
	public
					static

canBeCreatedFromFormat(?string $date, string $format): bool

Checks if the (date)time string is in a given format and valid to create a new instance.

#


					
	public

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

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

#


					
	public

cast<T>(class-string<T> $className): T

Cast the current instance into the given class.

Parameters

$className

The $className::instance() method will be called to cast the current object.

#


					
	public

ceil(DateInterval|string|int|float $precision = 1): static

Ceil the current instance second with given precision if specified.

#


					
	public

ceilUnit(string $unit, DateInterval|string|int|float $precision = 1): static

Ceil the current instance at the given unit with given precision if specified.

#


					
	public

ceilWeek(WeekDay|int|null $weekStartsAt = null): static

Ceil the current instance week.

Parameters

$weekStartsAt

optional start allow you to specify the day of week to use to start the week

#


					
	public

change(string $modifier): static

Similar to native modify() method of DateTime but can handle more grammars.

#


					
	public

cleanupDumpProperties()

Cleanup properties attached to the public scope of DateTime when a dump of the date is requested. foreach ($date as $_)…

Cleanup properties attached to the public scope of DateTime when a dump of the date is requested. foreach ($date as $_) {} serializer($date) var_export($date) get_object_vars($date)

#


					
	public

clone(): static

#


					
	public

closest(Carbon|DateTimeInterface|mixed $date1, Carbon|DateTimeInterface|mixed $date2): static

Get the closest date from the instance (second-precision).

#


					
	public

copy(): static

Get a copy of the instance.

#


					
	public
					static

create(
	DateTimeInterface|string|int|null $year = 0,
	int|null $month = 1,
	int|null $day = 1,
	int|null $hour = 0,
	int|null $minute = 0,
	int|null $second = 0,
	DateTimeZone|string|int|null $timezone = null,
): static|null

Create a new Carbon instance from a specific date and time.

If any of $year, $month or $day are set to null their now() values will be used.

If $hour is null it will be set to its now() value and the default values for $minute and $second will be their now() values.

If $hour is not null then the default values for $minute and $second will be 0.

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public
					static

createFromDate(
	int|null $year = null,
	int|null $month = null,
	int|null $day = null,
	DateTimeZone|string|int|null $timezone = null,
): static

Create a Carbon instance from just a date. The time portion is set to now.

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public
					static

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

Create a Carbon instance from a specific format.

Parameters

$format

Datetime format

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public
					static

createFromIsoFormat(
	string $format,
	string $time,
	DateTimeZone|string|int|null $timezone = null,
	string|null $locale = 'en',
	TranslatorInterface|null $translator = null,
): static|null

Create a Carbon instance from a specific ISO format (same replacements as ->isoFormat()).

Parameters

`$format`	Datetime format
`$timezone`	optional timezone
`$locale`	locale to be used for LTS, LT, LL, LLL, etc. macro-formats (en by fault, unneeded if no such macro-format in use)
`$translator`	optional custom translator to use for macro-formats

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public
					static

createFromLocaleFormat(
	string $format,
	string $locale,
	string $time,
	DateTimeZone|string|int|null $timezone = null,
): static|null

Create a Carbon instance from a specific format and a string in a given language.

Parameters

$format

Datetime format

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public
					static

createFromLocaleIsoFormat(
	string $format,
	string $locale,
	string $time,
	DateTimeZone|string|int|null $timezone = null,
): static|null

Create a Carbon instance from a specific ISO format and a string in a given language.

Parameters

$format

Datetime ISO format

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public
					static

createFromTime(
	int|null $hour = 0,
	int|null $minute = 0,
	int|null $second = 0,
	DateTimeZone|string|int|null $timezone = null,
): static

Create a Carbon instance from just a time. The date portion is set to today.

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public
					static

createFromTimeString(string $time, DateTimeZone|string|int|null $timezone = null): static

Create a Carbon instance from a time string. The date portion is set to today.

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public
					static

Create a Carbon instance from a timestamp and set the timezone (UTC by default).

Timestamp input can be given as int, float or a string containing one or more numbers.

#


					
	public
					static

Create a Carbon instance from a timestamp in milliseconds.

Timestamp input can be given as int, float or a string containing one or more numbers.

#


					
	public
					static

createFromTimestampMsUTC(float|int|string $timestamp): static

Create a Carbon instance from a timestamp in milliseconds.

Timestamp input can be given as int, float or a string containing one or more numbers.

#


					
	public
					static

createFromTimestampUTC(string|int|float $timestamp): static

Create a Carbon instance from a timestamp keeping the timezone to UTC.

Timestamp input can be given as int, float or a string containing one or more numbers.

#


					
	public
					static

createMidnightDate(
	int|null $year = null,
	int|null $month = null,
	int|null $day = null,
	DateTimeZone|string|int|null $timezone = null,
): static

Create a Carbon instance from just a date. The time portion is set to midnight.

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public
					static

createSafe(
	int|null $year = null,
	int|null $month = null,
	int|null $day = null,
	int|null $hour = null,
	int|null $minute = null,
	int|null $second = null,
	DateTimeZone|string|int|null $timezone = null,
): static|null

Create a new safe Carbon instance from a specific date and time.

If any of $year, $month or $day are set to null their now() values will be used.

If $hour is null it will be set to its now() value and the default values for $minute and $second will be their now() values.

If $hour is not null then the default values for $minute and $second will be 0.

If one of the set values is not valid, an InvalidDateException will be thrown.

Throws

Carbon\Exceptions\InvalidDateException

#


					
	public
					static

createStrict(
	int|null $year = 0,
	int|null $month = 1,
	int|null $day = 1,
	int|null $hour = 0,
	int|null $minute = 0,
	int|null $second = 0,
	DateTimeZone|string|int|null $timezone = null,
): static

Create a new Carbon instance from a specific date and time using strict validation.

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public

dayOfYear<T is int|null>(T $value = null): static|int

Get/set the day of year.

#


					
	public

diffAsCarbonInterval(
	CarbonInterface|DateTimeInterface|string|null $date = null,
	bool $absolute = false,
	array $skip = [],
): CarbonInterval

Get the difference as a CarbonInterval instance. Return relative interval (negative if $absolute flag is not set to…

Get the difference as a CarbonInterval instance. Return relative interval (negative if $absolute flag is not set to true and the given date is before current one).

Parameters

$absolute

Get the absolute of the difference

#


					
	public

diffAsDateInterval(CarbonInterface|DateTimeInterface|string|null $date = null, bool $absolute = false): DateInterval

Get the difference as a DateInterval instance. Return relative interval (negative if $absolute flag is not set to true…

Get the difference as a DateInterval instance. Return relative interval (negative if $absolute flag is not set to true and the given date is before current one).

Parameters

$absolute

Get the absolute of the difference

#


					
	public

diffFiltered(
	CarbonInterval $ci,
	Closure $callback,
	CarbonInterface|DateTimeInterface|string|null $date = null,
	bool $absolute = false,
): int

Get the difference by the given interval using a filter closure.

Parameters

`$ci`	An interval to traverse by
`$absolute`	Get the absolute of the difference

#


					
	public

diffForHumans(
	Carbon|DateTimeInterface|string|array|null $other = null,
	int|array $syntax = null,
	bool $short = false,
	int $parts = 1,
	int $options = null,
): string

Get the difference in a human readable format in the current locale from current instance to an other instance given …

Get the difference in a human readable format in the current locale from current instance to an other instance given (or now if null given).

Parameters

`$other`	if array passed, will be used as parameters array, see $syntax below; if null passed, now will be used as comparison reference; if any other type, it will be converted to date and used as reference.
`$syntax`	if array passed, parameters will be extracted from it, the array may contains: ⦿ 'syntax' entry (see below) ⦿ 'short' entry (see below) ⦿ 'parts' entry (see below) ⦿ 'options' entry (see below) ⦿ 'skip' entry, list of units to skip (array of strings or a single string, `it can be the unit name (singular or plural) or its shortcut` (y, m, w, d, h, min, s, ms, µs). ⦿ 'aUnit' entry, prefer "an hour" over "1 hour" if true ⦿ 'altNumbers' entry, use alternative numbers if available `(from the current language if true is passed, from the given language(s)` if array or string is passed) ⦿ 'join' entry determines how to join multiple parts of the string `- if $join is a string, it's used as a joiner glue` - if $join is a callable/closure, it get the list of string and should return a string `- if $join is an array, the first item will be the default glue, and the second item` will be used instead of the glue for the last item `- if $join is true, it will be guessed from the locale ('list' translation file entry)` - if $join is missing, a space will be used as glue ⦿ 'other' entry (see above) ⦿ 'minimumUnit' entry determines the smallest unit of time to display can be long or ` short form of the units, e.g. 'hour' or 'h' (default value: s) ⦿ 'locale' language in which the diff should be output (has no effect if 'translator' key is set) ⦿ 'translator' a custom translator to use to translator the output. if int passed, it adds modifiers: Possible values: - CarbonInterface::DIFF_ABSOLUTE no modifiers - CarbonInterface::DIFF_RELATIVE_TO_NOW add ago/from now modifier - CarbonInterface::DIFF_RELATIVE_TO_OTHER add before/after modifier Default value: CarbonInterface::DIFF_ABSOLUTE
`$short`	displays short format of time units
`$parts`	maximum number of parts to display (default value: 1: single unit)
`$options`	human diff options

#


					
	public

diffInDays(CarbonInterface|DateTimeInterface|string|null $date = null, bool $absolute = false, bool $utc = false): float

Get the difference in days.

Parameters

`$absolute`	Get the absolute of the difference
`$utc`	Always convert dates to UTC before comparing (if not set, it will do it only if timezones are different)

#


					
	public

diffInDaysFiltered(
	Closure $callback,
	CarbonInterface|DateTimeInterface|string|null $date = null,
	bool $absolute = false,
): int

Get the difference in days using a filter closure.

Parameters

$absolute

Get the absolute of the difference

#


					
	public

diffInHours(CarbonInterface|DateTimeInterface|string|null $date = null, bool $absolute = false): float

Get the difference in hours.

Parameters

$absolute

Get the absolute of the difference

#


					
	public

diffInHoursFiltered(
	Closure $callback,
	CarbonInterface|DateTimeInterface|string|null $date = null,
	bool $absolute = false,
): int

Get the difference in hours using a filter closure.

Parameters

$absolute

Get the absolute of the difference

#


					
	public

diffInMicroseconds(CarbonInterface|DateTimeInterface|string|null $date = null, bool $absolute = false): float

Get the difference in microseconds.

Parameters

$absolute

Get the absolute of the difference

#


					
	public

diffInMilliseconds(CarbonInterface|DateTimeInterface|string|null $date = null, bool $absolute = false): float

Get the difference in milliseconds.

Parameters

$absolute

Get the absolute of the difference

#


					
	public

diffInMinutes(CarbonInterface|DateTimeInterface|string|null $date = null, bool $absolute = false): float

Get the difference in minutes.

Parameters

$absolute

Get the absolute of the difference

#


					
	public

diffInMonths(
	CarbonInterface|DateTimeInterface|string|null $date = null,
	bool $absolute = false,
	bool $utc = false,
): float

Get the difference in months.

Parameters

`$absolute`	Get the absolute of the difference
`$utc`	Always convert dates to UTC before comparing (if not set, it will do it only if timezones are different)

#


					
	public

diffInQuarters(
	CarbonInterface|DateTimeInterface|string|null $date = null,
	bool $absolute = false,
	bool $utc = false,
): float

Get the difference in quarters.

Parameters

`$absolute`	Get the absolute of the difference
`$utc`	Always convert dates to UTC before comparing (if not set, it will do it only if timezones are different)

#


					
	public

diffInSeconds(CarbonInterface|DateTimeInterface|string|null $date = null, bool $absolute = false): float

Get the difference in seconds.

Parameters

$absolute

Get the absolute of the difference

#


					
	public

diffInUnit(
	Unit|string $unit,
	CarbonInterface|DateTimeInterface|string|null $date = null,
	bool $absolute = false,
	bool $utc = false,
): float

Parameters

`$unit`	microsecond, millisecond, second, minute, hour, day, week, month, quarter, year, century, millennium
`$absolute`	Get the absolute of the difference
`$utc`	Always convert dates to UTC before comparing (if not set, it will do it only if timezones are different)

#


					
	public

diffInWeekdays(CarbonInterface|DateTimeInterface|string|null $date = null, bool $absolute = false): int

Get the difference in weekdays.

Parameters

$absolute

Get the absolute of the difference

#


					
	public

diffInWeekendDays(CarbonInterface|DateTimeInterface|string|null $date = null, bool $absolute = false): int

Get the difference in weekend days using a filter.

Parameters

$absolute

Get the absolute of the difference

#


					
	public

diffInWeeks(
	CarbonInterface|DateTimeInterface|string|null $date = null,
	bool $absolute = false,
	bool $utc = false,
): float

Get the difference in weeks.

Parameters

`$absolute`	Get the absolute of the difference
`$utc`	Always convert dates to UTC before comparing (if not set, it will do it only if timezones are different)

#


					
	public

diffInYears(
	CarbonInterface|DateTimeInterface|string|null $date = null,
	bool $absolute = false,
	bool $utc = false,
): float

Get the difference in years

Parameters

`$absolute`	Get the absolute of the difference
`$utc`	Always convert dates to UTC before comparing (if not set, it will do it only if timezones are different)

#


					
	public
					static

disableHumanDiffOption(int $humanDiffOption): void

Deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather use the ->settings() method.

#


					
	public
					static

enableHumanDiffOption(int $humanDiffOption): void

Deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather use the ->settings() method.

#


					
	public

endOf(Unit|string $unit, mixed ...$params): static

Modify to end of current given unit.

#


					
	public

endOfCentury(): static

Resets the date to end of the century and time to 23:59:59.999999

#


					
	public

endOfDay(): static

Resets the time to 23:59:59.999999 end of day

#


					
	public

endOfDecade(): static

Resets the date to end of the decade and time to 23:59:59.999999

#


					
	public

endOfHour(): static

Modify to end of current hour, minutes and seconds become 59

#


					
	public

endOfMillennium(): static

Resets the date to end of the millennium and time to 23:59:59.999999

#


					
	public

endOfMillisecond(): static

Modify to end of current millisecond, microseconds such as 12345 become 123999

#


					
	public

endOfMinute(): static

Modify to end of current minute, seconds become 59

#


					
	public

endOfMonth(): static

Resets the date to end of the month and time to 23:59:59.999999

#


					
	public

endOfQuarter(): static

Resets the date to end of the quarter and time to 23:59:59.999999

#


					
	public

endOfSecond(): static

Modify to end of current second, microseconds become 999999

#


					
	public

endOfWeek(WeekDay|int|null $weekEndsAt = null): static

Resets the date to end of week (defined in $weekEndsAt) and time to 23:59:59.999999

Parameters

$weekEndsAt

optional end allow you to specify the day of week to use to end the week

#


					
	public

endOfYear(): static

Resets the date to end of the year and time to 23:59:59.999999

#


					
	public

eq(DateTimeInterface|string $date): bool

Determines if the instance is equal to another

#


					
	public

equalTo(DateTimeInterface|string $date): bool

Determines if the instance is equal to another

#


					
	public
					static

executeWithLocale(string $locale, callable $func): mixed

Set the current locale to the given, execute the passed function, reset the locale to previous one, then return the…

Set the current locale to the given, execute the passed function, reset the locale to previous one, then return the result of the closure (or null if the closure was void).

Parameters

$locale

locale ex. en

#


					
	public

farthest(Carbon|DateTimeInterface|mixed $date1, Carbon|DateTimeInterface|mixed $date2): static

Get the farthest date from the instance (second-precision).

#


					
	public

firstOfMonth(int|null $dayOfWeek = null): static

Modify to the first occurrence of a given day of the week in the current month. If no dayOfWeek is provided, modify to…

Modify to the first occurrence of a given day of the week in the current month. If no dayOfWeek is provided, modify to the first day of the current month. Use the supplied constants to indicate the desired dayOfWeek, ex. static::MONDAY.

#


					
	public

firstOfQuarter(int|null $dayOfWeek = null): static

Modify to the first occurrence of a given day of the week in the current quarter. If no dayOfWeek is provided, modify…

Modify to the first occurrence of a given day of the week in the current quarter. If no dayOfWeek is provided, modify to the first day of the current quarter. Use the supplied constants to indicate the desired dayOfWeek, ex. static::MONDAY.

Parameters

$dayOfWeek

day of the week default null

#


					
	public

firstOfYear(int|null $dayOfWeek = null): static

Modify to the first occurrence of a given day of the week in the current year. If no dayOfWeek is provided, modify to…

Modify to the first occurrence of a given day of the week in the current year. If no dayOfWeek is provided, modify to the first day of the current year. Use the supplied constants to indicate the desired dayOfWeek, ex. static::MONDAY.

Parameters

$dayOfWeek

day of the week default null

#


					
	public

floor(DateInterval|string|int|float $precision = 1): static

Round the current instance second with given precision if specified.

#


					
	public

floorUnit(string $unit, DateInterval|string|int|float $precision = 1): static

Truncate the current instance at the given unit with given precision if specified.

#


					
	public

floorWeek(WeekDay|int|null $weekStartsAt = null): static

Truncate the current instance week.

Parameters

$weekStartsAt

optional start allow you to specify the day of week to use to start the week

#


					
	public

from(
	Carbon|DateTimeInterface|string|array|null $other = null,
	int|array $syntax = null,
	bool $short = false,
	int $parts = 1,
	int $options = null,
): string

Parameters

`$other`	if array passed, will be used as parameters array, see $syntax below; if null passed, now will be used as comparison reference; if any other type, it will be converted to date and used as reference.
`$syntax`	if array passed, parameters will be extracted from it, the array may contains: - 'syntax' entry (see below) - 'short' entry (see below) - 'parts' entry (see below) - 'options' entry (see below) - 'join' entry determines how to join multiple parts of the string `- if $join is a string, it's used as a joiner glue` - if $join is a callable/closure, it get the list of string and should return a string `- if $join is an array, the first item will be the default glue, and the second item` will be used instead of the glue for the last item `- if $join is true, it will be guessed from the locale ('list' translation file entry)` - if $join is missing, a space will be used as glue - 'other' entry (see above) if int passed, it add modifiers: Possible values: - CarbonInterface::DIFF_ABSOLUTE no modifiers - CarbonInterface::DIFF_RELATIVE_TO_NOW add ago/from now modifier - CarbonInterface::DIFF_RELATIVE_TO_OTHER add before/after modifier Default value: CarbonInterface::DIFF_ABSOLUTE
`$short`	displays short format of time units
`$parts`	maximum number of parts to display (default value: 1: single unit)
`$options`	human diff options

#


					
	public

fromNow(int|array $syntax = null, bool $short = false, int $parts = 1, int $options = null): string

Get the difference in a human readable format in the current locale from current instance to now.

Parameters

`$syntax`	if array passed, parameters will be extracted from it, the array may contains: - 'syntax' entry (see below) - 'short' entry (see below) - 'parts' entry (see below) - 'options' entry (see below) - 'join' entry determines how to join multiple parts of the string `- if $join is a string, it's used as a joiner glue` - if $join is a callable/closure, it get the list of string and should return a string `- if $join is an array, the first item will be the default glue, and the second item` will be used instead of the glue for the last item `- if $join is true, it will be guessed from the locale ('list' translation file entry)` - if $join is missing, a space will be used as glue if int passed, it add modifiers: Possible values: - CarbonInterface::DIFF_ABSOLUTE no modifiers - CarbonInterface::DIFF_RELATIVE_TO_NOW add ago/from now modifier - CarbonInterface::DIFF_RELATIVE_TO_OTHER add before/after modifier Default value: CarbonInterface::DIFF_ABSOLUTE
`$short`	displays short format of time units
`$parts`	maximum number of parts to display (default value: 1: single unit)
`$options`	human diff options

#


					
	public
					static

fromSerialized(Stringable|string $value, array $options = []): static

Create an instance from a serialized string.

If $value is not from a trusted source, consider using the allowed_classes option to limit the types of objects that can be built, for instance:

Parameters

$options

example: ['allowed_classes' => [CarbonImmutable::class]]

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public
					static

genericMacro(callable $macro, int $priority = 0): void

Register a custom macro.

Parameters

$priority

marco with higher priority is tried first

#


					
	public

get(Unit|string $name): string|int|bool|DateTimeZone

Get a part of the Carbon object.

Throws

Carbon\Exceptions\UnknownGetterException

#


					
	public

getAltNumber(string $key): string

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

Parameters

$key

date property

#


					
	public
					static

getAvailableLocales(): array

Returns the list of internally available locales and already loaded custom locales. (It will ignore custom translator…

Returns the list of internally available locales and already loaded custom locales. (It will ignore custom translator dynamic loading.)

#


					
	public
					static

getAvailableLocalesInfo(): Language[]

Returns list of Language object for each available locale. This object allow you to get the ISO name, native name,…

Returns list of Language object for each available locale. This object allow you to get the ISO name, native name, region and variant of the locale.

#


					
	public

getCalendarFormats(string|null $locale = null): array

Returns list of calendar formats for ISO formatting.

Parameters

$locale

current locale used if null

#


					
	public

getClock(): ?WrapperClock

#


					
	public
					static

getDays(): array

Get the days of the week.

#


					
	public

getDaysFromStartOfWeek(WeekDay|int|null $weekStartsAt = null): int

Return the number of days since the start of the week (using the current locale or the first parameter if explicitly…

Return the number of days since the start of the week (using the current locale or the first parameter if explicitly given).

Parameters

$weekStartsAt

optional start allow you to specify the day of week to use to start the week, if not provided, start of week is inferred from the locale (Sunday for en_US, Monday for de_DE, etc.)

#


					
	public
					static

getFallbackLocale(): ?string

Get the fallback locale.

#


					
	public
					static

getFormatsToIsoReplacements(): array

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

#


					
	public
					static

getHumanDiffOptions(): int

Return default humanDiff() options (merged flags as integer).

#


					
	public

getIsoFormats(string|null $locale = null): array

Returns list of locale formats for ISO formatting.

Parameters

$locale

current locale used if null

#


					
	public
					static

getIsoUnits(): array

Returns list of locale units for ISO formatting.

#


					
	public
					static

getLastErrors(): array|false

{@inheritdoc}

#


					
	public

getLocalMacro(string $name): ?callable

Get the raw callable macro registered globally or locally for a given name.

#


					
	public

getLocalTranslator(): TranslatorInterface

Get the translator of the current instance or the default if none set.

#


					
	public
					static

getLocale(): string

Get the current translator locale.

#


					
	public
					static

getMacro(string $name): ?callable

Get the raw callable macro registered globally for a given name.

#


					
	public
					static

getMidDayAt(): int

get midday/noon hour

#


					
	public

getOffsetString(string $separator = ':'): string

Returns the offset hour and minute formatted with +/- and a given separator (":" by default). For example, if the time…

Returns the offset hour and minute formatted with +/- and a given separator (":" by default). 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 to place between hours and minutes (":" by default)

#


					
	public

getPaddedUnit(string $unit, int $length = 2, string $padString = '0', int $padType = 0): string

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

Parameters

`$unit`	Carbon unit name
`$length`	Length of the output (2 by default)
`$padString`	String to use for padding ("0" by default)
`$padType`	Side(s) to pad (STR_PAD_LEFT by default)

#


					
	public

getPreciseTimestamp(int $precision = 6): float

Returns a timestamp rounded with the given precision (6 by default).

#


					
	public

getSettings(): array

Returns current local settings.

#


					
	public
					static

getTestNow(): Closure|self|null

Get the Carbon instance (real or mock) to be returned when a "now" instance is created.

Returns

the current instance used for testing

#


					
	public
					static

getTimeFormatByPrecision(string $unitPrecision): string

Return a format from H:i to H:i:s.u according to given unit precision.

Parameters

$unitPrecision

"minute", "second", "millisecond" or "microsecond"

#


					
	public

getTimestampMs(): int

Returns the timestamp with millisecond precision.

#


					
	public

getTranslatedDayName(string|null $context = null, string $keySuffix = '', string|null $defaultValue = null): string

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

Parameters

`$context`	whole format string
`$keySuffix`	"", "_short" or "_min"
`$defaultValue`	default value if translation missing

#


					
	public

getTranslatedMinDayName(string|null $context = null): string

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

Parameters

$context

whole format string

#


					
	public

getTranslatedMonthName(string|null $context = null, string $keySuffix = '', string|null $defaultValue = null): string

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

Parameters

`$context`	whole format string
`$keySuffix`	"" or "_short"
`$defaultValue`	default value if translation missing

#


					
	public

getTranslatedShortDayName(string|null $context = null): string

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

Parameters

$context

whole format string

#


					
	public

getTranslatedShortMonthName(string|null $context = null): string

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

Parameters

$context

whole format string

#


					
	public

getTranslationMessage(
	string $key,
	string|null $locale = null,
	string|null $default = null,
	TranslatorInterface $translator = null,
): string

Returns raw translation message for a given key.

Parameters

`$key`	key to find
`$locale`	current locale used if null
`$default`	default value if translation returns the key
`$translator`	an optional translator to use

#


					
	public
					static

getTranslationMessageWith(
	TranslatorInterface|null $translator,
	string $key,
	string|null $locale = null,
	string|null $default = null,
): string|Closure|null

Returns raw translation message for a given key.

Parameters

`$translator`	the translator to use
`$key`	key to find
`$locale`	current locale used if null
`$default`	default value if translation returns the key

#


					
	public
					static

getTranslator(): TranslatorInterface

Initialize the default translator instance if necessary.

#


					
	public
					static

getWeekEndsAt(string $locale = null): int

Get the last day of week.

Parameters

$locale

local to consider the last day of week.

#


					
	public
					static

getWeekStartsAt(?string $locale = null): int

Get the first day of week.

#


					
	public
					static

getWeekendDays(): array

Get weekend days

#


					
	public

greaterThan(DateTimeInterface|string $date): bool

Determines if the instance is greater (after) than another

#


					
	public

greaterThanOrEqualTo(DateTimeInterface|string $date): bool

Determines if the instance is greater (after) than or equal to another

#


					
	public

gt(DateTimeInterface|string $date): bool

Determines if the instance is greater (after) than another

#


					
	public

gte(DateTimeInterface|string $date): bool

Determines if the instance is greater (after) than or equal to another

#


					
	public
					static

hasFormat(string $date, string $format): bool

Checks if the (date)time string is in a given format.

#


					
	public
					static

hasFormatWithModifiers(string $date, string $format): bool

Checks if the (date)time string is in a given format.

#


					
	public

hasLocalMacro(string $name): bool

Checks if macro is registered globally or locally.

#


					
	public

hasLocalTranslator(): bool

Return true if the current instance has its own translator.

#


					
	public
					static

hasMacro(string $name): bool

Checks if macro is registered globally.

#


					
	public
					static

hasRelativeKeywords(?string $time): bool

Determine if a time string will produce a relative date.

Returns

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

#


					
	public
					static

hasTestNow(): bool

Determine if there is a valid test instance set. A valid test instance is anything that is not null.

Returns

true if there is a test instance, otherwise false

#


					
	public
					static

instance(DateTimeInterface $date): static

Create a Carbon instance from a DateTime one.

#


					
	public

is(string $tester): bool

Returns true if the current date matches the given string.

Parameters

$tester

day name, month name, hour, date, etc. as string

#


					
	public

isAfter(DateTimeInterface|string $date): bool

Determines if the instance is greater (after) than another

#


					
	public

isBefore(DateTimeInterface|string $date): bool

Determines if the instance is less (before) than another

#


					
	public

isBetween(DateTimeInterface|string $date1, DateTimeInterface|string $date2, bool $equal = true): bool

Determines if the instance is between two others

Parameters

$equal

Indicates if an equal to comparison should be done

#


					
	public

isBirthday(DateTimeInterface|string|null $date = null): bool

Check if its the birthday. Compares the date/month values of the two dates.

Parameters

$date

The instance to compare with or null to use current day.

#


					
	public

isCurrentUnit(string $unit): bool

Determines if the instance is in the current unit given.

Parameters

$unit

The unit to test.

Throws

BadMethodCallException

#


					
	public

isDayOfWeek(int|string $dayOfWeek): bool

Checks if this day is a specific day of the week.

#


					
	public

Determines if the instance is end of century (last day by default but interval can be customized).

#


					
	public

isEndOfDay(
	bool $checkMicroseconds = false,
	Unit|DateInterval|Closure|CarbonConverterInterface|string|null $interval = null,
): bool

Check if the instance is end of day.

Parameters

`$checkMicroseconds`	check time at microseconds precision
`$interval`	if an interval is specified it will be used as precision for instance with "15 minutes", it checks if current date-time is in the last 15 minutes of the day, with Unit::Hour, it checks if it's in the last hour of the day.

#


					
	public

Determines if the instance is end of decade (last day by default but interval can be customized).

#


					
	public

Determines if the instance is end of hour (last microsecond by default but interval can be customized).

#


					
	public

Determines if the instance is end of millennium (last day by default but interval can be customized).

#


					
	public

Determines if the instance is end of millisecond (last microsecond by default but interval can be customized).

#


					
	public

Determines if the instance is end of minute (last microsecond by default but interval can be customized).

#


					
	public

Determines if the instance is end of month (last day by default but interval can be customized).

#


					
	public

Determines if the instance is end of quarter (last day by default but interval can be customized).

#


					
	public

Determines if the instance is end of second (last microsecond by default but interval can be customized).

#


					
	public

isEndOfTime(): bool

Returns true if the date was created using CarbonImmutable::endOfTime()

#


					
	public

isEndOfUnit(
	Unit $unit,
	Unit|DateInterval|Closure|CarbonConverterInterface|string|null $interval = null,
	mixed ...$params,
): bool

Check if the instance is end of a given unit (tolerating a given interval).

#


					
	public

isEndOfWeek(
	Unit|DateInterval|Closure|CarbonConverterInterface|string|null $interval = null,
	WeekDay|int|null $weekEndsAt = null,
): bool

Determines if the instance is end of week (last day by default but interval can be customized).

#


					
	public

Determines if the instance is end of year (last day by default but interval can be customized).

#


					
	public

isFuture(): bool

Determines if the instance is in the future, ie. greater (after) than now.

#


					
	public
					static

isImmutable(): bool

Returns true if the current class/instance is immutable.

#


					
	public

isLastOfMonth(): bool

Check if today is the last day of the Month

#


					
	public

isLeapYear(): bool

Determines if the instance is a leap year.

#


					
	public

isLongIsoYear(): bool

Determines if the instance is a long year (using ISO 8601 year).

#


					
	public

isLongYear(): bool

Determines if the instance is a long year (using calendar year).

⚠️ This method completely ignores month and day to use the numeric year number, it's not correct if the exact date matters. For instance as 2019-12-30 is already in the first week of the 2020 year, if you want to know from this date if ISO week year 2020 is a long year, use isLongIsoYear instead.

#


					
	public

isMidday(): bool

Check if the instance is midday.

#


					
	public

isMidnight(): bool

Check if the instance is start of day / midnight.

#


					
	public
					static

isModifiableUnit(string $unit): bool

Returns true if a property can be changed via setter.

#


					
	public
					static

isMutable(): bool

Returns true if the current class/instance is mutable.

Implemented by

Carbon\Carbon::isMutable()

#


					
	public

isNowOrFuture(): bool

Determines if the instance is now or in the future, ie. greater (after) than or equal to now.

#


					
	public

isNowOrPast(): bool

Determines if the instance is now or in the past, ie. less (before) than or equal to now.

#


					
	public

isPast(): bool

Determines if the instance is in the past, ie. less (before) than now.

#


					
	public

isSameAs(string $format, DateTimeInterface|string $date): bool

Compares the formatted values of the two dates.

Parameters

`$format`	date formats to compare.
`$date`	instance to compare with or null to use current day.

#


					
	public

isSameMonth(DateTimeInterface|string $date, bool $ofSameYear = true): bool

Checks if the passed in date is in the same month as the instance´s month.

Parameters

`$date`	The instance to compare with or null to use the current date.
`$ofSameYear`	Check if it is the same month in the same year.

#


					
	public

isSameQuarter(DateTimeInterface|string $date, bool $ofSameYear = true): bool

Checks if the passed in date is in the same quarter as the instance quarter (and year if needed).

Parameters

`$date`	The instance to compare with or null to use current day.
`$ofSameYear`	Check if it is the same month in the same year.

#


					
	public

isSameUnit(string $unit, DateTimeInterface|string $date): bool

Determines if the instance is in the current unit given.

Parameters

`$unit`	singular unit string
`$date`	instance to compare with or null to use current day.

Throws

Carbon\Exceptions\BadComparisonUnitException

#


					
	public

Determines if the instance is start of century (first day by default but interval can be customized).

#


					
	public

isStartOfDay(
	bool $checkMicroseconds = false,
	Unit|DateInterval|Closure|CarbonConverterInterface|string|null $interval = null,
): bool

Check if the instance is start of day / midnight.

Parameters

`$checkMicroseconds`	check time at microseconds precision
`$interval`	if an interval is specified it will be used as precision for instance with "15 minutes", it checks if current date-time is in the last 15 minutes of the day, with Unit::Hour, it checks if it's in the last hour of the day.

#


					
	public

Determines if the instance is start of decade (first day by default but interval can be customized).

#


					
	public

Determines if the instance is start of hour (first microsecond by default but interval can be customized).

#


					
	public

Determines if the instance is start of millennium (first day by default but interval can be customized).

#


					
	public

Determines if the instance is start of millisecond (first microsecond by default but interval can be customized).

#


					
	public

Determines if the instance is start of minute (first microsecond by default but interval can be customized).

#


					
	public

Determines if the instance is start of month (first day by default but interval can be customized).

#


					
	public

Determines if the instance is start of quarter (first day by default but interval can be customized).

#


					
	public

Determines if the instance is start of second (first microsecond by default but interval can be customized).

#


					
	public

isStartOfTime(): bool

Returns true if the date was created using CarbonImmutable::startOfTime()

#


					
	public

isStartOfUnit(
	Unit $unit,
	Unit|DateInterval|Closure|CarbonConverterInterface|string|null $interval = null,
	mixed ...$params,
): bool

Check if the instance is start of a given unit (tolerating a given interval).

#


					
	public

isStartOfWeek(
	Unit|DateInterval|Closure|CarbonConverterInterface|string|null $interval = null,
	WeekDay|int|null $weekStartsAt = null,
): bool

Determines if the instance is start of week (first day by default but interval can be customized).

#


					
	public

Determines if the instance is start of year (first day by default but interval can be customized).

#


					
	public
					static

isStrictModeEnabled(): bool

Returns true if the strict mode is globally in use, false else. (It can be overridden in specific instances.)

#


					
	public

isToday(): bool

Determines if the instance is today.

#


					
	public

isTomorrow(): bool

Determines if the instance is tomorrow.

#


					
	public

isWeekday(): bool

Determines if the instance is a weekday.

#


					
	public

isWeekend(): bool

Determines if the instance is a weekend day.

#


					
	public

isYesterday(): bool

Determines if the instance is yesterday.

#


					
	public

isoFormat(string $format, string|null $originalFormat = null): string

Format in the current language using ISO replacement patterns.

Parameters

$originalFormat

provide context if a chunk has been passed alone

#


					
	public

isoWeek(int|null $week = null, int|null $dayOfWeek = null, int|null $dayOfYear = null): int|static

Get/set the week number using given first day of week and first day of year included in the first week. Or use ISO…

Get/set the week number using given first day of week and first day of year included in the first week. Or use ISO format if no settings given.

#


					
	public

isoWeekYear(int|null $year = null, int|null $dayOfWeek = null, int|null $dayOfYear = null): int|static

Set/get the week number of year using given first day of week and first day of year included in the first week. Or use…

Set/get the week number of year using given first day of week and first day of year included in the first week. Or use ISO format if no settings given.

Parameters

`$year`	if null, act as a getter, if not null, set the year and return current instance.
`$dayOfWeek`	first date of week from 0 (Sunday) to 6 (Saturday)
`$dayOfYear`	first day of year included in the week #1

#


					
	public

isoWeekday(WeekDay|int|null $value = null): static|int

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

Parameters

$value

new value for weekday if using as setter.

#


					
	public

isoWeeksInYear(int|null $dayOfWeek = null, int|null $dayOfYear = null): int

Get the number of weeks of the current week-year using given first day of week and first day of year included in the…

Get the number of weeks of the current week-year using given first day of week and first day of year included in the first week. Or use ISO format if no settings given.

Parameters

`$dayOfWeek`	first date of week from 0 (Sunday) to 6 (Saturday)
`$dayOfYear`	first day of year included in the week #1

#


					
	public

jsonSerialize(): mixed

Prepare the object for JSON serialization.

#


					
	public

lastOfMonth(int|null $dayOfWeek = null): static

Modify to the last occurrence of a given day of the week in the current month. If no dayOfWeek is provided, modify to…

Modify to the last occurrence of a given day of the week in the current month. If no dayOfWeek is provided, modify to the last day of the current month. Use the supplied constants to indicate the desired dayOfWeek, ex. static::MONDAY.

#


					
	public

lastOfQuarter(int|null $dayOfWeek = null): static

Modify to the last occurrence of a given day of the week in the current quarter. If no dayOfWeek is provided, modify to…

Modify to the last occurrence of a given day of the week in the current quarter. If no dayOfWeek is provided, modify to the last day of the current quarter. Use the supplied constants to indicate the desired dayOfWeek, ex. static::MONDAY.

Parameters

$dayOfWeek

day of the week default null

#


					
	public

lastOfYear(int|null $dayOfWeek = null): static

Modify to the last occurrence of a given day of the week in the current year. If no dayOfWeek is provided, modify to…

Modify to the last occurrence of a given day of the week in the current year. If no dayOfWeek is provided, modify to the last day of the current year. Use the supplied constants to indicate the desired dayOfWeek, ex. static::MONDAY.

Parameters

$dayOfWeek

day of the week default null

#


					
	public

lessThan(DateTimeInterface|string $date): bool

Determines if the instance is less (before) than another

#


					
	public

lessThanOrEqualTo(DateTimeInterface|string $date): bool

Determines if the instance is less (before) or equal to another

#


					
	public

locale(string|null $locale = null, string ...$fallbackLocales): $this|string

Get/set the locale for the current instance.

#


					
	public
					static

localeHasDiffOneDayWords(string $locale): bool

Returns true if the given locale is internally supported and has words for 1-day diff (just now, yesterday, tomorrow).…

Returns true if the given locale is internally supported and has words for 1-day diff (just now, yesterday, tomorrow). Support is considered enabled if the 3 words are translated in the given locale.

Parameters

$locale

locale ex. en

#


					
	public
					static

localeHasDiffSyntax(string $locale): bool

Returns true if the given locale is internally supported and has diff syntax support (ago, from now, before, after).…

Returns true if the given locale is internally supported and has diff syntax support (ago, from now, before, after). Support is considered enabled if the 4 sentences are translated in the given locale.

Parameters

$locale

locale ex. en

#


					
	public
					static

localeHasDiffTwoDayWords(string $locale): bool

Returns true if the given locale is internally supported and has words for 2-days diff (before yesterday, after…

Returns true if the given locale is internally supported and has words for 2-days diff (before yesterday, after tomorrow). Support is considered enabled if the 2 words are translated in the given locale.

Parameters

$locale

locale ex. en

#


					
	public
					static

localeHasPeriodSyntax(string $locale): bool

Returns true if the given locale is internally supported and has period syntax support (X times, every X, from X, to X)…

Returns true if the given locale is internally supported and has period syntax support (X times, every X, from X, to X). Support is considered enabled if the 4 sentences are translated in the given locale.

Parameters

$locale

locale ex. en

#


					
	public
					static

localeHasShortUnits(string $locale): bool

Returns true if the given locale is internally supported and has short-units support. Support is considered enabled if…

Returns true if the given locale is internally supported and has short-units support. Support is considered enabled if either year, day or hour has a short variant translated.

Parameters

$locale

locale ex. en

#


					
	public

lt(DateTimeInterface|string $date): bool

Determines if the instance is less (before) than another

#


					
	public

lte(DateTimeInterface|string $date): bool

Determines if the instance is less (before) or equal to another

#


					
	public
					static

macro(string $name, ?callable $macro): void

Register a custom macro.

Pass null macro to remove it.

#


					
	public
					static

make(mixed $var, DateTimeZone|string|null $timezone = null): static|null

Make a Carbon instance from given variable if possible.

Always return a new instance. Parse only strings and only these likely to be dates (skip intervals and recurrences). Throw an exception for invalid format, but otherwise return null.

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public

max(Carbon|DateTimeInterface|mixed $date = null): static

Get the maximum instance between a given instance (default now) and the current instance.

#


					
	public

maximum(Carbon|DateTimeInterface|mixed $date = null): static

Get the maximum instance between a given instance (default now) and the current instance.

#


					
	public

meridiem(bool $isLower = false): string

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

Parameters

$isLower

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

#


					
	public

midDay(): static

Modify to midday, default to self::$midDayAt

#


					
	public

min(Carbon|DateTimeInterface|mixed $date = null): static

Get the minimum instance between a given instance (default now) and the current instance.

#


					
	public

minimum(Carbon|DateTimeInterface|mixed $date = null): static

Get the minimum instance between a given instance (default now) and the current instance.

#


					
	public
					static

mixin(object|string $mixin): void

Mix another object into the class.

Throws

ReflectionException

#


					
	public

modify($modify): static

Calls \DateTime::modify if mutable or \DateTimeImmutable::modify else.

#


					
	public

ne(DateTimeInterface|string $date): bool

Determines if the instance is not equal to another

#


					
	public

next(string|int|null $modifier = null): static

Modify to the next occurrence of a given modifier such as a day of the week. If no modifier is provided, modify to the…

Modify to the next occurrence of a given modifier such as a day of the week. If no modifier is provided, modify to the next occurrence of the current day of the week. Use the supplied constants to indicate the desired dayOfWeek, ex. static::MONDAY.

#


					
	public

nextWeekday(): static

Go forward to the next weekday.

#


					
	public

nextWeekendDay(): static

Go forward to the next weekend day.

#


					
	public

notEqualTo(DateTimeInterface|string $date): bool

Determines if the instance is not equal to another

#


					
	public
					static

now(DateTimeZone|string|int|null $timezone = null): static

Get a Carbon instance for the current date and time.

#


					
	public

nowWithSameTz(): static

Returns a present instance in the same timezone.

#


					
	public

nthOfMonth(int $nth, int $dayOfWeek): mixed

Modify to the given occurrence of a given day of the week in the current month. If the calculated occurrence is outside…

Modify to the given occurrence of a given day of the week in the current month. If the calculated occurrence is outside the scope of the current month, then return false and no modifications are made. Use the supplied constants to indicate the desired dayOfWeek, ex. static::MONDAY.

#


					
	public

nthOfQuarter(int $nth, int $dayOfWeek): mixed

Modify to the given occurrence of a given day of the week in the current quarter. If the calculated occurrence is…

Modify to the given occurrence of a given day of the week in the current quarter. If the calculated occurrence is outside the scope of the current quarter, then return false and no modifications are made. Use the supplied constants to indicate the desired dayOfWeek, ex. static::MONDAY.

#


					
	public

nthOfYear(int $nth, int $dayOfWeek): mixed

Modify to the given occurrence of a given day of the week in the current year. If the calculated occurrence is outside…

Modify to the given occurrence of a given day of the week in the current year. If the calculated occurrence is outside the scope of the current year, then return false and no modifications are made. Use the supplied constants to indicate the desired dayOfWeek, ex. static::MONDAY.

#


					
	public

ordinal(string $key, ?string $period = null): string

Return a property with its ordinal.

#


					
	public
					static

parse(
	DateTimeInterface|WeekDay|Month|string|int|float|null $time,
	DateTimeZone|string|int|null $timezone = null,
): static

Create a carbon instance from a string.

This is an alias for the constructor that allows better fluent syntax as it allows you to do Carbon::parse('Monday next week')->fn() rather than (new Carbon('Monday next week'))->fn().

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public
					static

parseFromLocale(string $time, string|null $locale = null, DateTimeZone|string|int|null $timezone = null): static

Create a carbon instance from a localized string (in French, Japanese, Arabic, etc.).

Parameters

`$time`	date/time string in the given language (may also contain English).
`$locale`	if locale is null or not specified, current global locale will be used instead.
`$timezone`	optional timezone for the new instance.

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public
					static

pluralUnit(string $unit): string

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

#


					
	public

previous(string|int|null $modifier = null): static

Modify to the previous occurrence of a given modifier such as a day of the week. If no dayOfWeek is provided, modify to…

Modify to the previous occurrence of a given modifier such as a day of the week. If no dayOfWeek is provided, modify to the previous occurrence of the current day of the week. Use the supplied constants to indicate the desired dayOfWeek, ex. static::MONDAY.

#


					
	public

previousWeekday(): static

Go backward to the previous weekday.

#


					
	public

previousWeekendDay(): static

Go backward to the previous weekend day.

#


					
	public

range(
	DateTimeInterface|Carbon|CarbonImmutable|null $end = null,
	int|DateInterval|string|null $interval = null,
	string|null $unit = null,
): CarbonPeriod

Create a iterable CarbonPeriod object from current date to a given end date (and optional interval).

Parameters

`$end`	period end date
`$interval`	period default interval or number of the given $unit
`$unit`	if specified, $interval must be an integer

#


					
	public

rawAdd(DateInterval $interval): static

Call native PHP DateTime/DateTimeImmutable add() method.

#


					
	public
					static

rawCreateFromFormat(string $format, string $time, DateTimeZone|string|int|null $timezone = null): static|null

Create a Carbon instance from a specific format.

Parameters

$format

Datetime format

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public

rawFormat(string $format): string

#


					
	public
					static

rawParse(
	DateTimeInterface|WeekDay|Month|string|int|float|null $time,
	DateTimeZone|string|int|null $timezone = null,
): static

Create a carbon instance from a string.

This is an alias for the constructor that allows better fluent syntax as it allows you to do Carbon::parse('Monday next week')->fn() rather than (new Carbon('Monday next week'))->fn().

Throws

Carbon\Exceptions\InvalidFormatException

#


					
	public

rawSub(DateInterval $interval): static

Call native PHP DateTime/DateTimeImmutable sub() method.

#


					
	public
					static

resetMacros(): void

Remove all macros and generic macros.

#


					
	public
					static

resetMonthsOverflow(): void

Deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather use the ->settings() method. Or you can use method variants: addMonthsWithOverflow/addMonthsNoOverflow, same variants are available for quarters, years, decade, centuries, millennia (singular and plural forms).

#


					
	public
					static

resetToStringFormat(): void

Reset the format used to the default when type juggling a Carbon instance to a string

#


					
	public
					static

resetYearsOverflow(): void

Deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather use the ->settings() method. Or you can use method variants: addYearsWithOverflow/addYearsNoOverflow, same variants are available for quarters, years, decade, centuries, millennia (singular and plural forms).

#


					
	public

round(DateInterval|string|int|float $precision = 1, callable|string $function = 'round'): static

Round the current instance second with given precision if specified.

#


					
	public

roundUnit(string $unit, DateInterval|string|int|float $precision = 1, callable|string $function = 'round'): static

Round the current instance at the given unit with given precision if specified and the given function.

#


					
	public

roundWeek(WeekDay|int|null $weekStartsAt = null): static

Round the current instance week.

Parameters

$weekStartsAt

optional start allow you to specify the day of week to use to start the week

#


					
	public

secondsSinceMidnight(): float

The number of seconds since midnight.

#


					
	public

secondsUntilEndOfDay(): float

The number of seconds until 23:59:59.

#


					
	public

serialize(): string

Return a serialized string of the instance.

#


					
	public
					static

serializeUsing(callable|string|null $format): void

Deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather transform Carbon object before the serialization.

#


					
	public

Set a part of the Carbon object.

Throws

Carbon\Exceptions\ImmutableException|Carbon\Exceptions\UnknownSetterException

#


					
	public

setDate(int $year, int $month, int $day): static

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

#


					
	public

setDateFrom(DateTimeInterface|string $date): static

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

#


					
	public

setDateTime(int $year, int $month, int $day, int $hour, int $minute, int $second = 0, int $microseconds = 0): static

Set the date and time all together.

#


					
	public

setDateTimeFrom(DateTimeInterface|string $date): static

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

#


					
	public

setDaysFromStartOfWeek(int $numberOfDays, WeekDay|int|null $weekStartsAt = null): static

Set the day (keeping the current time) to the start of the week + the number of days passed as the first parameter.…

Set the day (keeping the current time) to the start of the week + the number of days passed as the first parameter. First day of week is driven by the locale unless explicitly set with the second parameter.

Parameters

`$numberOfDays`	number of days to add after the start of the current week
`$weekStartsAt`	optional start allow you to specify the day of week to use to start the week, if not provided, start of week is inferred from the locale (Sunday for en_US, Monday for de_DE, etc.)

#


					
	public
					static

setFallbackLocale(string $locale): void

Set the fallback locale.

#


					
	public
					static

setHumanDiffOptions(int $humanDiffOptions): void

Deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather use the ->settings() method.

#


					
	public

setISODate(int $year, int $week, int $day = 1): static

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

#


					
	public

setLocalTranslator(TranslatorInterface $translator)

Set the translator for the current instance.

#


					
	public
					static

setLocale(string $locale): void

Set the current translator locale and indicate if the source locale file exists. Pass 'auto' as locale to use the…

Set the current translator locale and indicate if the source locale file exists. Pass 'auto' as locale to use the closest language to the current LC_TIME locale.

Parameters

$locale

locale ex. en

#


					
	public
					static

setMidDayAt(int $hour): void

Deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather consider mid-day is always 12pm, then if you need to test if it's an other hour, test it explicitly: $date->format('G') == 13 or to set explicitly to a given hour: $date->setTime(13, 0, 0, 0)

Parameters

$hour

midday hour

#


					
	public
					static

Set a Carbon instance (real or mock) to be returned when a "now" instance is created. The provided instance will be…

Set a Carbon instance (real or mock) to be returned when a "now" instance is created. The provided instance will be returned specifically under the following conditions:

A call to the static now() method, ex. Carbon::now()
When a null (or blank string) is passed to the constructor or parse(), ex. new Carbon(null)
When the string "now" is passed to the constructor or parse(), ex. new Carbon('now')
When a string containing the desired time is passed to Carbon::parse().

Note the timezone parameter was left out of the examples above and has no affect as the mock value will be returned regardless of its value.

Only the moment is mocked with setTestNow(), the timezone will still be the one passed as parameter of date_default_timezone_get() as a fallback (see setTestNowAndTimezone()).

To clear the test instance call this method using the default parameter of null.

/!\ Use this method for unit tests only.

Parameters

$testNow

real or mock Carbon instance

Implemented by

Illuminate\Support\Carbon::setTestNow()

#


					
	public
					static

Set a Carbon instance (real or mock) to be returned when a "now" instance is created. The provided instance will be…

Set a Carbon instance (real or mock) to be returned when a "now" instance is created. The provided instance will be returned specifically under the following conditions:

A call to the static now() method, ex. Carbon::now()
When a null (or blank string) is passed to the constructor or parse(), ex. new Carbon(null)
When the string "now" is passed to the constructor or parse(), ex. new Carbon('now')
When a string containing the desired time is passed to Carbon::parse().

It will also align default timezone (e.g. call date_default_timezone_set()) with the second argument or if null, with the timezone of the given date object.

To clear the test instance call this method using the default parameter of null.

/!\ Use this method for unit tests only.

Parameters

$testNow

real or mock Carbon instance

#


					
	public

setTime(int $hour, int $minute, int $second = 0, int $microseconds = 0): static

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

#


					
	public

setTimeFrom(DateTimeInterface|string $date): static

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

#


					
	public

setTimeFromTimeString(string $time): static

Set the time by time string.

#


					
	public

setTimestamp(string|int|float $timestamp): static

Set the instance's timestamp.

Timestamp input can be given as int, float or a string containing one or more numbers.

#


					
	public

setTimezone(DateTimeZone|string|int $timeZone): static

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

#


					
	public
					static

setToStringFormat(string|Closure|null $format): void

Deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather let Carbon object being cast to string with DEFAULT_TO_STRING_FORMAT, and use other method or custom format passed to format() method if you need to dump another string format.

#


					
	public
					static

setTranslator(TranslatorInterface $translator): void

Set the default translator instance to use.

#


					
	public

setUnit(string $unit, Month|int $value = null): static

Set specified unit to new given value.

Parameters

`$unit`	year, month, day, hour, minute, second or microsecond
`$value`	new value for given unit

#


					
	public

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

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

Parameters

`$valueUnit`	unit name to modify
`$value`	new value for the input unit
`$overflowUnit`	unit name to not overflow

#


					
	public
					static

setWeekendDays(array $days): void

Deprecated

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

#


					
	public

settings(array $settings): $this|static

Set specific options.

strictMode: true|false|null
monthOverflow: true|false|null
yearOverflow: true|false|null
humanDiffOptions: int|null
toStringFormat: string|Closure|null
toJsonFormat: string|Closure|null
locale: string|null
timezone: \DateTimeZone|string|int|null
macros: array|null
genericMacros: array|null

#


					
	public

shiftTimezone(DateTimeZone|string $value): static

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

#


					
	public
					static

shouldOverflowMonths(): bool

Get the month overflow global behavior (can be overridden in specific instances).

#


					
	public
					static

shouldOverflowYears(): bool

Get the month overflow global behavior (can be overridden in specific instances).

#


					
	public

since($other = null, $syntax = null, $short = false, $parts = 1, $options = null)

#


					
	public
					static

singularUnit(string $unit): string

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

#


					
	public
					static

sleep(int|float $seconds): void

#


					
	public

startOf(Unit|string $unit, mixed ...$params): static

Modify to start of current given unit.

#


					
	public

startOfCentury(): static

Resets the date to the first day of the century and the time to 00:00:00

#


					
	public

startOfDay(): static

Resets the time to 00:00:00 start of day

#


					
	public

startOfDecade(): static

Resets the date to the first day of the decade and the time to 00:00:00

#


					
	public

startOfHour(): static

Modify to start of current hour, minutes and seconds become 0

#


					
	public

startOfMillennium(): static

Resets the date to the first day of the millennium and the time to 00:00:00

#


					
	public

startOfMillisecond(): static

Modify to start of current millisecond, microseconds such as 12345 become 123000

#


					
	public

startOfMinute(): static

Modify to start of current minute, seconds become 0

#


					
	public

startOfMonth(): static

Resets the date to the first day of the month and the time to 00:00:00

#


					
	public

startOfQuarter(): static

Resets the date to the first day of the quarter and the time to 00:00:00

#


					
	public

startOfSecond(): static

Modify to start of current second, microseconds become 0

#


					
	public

startOfWeek(WeekDay|int|null $weekStartsAt = null): static

Resets the date to the first day of week (defined in $weekStartsAt) and the time to 00:00:00

Parameters

$weekStartsAt

optional start allow you to specify the day of week to use to start the week

#


					
	public

startOfYear(): static

Resets the date to the first day of the year and the time to 00:00:00

#


					
	public

sub(
	Unit|int|string|DateInterval|Closure|CarbonConverterInterface $unit,
	Unit|int|float|string $value = 1,
	bool|null $overflow = null,
): static

Subtract given units or interval to the current instance.

#


					
	public

subRealUnit(string $unit, int $value = 1): static

Deprecated

Prefer to use add subUTCUnit() which more accurately defines what it's doing.

#


					
	public

subUTCUnit(string $unit, int $value = 1): static

Subtract seconds to the instance using timestamp. Positive $value travels into the past while negative $value travels…

Subtract seconds to the instance using timestamp. Positive $value travels into the past while negative $value travels forward.

#


					
	public

subUnit(Unit|string $unit, $value = 1, ?bool $overflow = null): static

Subtract given units to the current instance.

#


					
	public

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

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

Parameters

`$valueUnit`	unit name to modify
`$value`	amount to subtract to the input unit
`$overflowUnit`	unit name to not overflow

#


					
	public

Subtract given units or interval to the current instance.

#


					
	public

timespan($other = null, $timezone = null): string

Get the difference in a human-readable format in the current locale from current instance to another instance given (or…

Get the difference in a human-readable format in the current locale from current instance to another instance given (or now if null given).

#


					
	public

timestamp(string|int|float $timestamp): static

Set the instance's timestamp.

Timestamp input can be given as int, float or a string containing one or more numbers.

#


					
	public

timezone(DateTimeZone|string|int $value): static

#


					
	public

to(
	Carbon|DateTimeInterface|string|array|null $other = null,
	int|array $syntax = null,
	bool $short = false,
	int $parts = 1,
	int $options = null,
): string

Get the difference in a human readable format in the current locale from an other instance given (or now if null given)…

Get the difference in a human readable format in the current locale from an other instance given (or now if null given) to current instance.

When comparing a value in the past to default now: 1 hour from now 5 months from now

When comparing a value in the future to default now: 1 hour ago 5 months ago

When comparing a value in the past to another value: 1 hour after 5 months after

When comparing a value in the future to another value: 1 hour before 5 months before

Parameters

`$other`	if array passed, will be used as parameters array, see $syntax below; if null passed, now will be used as comparison reference; if any other type, it will be converted to date and used as reference.
`$syntax`	if array passed, parameters will be extracted from it, the array may contains: - 'syntax' entry (see below) - 'short' entry (see below) - 'parts' entry (see below) - 'options' entry (see below) - 'join' entry determines how to join multiple parts of the string `- if $join is a string, it's used as a joiner glue` - if $join is a callable/closure, it get the list of string and should return a string `- if $join is an array, the first item will be the default glue, and the second item` will be used instead of the glue for the last item `- if $join is true, it will be guessed from the locale ('list' translation file entry)` - if $join is missing, a space will be used as glue - 'other' entry (see above) if int passed, it add modifiers: Possible values: - CarbonInterface::DIFF_ABSOLUTE no modifiers - CarbonInterface::DIFF_RELATIVE_TO_NOW add ago/from now modifier - CarbonInterface::DIFF_RELATIVE_TO_OTHER add before/after modifier Default value: CarbonInterface::DIFF_ABSOLUTE
`$short`	displays short format of time units
`$parts`	maximum number of parts to display (default value: 1: single unit)
`$options`	human diff options

#


					
	public

toArray(): array

Get default array representation.

#


					
	public

toAtomString(): string

Format the instance as ATOM

#


					
	public

toCookieString(): string

Format the instance as COOKIE

#


					
	public

toDate(): DateTime

#


					
	public

toDateString(): string

Format the instance as date

#


					
	public

toDateTime(): DateTime

Return native DateTime PHP object matching the current instance.

#


					
	public

toDateTimeImmutable(): DateTimeImmutable

Return native toDateTimeImmutable PHP object matching the current instance.

#


					
	public

toDateTimeLocalString(string $unitPrecision = 'second'): string

Format the instance as date and time T-separated with no timezone

#


					
	public

toDateTimeString(string $unitPrecision = 'second'): string

Format the instance as date and time

#


					
	public

toDayDateTimeString(): string

Format the instance with day, date and time

#


					
	public

toFormattedDateString(): string

Format the instance as a readable date

#


					
	public

toFormattedDayDateString(): string

Format the instance with the day, and a readable date

#


					
	public

toISOString(bool $keepOffset = false): ?string

Return the ISO-8601 string (ex: 1977-04-22T06:00:00Z, if $keepOffset truthy, offset will be kept: 1977-04-22T01:00:00…

Return the ISO-8601 string (ex: 1977-04-22T06:00:00Z, if $keepOffset truthy, offset will be kept: 1977-04-22T01:00:00-05:00).

Parameters

$keepOffset

Pass true to keep the date offset. Else forced to UTC.

#


					
	public

toImmutable(): CarbonImmutable

Return a immutable copy of the instance.

#


					
	public

toIso8601String(): string

Format the instance as ISO8601

#


					
	public

toIso8601ZuluString(string $unitPrecision = 'second'): string

Convert the instance to UTC and return as Zulu ISO8601

#


					
	public

toJSON(): ?string

Return the ISO-8601 string (ex: 1977-04-22T06:00:00Z) with UTC timezone.

#


					
	public

toMutable(): Carbon

Return a mutable copy of the instance.

#


					
	public

toNow(int|array $syntax = null, bool $short = false, int $parts = 1, int $options = null): string

Get the difference in a human readable format in the current locale from an other instance given to now

Parameters

`$syntax`	if array passed, parameters will be extracted from it, the array may contains: - 'syntax' entry (see below) - 'short' entry (see below) - 'parts' entry (see below) - 'options' entry (see below) - 'join' entry determines how to join multiple parts of the string `- if $join is a string, it's used as a joiner glue` - if $join is a callable/closure, it get the list of string and should return a string `- if $join is an array, the first item will be the default glue, and the second item` will be used instead of the glue for the last item `- if $join is true, it will be guessed from the locale ('list' translation file entry)` - if $join is missing, a space will be used as glue if int passed, it add modifiers: Possible values: - CarbonInterface::DIFF_ABSOLUTE no modifiers - CarbonInterface::DIFF_RELATIVE_TO_NOW add ago/from now modifier - CarbonInterface::DIFF_RELATIVE_TO_OTHER add before/after modifier Default value: CarbonInterface::DIFF_ABSOLUTE
`$short`	displays short format of time units
`$parts`	maximum number of parts to display (default value: 1: single part)
`$options`	human diff options

#


					
	public

toObject(): object

Get default object representation.

#


					
	public

toPeriod(
	DateTimeInterface|Carbon|CarbonImmutable|int|null $end = null,
	int|DateInterval|string|null $interval = null,
	string|null $unit = null,
): CarbonPeriod

Create a iterable CarbonPeriod object from current date to a given end date (and optional interval).

Parameters

`$end`	period end date or recurrences count if int
`$interval`	period default interval or number of the given $unit
`$unit`	if specified, $interval must be an integer

#


					
	public

toRfc1036String(): string

Format the instance as RFC1036

#


					
	public

toRfc1123String(): string

Format the instance as RFC1123

#


					
	public

toRfc2822String(): string

Format the instance as RFC2822

#


					
	public

toRfc3339String(bool $extended = false): string

Format the instance as RFC3339.

#


					
	public

toRfc7231String(): string

Format the instance as RFC7231

#


					
	public

toRfc822String(): string

Format the instance as RFC822

#


					
	public

toRfc850String(): string

Format the instance as RFC850

#


					
	public

toRssString(): string

Format the instance as RSS

#


					
	public

toString(): string

Returns english human-readable complete date string.

#


					
	public

toTimeString(string $unitPrecision = 'second'): string

Format the instance as time

#


					
	public

toW3cString(): string

Format the instance as W3C

#


					
	public
					static

today(DateTimeZone|string|int|null $timezone = null): static

Create a Carbon instance for today.

#


					
	public
					static

tomorrow(DateTimeZone|string|int|null $timezone = null): static

Create a Carbon instance for tomorrow.

#


					
	public

translate(
	string $key,
	array $parameters = [],
	string|int|float|null $number = null,
	TranslatorInterface|null $translator = null,
	bool $altNumbers = false,
): string

Translate using translation string or callback available.

Parameters

`$key`	key to find
`$parameters`	replacement parameters
`$number`	number if plural
`$translator`	an optional translator to use
`$altNumbers`	pass true to use alternative numbers

#


					
	public

translateNumber(int $number): string

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

#


					
	public
					static

translateTimeString(
	string $timeString,
	string|null $from = null,
	string|null $to = null,
	int $mode = self::TRANSLATE_ALL,
): string

Translate a time string from a locale to an other.

Parameters

`$timeString`	date/time/duration string to translate (may also contain English)
`$from`	input locale of the $timeString parameter (`Carbon::getLocale()` by default)
`$to`	output locale of the result returned (`"en"` by default)
`$mode`	specify what to translate with options: - self::TRANSLATE_ALL (default) - CarbonInterface::TRANSLATE_MONTHS - CarbonInterface::TRANSLATE_DAYS - CarbonInterface::TRANSLATE_UNITS - CarbonInterface::TRANSLATE_MERIDIEM You can use pipe to group: CarbonInterface::TRANSLATE_MONTHS \| CarbonInterface::TRANSLATE_DAYS

#


					
	public

translateTimeStringTo(string $timeString, string|null $to = null): string

Translate a time string from the current locale (`$date->locale()`) to another one.

Translate a time string from the current locale ($date->locale()) to another one.

Parameters

`$timeString`	time string to translate
`$to`	output locale of the result returned ("en" by default)

#


					
	public
					static

translateWith(
	TranslatorInterface $translator,
	string $key,
	array $parameters = [],
	int|float|null $number = null,
): string

Translate using translation string or callback available.

Parameters

`$translator`	an optional translator to use
`$key`	key to find
`$parameters`	replacement parameters
`$number`	number if plural

#


					
	public

translatedFormat(string $format): string

Format as ->format() do (using date replacements patterns from https://php.net/manual/en/function.date.php) but…

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

#


					
	public

tz(DateTimeZone|string|int|null $value = null): ($value is null ? string : static)

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

#


					
	public

unix(): int

#


					
	public

until(
	Carbon|DateTimeInterface|string|array|null $other = null,
	int|array $syntax = null,
	bool $short = false,
	int $parts = 1,
	int $options = null,
): string

Parameters

`$other`	if array passed, will be used as parameters array, see $syntax below; if null passed, now will be used as comparison reference; if any other type, it will be converted to date and used as reference.
`$syntax`	if array passed, parameters will be extracted from it, the array may contains: - 'syntax' entry (see below) - 'short' entry (see below) - 'parts' entry (see below) - 'options' entry (see below) - 'join' entry determines how to join multiple parts of the string `- if $join is a string, it's used as a joiner glue` - if $join is a callable/closure, it get the list of string and should return a string `- if $join is an array, the first item will be the default glue, and the second item` will be used instead of the glue for the last item `- if $join is true, it will be guessed from the locale ('list' translation file entry)` - if $join is missing, a space will be used as glue - 'other' entry (see above) if int passed, it add modifiers: Possible values: - CarbonInterface::DIFF_ABSOLUTE no modifiers - CarbonInterface::DIFF_RELATIVE_TO_NOW add ago/from now modifier - CarbonInterface::DIFF_RELATIVE_TO_OTHER add before/after modifier Default value: CarbonInterface::DIFF_ABSOLUTE
`$short`	displays short format of time units
`$parts`	maximum number of parts to display (default value: 1: single unit)
`$options`	human diff options

#


					
	public
					static

useMonthsOverflow(bool $monthsOverflow = true): void

Deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather use the ->settings() method. Or you can use method variants: addMonthsWithOverflow/addMonthsNoOverflow, same variants are available for quarters, years, decade, centuries, millennia (singular and plural forms).

#


					
	public
					static

useStrictMode(bool $strictModeEnabled = true): void

Deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather use the ->settings() method.

#


					
	public
					static

useYearsOverflow(bool $yearsOverflow = true): void

Deprecated

To avoid conflict between different third-party libraries, static setters should not be used. You should rather use the ->settings() method. Or you can use method variants: addYearsWithOverflow/addYearsNoOverflow, same variants are available for quarters, years, decade, centuries, millennia (singular and plural forms).

#


					
	public

utc(): static

Set the instance's timezone to UTC.

#


					
	public

utcOffset(?int $minuteOffset = null): static|int

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

#


					
	public

valueOf(): float

Returns the milliseconds timestamps used amongst other by Date javascript objects.

#


					
	public

week(int|null $week = null, int|null $dayOfWeek = null, int|null $dayOfYear = null): int|static

Get/set the week number using given first day of week and first day of year included in the first week. Or use US…

Get/set the week number using given first day of week and first day of year included in the first week. Or use US format if no settings given (Sunday / Jan 6).

#


					
	public

weekYear(int|null $year = null, int|null $dayOfWeek = null, int|null $dayOfYear = null): int|static

Set/get the week number of year using given first day of week and first day of year included in the first week. Or use…

Set/get the week number of year using given first day of week and first day of year included in the first week. Or use US format if no settings given (Sunday / Jan 6).

Parameters

`$year`	if null, act as a getter, if not null, set the year and return current instance.
`$dayOfWeek`	first date of week from 0 (Sunday) to 6 (Saturday)
`$dayOfYear`	first day of year included in the week #1

#


					
	public

weekday(WeekDay|int|null $value = null): static|int

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

Parameters

$value

new value for weekday if using as setter.

#


					
	public

weeksInYear(int|null $dayOfWeek = null, int|null $dayOfYear = null): int

Get the number of weeks of the current week-year using given first day of week and first day of year included in the…

Get the number of weeks of the current week-year using given first day of week and first day of year included in the first week. Or use US format if no settings given (Sunday / Jan 6).

Parameters

`$dayOfWeek`	first date of week from 0 (Sunday) to 6 (Saturday)
`$dayOfYear`	first day of year included in the week #1

#


					
	public
					static

Temporarily sets a static date to be used within the callback. Using setTestNow to set the date, executing the callback…

Temporarily sets a static date to be used within the callback. Using setTestNow to set the date, executing the callback, then clearing the test instance.

/!\ Use this method for unit tests only.

Parameters

$testNow

real or mock Carbon instance

#


					
	public
					static

yesterday(DateTimeZone|string|int|null $timezone = null): static

Create a Carbon instance for yesterday.

#


					
	public

isUtc(): bool

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

Implemented by

#


					
	public

isLocal(): bool

Check if the current instance has non-UTC timezone.

Implemented by

#


					
	public

isValid(): bool

Check if the current instance is a valid date.

Implemented by

#


					
	public

isDST(): bool

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

Implemented by

#


					
	public

isSunday(): bool

Checks if the instance day is sunday.

Implemented by

#


					
	public

isMonday(): bool

Checks if the instance day is monday.

Implemented by

#


					
	public

isTuesday(): bool

Checks if the instance day is tuesday.

Implemented by

#


					
	public

isWednesday(): bool

Checks if the instance day is wednesday.

Implemented by

#


					
	public

isThursday(): bool

Checks if the instance day is thursday.

Implemented by

#


					
	public

isFriday(): bool

Checks if the instance day is friday.

Implemented by

#


					
	public

isSaturday(): bool

Checks if the instance day is saturday.

Implemented by

#


					
	public

isSameYear(DateTimeInterface|string $date): bool

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

Implemented by

#


					
	public

isCurrentYear(): bool

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

Implemented by

#


					
	public

isNextYear(): bool

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

Implemented by

#


					
	public

isLastYear(): bool

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

Implemented by

#


					
	public

isCurrentMonth(): bool

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

Implemented by

#


					
	public

isNextMonth(): bool

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

Implemented by

#


					
	public

isLastMonth(): bool

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

Implemented by

#


					
	public

isSameWeek(DateTimeInterface|string $date): bool

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

Implemented by

#


					
	public

isCurrentWeek(): bool

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

Implemented by

#


					
	public

isNextWeek(): bool

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

Implemented by

#


					
	public

isLastWeek(): bool

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

Implemented by

#


					
	public

isSameDay(DateTimeInterface|string $date): bool

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

Implemented by

#


					
	public

isCurrentDay(): bool

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

Implemented by

#


					
	public

isNextDay(): bool

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

Implemented by

#


					
	public

isLastDay(): bool

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

Implemented by

#


					
	public

isSameHour(DateTimeInterface|string $date): bool

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

Implemented by

#


					
	public

isCurrentHour(): bool

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

Implemented by

#


					
	public

isNextHour(): bool

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

Implemented by

#


					
	public

isLastHour(): bool

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

Implemented by

#


					
	public

isSameMinute(DateTimeInterface|string $date): bool

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

Implemented by

#


					
	public

isCurrentMinute(): bool

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

Implemented by

#


					
	public

isNextMinute(): bool

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

Implemented by

#


					
	public

isLastMinute(): bool

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

Implemented by

#


					
	public

isSameSecond(DateTimeInterface|string $date): bool

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

Implemented by

#


					
	public

isCurrentSecond(): bool

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

Implemented by

#


					
	public

isNextSecond(): bool

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

Implemented by

#


					
	public

isLastSecond(): bool

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

Implemented by

#


					
	public

isSameMilli(DateTimeInterface|string $date): bool

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

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

Implemented by

#


					
	public

isCurrentMilli(): bool

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

Implemented by

#


					
	public

isNextMilli(): bool

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

Implemented by

#


					
	public

isLastMilli(): bool

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

Implemented by

#


					
	public

isSameMillisecond(DateTimeInterface|string $date): bool

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

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

Implemented by

#


					
	public

isCurrentMillisecond(): bool

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

Implemented by

#


					
	public

isNextMillisecond(): bool

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

Implemented by

#


					
	public

isLastMillisecond(): bool

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

Implemented by

#


					
	public

isSameMicro(DateTimeInterface|string $date): bool

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

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

Implemented by

#


					
	public

isCurrentMicro(): bool

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

Implemented by

#


					
	public

isNextMicro(): bool

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

Implemented by

#


					
	public

isLastMicro(): bool

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

Implemented by

#


					
	public

isSameMicrosecond(DateTimeInterface|string $date): bool

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

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

Implemented by

#


					
	public

isCurrentMicrosecond(): bool

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

Implemented by

#


					
	public

isNextMicrosecond(): bool

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

Implemented by

#


					
	public

isLastMicrosecond(): bool

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

Implemented by

#


					
	public

isSameDecade(DateTimeInterface|string $date): bool

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

Implemented by

#


					
	public

isCurrentDecade(): bool

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

Implemented by

#


					
	public

isNextDecade(): bool

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

Implemented by

#


					
	public

isLastDecade(): bool

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

Implemented by

#


					
	public

isSameCentury(DateTimeInterface|string $date): bool

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

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

Implemented by

#


					
	public

isCurrentCentury(): bool

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

Implemented by

#


					
	public

isNextCentury(): bool

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

Implemented by

#


					
	public

isLastCentury(): bool

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

Implemented by

#


					
	public

isSameMillennium(DateTimeInterface|string $date): bool

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

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

Implemented by

#


					
	public

isCurrentMillennium(): bool

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

Implemented by

#


					
	public

isNextMillennium(): bool

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

Implemented by

#


					
	public

isLastMillennium(): bool

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

Implemented by

#


					
	public

isCurrentQuarter(): bool

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

Implemented by

#


					
	public

isNextQuarter(): bool

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

Implemented by

#


					
	public

isLastQuarter(): bool

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

Implemented by

#


					
	public

years(int $value): CarbonInterface

Set current instance year to the given value.

Implemented by

#


					
	public

year(int $value): CarbonInterface

Set current instance year to the given value.

Implemented by

#


					
	public

setYears(int $value): CarbonInterface

Set current instance year to the given value.

Implemented by

#


					
	public

setYear(int $value): CarbonInterface

Set current instance year to the given value.

Implemented by

#


					
	public

months(Month|int $value): CarbonInterface

Set current instance month to the given value.

Implemented by

#


					
	public

month(Month|int $value): CarbonInterface

Set current instance month to the given value.

Implemented by

#


					
	public

setMonths(Month|int $value): CarbonInterface

Set current instance month to the given value.

Implemented by

#


					
	public

setMonth(Month|int $value): CarbonInterface

Set current instance month to the given value.

Implemented by

#


					
	public

days(int $value): CarbonInterface

Set current instance day to the given value.

Implemented by

#


					
	public

day(int $value): CarbonInterface

Set current instance day to the given value.

Implemented by

#


					
	public

setDays(int $value): CarbonInterface

Set current instance day to the given value.

Implemented by

#


					
	public

setDay(int $value): CarbonInterface

Set current instance day to the given value.

Implemented by

#


					
	public

hours(int $value): CarbonInterface

Set current instance hour to the given value.

Implemented by

#


					
	public

hour(int $value): CarbonInterface

Set current instance hour to the given value.

Implemented by

#


					
	public

setHours(int $value): CarbonInterface

Set current instance hour to the given value.

Implemented by

#


					
	public

setHour(int $value): CarbonInterface

Set current instance hour to the given value.

Implemented by

#


					
	public

minutes(int $value): CarbonInterface

Set current instance minute to the given value.

Implemented by

#


					
	public

minute(int $value): CarbonInterface

Set current instance minute to the given value.

Implemented by

#


					
	public

setMinutes(int $value): CarbonInterface

Set current instance minute to the given value.

Implemented by

#


					
	public

setMinute(int $value): CarbonInterface

Set current instance minute to the given value.

Implemented by

#


					
	public

seconds(int $value): CarbonInterface

Set current instance second to the given value.

Implemented by

#


					
	public

second(int $value): CarbonInterface

Set current instance second to the given value.

Implemented by

#


					
	public

setSeconds(int $value): CarbonInterface

Set current instance second to the given value.

Implemented by

#


					
	public

setSecond(int $value): CarbonInterface

Set current instance second to the given value.

Implemented by

#


					
	public

millis(int $value): CarbonInterface

Set current instance millisecond to the given value.

Implemented by

#


					
	public

milli(int $value): CarbonInterface

Set current instance millisecond to the given value.

Implemented by

#


					
	public

setMillis(int $value): CarbonInterface

Set current instance millisecond to the given value.

Implemented by

#


					
	public

setMilli(int $value): CarbonInterface

Set current instance millisecond to the given value.

Implemented by

#


					
	public

milliseconds(int $value): CarbonInterface

Set current instance millisecond to the given value.

Implemented by

#


					
	public

millisecond(int $value): CarbonInterface

Set current instance millisecond to the given value.

Implemented by

#


					
	public

setMilliseconds(int $value): CarbonInterface

Set current instance millisecond to the given value.

Implemented by

#


					
	public

setMillisecond(int $value): CarbonInterface

Set current instance millisecond to the given value.

Implemented by

#


					
	public

micros(int $value): CarbonInterface

Set current instance microsecond to the given value.

Implemented by

#


					
	public

micro(int $value): CarbonInterface

Set current instance microsecond to the given value.

Implemented by

#


					
	public

setMicros(int $value): CarbonInterface

Set current instance microsecond to the given value.

Implemented by

#


					
	public

setMicro(int $value): CarbonInterface

Set current instance microsecond to the given value.

Implemented by

#


					
	public

microseconds(int $value): CarbonInterface

Set current instance microsecond to the given value.

Implemented by

#


					
	public

microsecond(int $value): CarbonInterface

Set current instance microsecond to the given value.

Implemented by

#


					
	public

setMicroseconds(int $value): CarbonInterface

Set current instance microsecond to the given value.

Implemented by

#


					
	public

setMicrosecond(int $value): self

Set current instance microsecond to the given value.

Implemented by

#


					
	public

addYears(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addYear(): CarbonInterface

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

Implemented by

#


					
	public

subYears(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subYear(): CarbonInterface

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

Implemented by

#


					
	public

addYearsWithOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addYearWithOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subYearsWithOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subYearWithOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addYearsWithoutOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addYearWithoutOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subYearsWithoutOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subYearWithoutOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addYearsWithNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addYearWithNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subYearsWithNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subYearWithNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addYearsNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addYearNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subYearsNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subYearNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addMonths(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMonth(): CarbonInterface

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

Implemented by

#


					
	public

subMonths(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMonth(): CarbonInterface

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

Implemented by

#


					
	public

addMonthsWithOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMonthWithOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subMonthsWithOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMonthWithOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addMonthsWithoutOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMonthWithoutOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subMonthsWithoutOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMonthWithoutOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addMonthsWithNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMonthWithNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subMonthsWithNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMonthWithNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addMonthsNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMonthNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subMonthsNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMonthNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addDays(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addDay(): CarbonInterface

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

Implemented by

#


					
	public

subDays(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subDay(): CarbonInterface

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

Implemented by

#


					
	public

addHours(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addHour(): CarbonInterface

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

Implemented by

#


					
	public

subHours(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subHour(): CarbonInterface

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

Implemented by

#


					
	public

addMinutes(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMinute(): CarbonInterface

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

Implemented by

#


					
	public

subMinutes(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMinute(): CarbonInterface

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

Implemented by

#


					
	public

addSeconds(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addSecond(): CarbonInterface

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

Implemented by

#


					
	public

subSeconds(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subSecond(): CarbonInterface

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

Implemented by

#


					
	public

addMillis(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMilli(): CarbonInterface

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

Implemented by

#


					
	public

subMillis(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMilli(): CarbonInterface

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

Implemented by

#


					
	public

addMilliseconds(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMillisecond(): CarbonInterface

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

Implemented by

#


					
	public

subMilliseconds(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMillisecond(): CarbonInterface

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

Implemented by

#


					
	public

addMicros(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMicro(): CarbonInterface

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

Implemented by

#


					
	public

subMicros(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMicro(): CarbonInterface

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

Implemented by

#


					
	public

addMicroseconds(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMicrosecond(): CarbonInterface

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

Implemented by

#


					
	public

subMicroseconds(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMicrosecond(): CarbonInterface

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

Implemented by

#


					
	public

addMillennia(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMillennium(): CarbonInterface

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

Implemented by

#


					
	public

subMillennia(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMillennium(): CarbonInterface

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

Implemented by

#


					
	public

addMillenniaWithOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMillenniumWithOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subMillenniaWithOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMillenniumWithOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addMillenniaWithoutOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMillenniumWithoutOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subMillenniaWithoutOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMillenniumWithoutOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addMillenniaWithNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMillenniumWithNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subMillenniaWithNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMillenniumWithNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addMillenniaNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addMillenniumNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subMillenniaNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subMillenniumNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addCenturies(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addCentury(): CarbonInterface

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

Implemented by

#


					
	public

subCenturies(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subCentury(): CarbonInterface

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

Implemented by

#


					
	public

addCenturiesWithOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addCenturyWithOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subCenturiesWithOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subCenturyWithOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addCenturiesWithoutOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addCenturyWithoutOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subCenturiesWithoutOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subCenturyWithoutOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addCenturiesWithNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addCenturyWithNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subCenturiesWithNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subCenturyWithNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addCenturiesNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addCenturyNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subCenturiesNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subCenturyNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addDecades(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addDecade(): CarbonInterface

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

Implemented by

#


					
	public

subDecades(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subDecade(): CarbonInterface

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

Implemented by

#


					
	public

addDecadesWithOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addDecadeWithOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subDecadesWithOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subDecadeWithOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addDecadesWithoutOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addDecadeWithoutOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subDecadesWithoutOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subDecadeWithoutOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addDecadesWithNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addDecadeWithNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subDecadesWithNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subDecadeWithNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addDecadesNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addDecadeNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subDecadesNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subDecadeNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addQuarters(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addQuarter(): CarbonInterface

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

Implemented by

#


					
	public

subQuarters(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subQuarter(): CarbonInterface

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

Implemented by

#


					
	public

addQuartersWithOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addQuarterWithOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subQuartersWithOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subQuarterWithOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addQuartersWithoutOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addQuarterWithoutOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subQuartersWithoutOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subQuarterWithoutOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addQuartersWithNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addQuarterWithNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subQuartersWithNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subQuarterWithNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addQuartersNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addQuarterNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

subQuartersNoOverflow(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subQuarterNoOverflow(): CarbonInterface

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

Implemented by

#


					
	public

addWeeks(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addWeek(): CarbonInterface

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

Implemented by

#


					
	public

subWeeks(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subWeek(): CarbonInterface

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

Implemented by

#


					
	public

addWeekdays(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addWeekday(): CarbonInterface

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

Implemented by

#


					
	public

subWeekdays(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subWeekday(): CarbonInterface

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

Implemented by

#


					
	public

addUTCMicros(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCMicro(): CarbonInterface

Add one microsecond to the instance (using timestamp).

Implemented by

#


					
	public

subUTCMicros(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCMicro(): CarbonInterface

Sub one microsecond to the instance (using timestamp).

Implemented by

#


					
	public

microsUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each microsecond or…

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.

Implemented by

#


					
	public

diffInUTCMicros(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of microseconds.

Implemented by

#


					
	public

addUTCMicroseconds(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCMicrosecond(): CarbonInterface

Add one microsecond to the instance (using timestamp).

Implemented by

#


					
	public

subUTCMicroseconds(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCMicrosecond(): CarbonInterface

Sub one microsecond to the instance (using timestamp).

Implemented by

#


					
	public

microsecondsUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each microsecond or…

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.

Implemented by

#


					
	public

diffInUTCMicroseconds(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of microseconds.

Implemented by

#


					
	public

addUTCMillis(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCMilli(): CarbonInterface

Add one millisecond to the instance (using timestamp).

Implemented by

#


					
	public

subUTCMillis(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCMilli(): CarbonInterface

Sub one millisecond to the instance (using timestamp).

Implemented by

#


					
	public

millisUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each millisecond or…

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.

Implemented by

#


					
	public

diffInUTCMillis(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of milliseconds.

Implemented by

#


					
	public

addUTCMilliseconds(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCMillisecond(): CarbonInterface

Add one millisecond to the instance (using timestamp).

Implemented by

#


					
	public

subUTCMilliseconds(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCMillisecond(): CarbonInterface

Sub one millisecond to the instance (using timestamp).

Implemented by

#


					
	public

millisecondsUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each millisecond or…

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.

Implemented by

#


					
	public

diffInUTCMilliseconds(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of milliseconds.

Implemented by

#


					
	public

addUTCSeconds(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCSecond(): CarbonInterface

Add one second to the instance (using timestamp).

Implemented by

#


					
	public

subUTCSeconds(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCSecond(): CarbonInterface

Sub one second to the instance (using timestamp).

Implemented by

#


					
	public

secondsUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each second or every…

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.

Implemented by

#


					
	public

diffInUTCSeconds(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of seconds.

Implemented by

#


					
	public

addUTCMinutes(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCMinute(): CarbonInterface

Add one minute to the instance (using timestamp).

Implemented by

#


					
	public

subUTCMinutes(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCMinute(): CarbonInterface

Sub one minute to the instance (using timestamp).

Implemented by

#


					
	public

minutesUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each minute or every…

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.

Implemented by

#


					
	public

diffInUTCMinutes(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of minutes.

Implemented by

#


					
	public

addUTCHours(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCHour(): CarbonInterface

Add one hour to the instance (using timestamp).

Implemented by

#


					
	public

subUTCHours(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCHour(): CarbonInterface

Sub one hour to the instance (using timestamp).

Implemented by

#


					
	public

hoursUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each hour or every X…

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.

Implemented by

#


					
	public

diffInUTCHours(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of hours.

Implemented by

#


					
	public

addUTCDays(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCDay(): CarbonInterface

Add one day to the instance (using timestamp).

Implemented by

#


					
	public

subUTCDays(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCDay(): CarbonInterface

Sub one day to the instance (using timestamp).

Implemented by

#


					
	public

daysUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each day or every X…

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.

Implemented by

#


					
	public

diffInUTCDays(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of days.

Implemented by

#


					
	public

addUTCWeeks(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCWeek(): CarbonInterface

Add one week to the instance (using timestamp).

Implemented by

#


					
	public

subUTCWeeks(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCWeek(): CarbonInterface

Sub one week to the instance (using timestamp).

Implemented by

#


					
	public

weeksUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each week or every X…

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.

Implemented by

#


					
	public

diffInUTCWeeks(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of weeks.

Implemented by

#


					
	public

addUTCMonths(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCMonth(): CarbonInterface

Add one month to the instance (using timestamp).

Implemented by

#


					
	public

subUTCMonths(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCMonth(): CarbonInterface

Sub one month to the instance (using timestamp).

Implemented by

#


					
	public

monthsUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each month or every…

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.

Implemented by

#


					
	public

diffInUTCMonths(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of months.

Implemented by

#


					
	public

addUTCQuarters(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCQuarter(): CarbonInterface

Add one quarter to the instance (using timestamp).

Implemented by

#


					
	public

subUTCQuarters(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCQuarter(): CarbonInterface

Sub one quarter to the instance (using timestamp).

Implemented by

#


					
	public

quartersUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each quarter or…

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.

Implemented by

#


					
	public

diffInUTCQuarters(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of quarters.

Implemented by

#


					
	public

addUTCYears(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCYear(): CarbonInterface

Add one year to the instance (using timestamp).

Implemented by

#


					
	public

subUTCYears(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCYear(): CarbonInterface

Sub one year to the instance (using timestamp).

Implemented by

#


					
	public

yearsUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each year or every X…

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.

Implemented by

#


					
	public

diffInUTCYears(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of years.

Implemented by

#


					
	public

addUTCDecades(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCDecade(): CarbonInterface

Add one decade to the instance (using timestamp).

Implemented by

#


					
	public

subUTCDecades(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCDecade(): CarbonInterface

Sub one decade to the instance (using timestamp).

Implemented by

#


					
	public

decadesUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each decade or every…

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.

Implemented by

#


					
	public

diffInUTCDecades(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of decades.

Implemented by

#


					
	public

addUTCCenturies(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCCentury(): CarbonInterface

Add one century to the instance (using timestamp).

Implemented by

#


					
	public

subUTCCenturies(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCCentury(): CarbonInterface

Sub one century to the instance (using timestamp).

Implemented by

#


					
	public

centuriesUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each century or…

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.

Implemented by

#


					
	public

diffInUTCCenturies(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of centuries.

Implemented by

#


					
	public

addUTCMillennia(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

addUTCMillennium(): CarbonInterface

Add one millennium to the instance (using timestamp).

Implemented by

#


					
	public

subUTCMillennia(int|float $value = 1): CarbonInterface

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

Implemented by

#


					
	public

subUTCMillennium(): CarbonInterface

Sub one millennium to the instance (using timestamp).

Implemented by

#


					
	public

millenniaUntil($endDate = null, int|float $factor = 1): CarbonPeriod

Return an iterable period from current date to given end (string, DateTime or Carbon instance) for each millennium or…

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.

Implemented by

#


					
	public

diffInUTCMillennia(DateTimeInterface|string|null $date, bool $absolute = false): float

Convert current and given date in UTC timezone and return a floating number of millennia.

Implemented by

#


					
	public

roundYear(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

roundYears(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

floorYear(float $precision = 1): CarbonInterface

Truncate the current instance year with given precision.

Implemented by

#


					
	public

floorYears(float $precision = 1): CarbonInterface

Truncate the current instance year with given precision.

Implemented by

#


					
	public

ceilYear(float $precision = 1): CarbonInterface

Ceil the current instance year with given precision.

Implemented by

#


					
	public

ceilYears(float $precision = 1): CarbonInterface

Ceil the current instance year with given precision.

Implemented by

#


					
	public

roundMonth(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

roundMonths(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

floorMonth(float $precision = 1): CarbonInterface

Truncate the current instance month with given precision.

Implemented by

#


					
	public

floorMonths(float $precision = 1): CarbonInterface

Truncate the current instance month with given precision.

Implemented by

#


					
	public

ceilMonth(float $precision = 1): CarbonInterface

Ceil the current instance month with given precision.

Implemented by

#


					
	public

ceilMonths(float $precision = 1): CarbonInterface

Ceil the current instance month with given precision.

Implemented by

#


					
	public

roundDay(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

roundDays(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

floorDay(float $precision = 1): CarbonInterface

Truncate the current instance day with given precision.

Implemented by

#


					
	public

floorDays(float $precision = 1): CarbonInterface

Truncate the current instance day with given precision.

Implemented by

#


					
	public

ceilDay(float $precision = 1): CarbonInterface

Ceil the current instance day with given precision.

Implemented by

#


					
	public

ceilDays(float $precision = 1): CarbonInterface

Ceil the current instance day with given precision.

Implemented by

#


					
	public

roundHour(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

roundHours(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

floorHour(float $precision = 1): CarbonInterface

Truncate the current instance hour with given precision.

Implemented by

#


					
	public

floorHours(float $precision = 1): CarbonInterface

Truncate the current instance hour with given precision.

Implemented by

#


					
	public

ceilHour(float $precision = 1): CarbonInterface

Ceil the current instance hour with given precision.

Implemented by

#


					
	public

ceilHours(float $precision = 1): CarbonInterface

Ceil the current instance hour with given precision.

Implemented by

#


					
	public

roundMinute(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

roundMinutes(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

floorMinute(float $precision = 1): CarbonInterface

Truncate the current instance minute with given precision.

Implemented by

#


					
	public

floorMinutes(float $precision = 1): CarbonInterface

Truncate the current instance minute with given precision.

Implemented by

#


					
	public

ceilMinute(float $precision = 1): CarbonInterface

Ceil the current instance minute with given precision.

Implemented by

#


					
	public

ceilMinutes(float $precision = 1): CarbonInterface

Ceil the current instance minute with given precision.

Implemented by

#


					
	public

roundSecond(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

roundSeconds(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

floorSecond(float $precision = 1): CarbonInterface

Truncate the current instance second with given precision.

Implemented by

#


					
	public

floorSeconds(float $precision = 1): CarbonInterface

Truncate the current instance second with given precision.

Implemented by

#


					
	public

ceilSecond(float $precision = 1): CarbonInterface

Ceil the current instance second with given precision.

Implemented by

#


					
	public

ceilSeconds(float $precision = 1): CarbonInterface

Ceil the current instance second with given precision.

Implemented by

#


					
	public

roundMillennium(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

roundMillennia(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

floorMillennium(float $precision = 1): CarbonInterface

Truncate the current instance millennium with given precision.

Implemented by

#


					
	public

floorMillennia(float $precision = 1): CarbonInterface

Truncate the current instance millennium with given precision.

Implemented by

#


					
	public

ceilMillennium(float $precision = 1): CarbonInterface

Ceil the current instance millennium with given precision.

Implemented by

#


					
	public

ceilMillennia(float $precision = 1): CarbonInterface

Ceil the current instance millennium with given precision.

Implemented by

#


					
	public

roundCentury(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

roundCenturies(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

floorCentury(float $precision = 1): CarbonInterface

Truncate the current instance century with given precision.

Implemented by

#


					
	public

floorCenturies(float $precision = 1): CarbonInterface

Truncate the current instance century with given precision.

Implemented by

#


					
	public

ceilCentury(float $precision = 1): CarbonInterface

Ceil the current instance century with given precision.

Implemented by

#


					
	public

ceilCenturies(float $precision = 1): CarbonInterface

Ceil the current instance century with given precision.

Implemented by

#


					
	public

roundDecade(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

roundDecades(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

floorDecade(float $precision = 1): CarbonInterface

Truncate the current instance decade with given precision.

Implemented by

#


					
	public

floorDecades(float $precision = 1): CarbonInterface

Truncate the current instance decade with given precision.

Implemented by

#


					
	public

ceilDecade(float $precision = 1): CarbonInterface

Ceil the current instance decade with given precision.

Implemented by

#


					
	public

ceilDecades(float $precision = 1): CarbonInterface

Ceil the current instance decade with given precision.

Implemented by

#


					
	public

roundQuarter(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

roundQuarters(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

floorQuarter(float $precision = 1): CarbonInterface

Truncate the current instance quarter with given precision.

Implemented by

#


					
	public

floorQuarters(float $precision = 1): CarbonInterface

Truncate the current instance quarter with given precision.

Implemented by

#


					
	public

ceilQuarter(float $precision = 1): CarbonInterface

Ceil the current instance quarter with given precision.

Implemented by

#


					
	public

ceilQuarters(float $precision = 1): CarbonInterface

Ceil the current instance quarter with given precision.

Implemented by

#


					
	public

roundMillisecond(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

roundMilliseconds(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

floorMillisecond(float $precision = 1): CarbonInterface

Truncate the current instance millisecond with given precision.

Implemented by

#


					
	public

floorMilliseconds(float $precision = 1): CarbonInterface

Truncate the current instance millisecond with given precision.

Implemented by

#


					
	public

ceilMillisecond(float $precision = 1): CarbonInterface

Ceil the current instance millisecond with given precision.

Implemented by

#


					
	public

ceilMilliseconds(float $precision = 1): CarbonInterface

Ceil the current instance millisecond with given precision.

Implemented by

#


					
	public

roundMicrosecond(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

roundMicroseconds(float $precision = 1, string $function = "\"round\""): CarbonInterface

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

Implemented by

#


					
	public

floorMicrosecond(float $precision = 1): CarbonInterface

Truncate the current instance microsecond with given precision.

Implemented by

#


					
	public

floorMicroseconds(float $precision = 1): CarbonInterface

Truncate the current instance microsecond with given precision.

Implemented by

#


					
	public

ceilMicrosecond(float $precision = 1): CarbonInterface

Ceil the current instance microsecond with given precision.

Implemented by

#


					
	public

ceilMicroseconds(float $precision = 1): CarbonInterface

Ceil the current instance microsecond with given precision.

Implemented by

#


					
	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…

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

Implemented by

#


					
	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…

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

Implemented by

#


					
	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…

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

Implemented by

#


					
	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…

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

Implemented by

#


					
	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 …

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

Implemented by

#


					
	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 …

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

Implemented by

#


					
	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…

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

Implemented by

#


					
	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 …

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

Implemented by

#


					
	public

centuriesInMillennium(): int

Return the number of centuries contained in the current millennium

Implemented by

#


					
	public

centuryOfMillennium(?int $century = null): int|static

Return the value of the century starting from the beginning of the current millennium when called with no parameters,…

Return the value of the century starting from the beginning of the current millennium when called with no parameters, change the current century when called with an integer value

Implemented by

#


					
	public

dayOfCentury(?int $day = null): int|static

Return the value of the day starting from the beginning of the current century when called with no parameters, change…

Return the value of the day starting from the beginning of the current century when called with no parameters, change the current day when called with an integer value

Implemented by

#


					
	public

dayOfDecade(?int $day = null): int|static

Return the value of the day starting from the beginning of the current decade when called with no parameters, change…

Return the value of the day starting from the beginning of the current decade when called with no parameters, change the current day when called with an integer value

Implemented by

#


					
	public

dayOfMillennium(?int $day = null): int|static

Return the value of the day starting from the beginning of the current millennium when called with no parameters,…

Return the value of the day starting from the beginning of the current millennium when called with no parameters, change the current day when called with an integer value

Implemented by

#


					
	public

dayOfMonth(?int $day = null): int|static

Return the value of the day starting from the beginning of the current month when called with no parameters, change the…

Return the value of the day starting from the beginning of the current month when called with no parameters, change the current day when called with an integer value

Implemented by

#


					
	public

dayOfQuarter(?int $day = null): int|static

Return the value of the day starting from the beginning of the current quarter when called with no parameters, change…

Return the value of the day starting from the beginning of the current quarter when called with no parameters, change the current day when called with an integer value

Implemented by

#


					
	public

dayOfWeek(?int $day = null): int|static

Return the value of the day starting from the beginning of the current week when called with no parameters, change the…

Return the value of the day starting from the beginning of the current week when called with no parameters, change the current day when called with an integer value

Implemented by

#


					
	public

daysInCentury(): int

Return the number of days contained in the current century

Implemented by

#


					
	public

daysInDecade(): int

Return the number of days contained in the current decade

Implemented by

#


					
	public

daysInMillennium(): int

Return the number of days contained in the current millennium

Implemented by

#


					
	public

daysInMonth(): int

Return the number of days contained in the current month

Implemented by

#


					
	public

daysInQuarter(): int

Return the number of days contained in the current quarter

Implemented by

#


					
	public

daysInWeek(): int

Return the number of days contained in the current week

Implemented by

#


					
	public

daysInYear(): int

Return the number of days contained in the current year

Implemented by

#


					
	public

decadeOfCentury(?int $decade = null): int|static

Return the value of the decade starting from the beginning of the current century when called with no parameters,…

Return the value of the decade starting from the beginning of the current century when called with no parameters, change the current decade when called with an integer value

Implemented by

#


					
	public

decadeOfMillennium(?int $decade = null): int|static

Return the value of the decade starting from the beginning of the current millennium when called with no parameters,…

Return the value of the decade starting from the beginning of the current millennium when called with no parameters, change the current decade when called with an integer value

Implemented by

#


					
	public

decadesInCentury(): int

Return the number of decades contained in the current century

Implemented by

#


					
	public

decadesInMillennium(): int

Return the number of decades contained in the current millennium

Implemented by

#


					
	public

hourOfCentury(?int $hour = null): int|static

Return the value of the hour starting from the beginning of the current century when called with no parameters, change…

Return the value of the hour starting from the beginning of the current century when called with no parameters, change the current hour when called with an integer value

Implemented by

#


					
	public

hourOfDay(?int $hour = null): int|static

Return the value of the hour starting from the beginning of the current day when called with no parameters, change the…

Return the value of the hour starting from the beginning of the current day when called with no parameters, change the current hour when called with an integer value

Implemented by

#


					
	public

hourOfDecade(?int $hour = null): int|static

Return the value of the hour starting from the beginning of the current decade when called with no parameters, change…

Return the value of the hour starting from the beginning of the current decade when called with no parameters, change the current hour when called with an integer value

Implemented by

#


					
	public

hourOfMillennium(?int $hour = null): int|static

Return the value of the hour starting from the beginning of the current millennium when called with no parameters,…

Return the value of the hour starting from the beginning of the current millennium when called with no parameters, change the current hour when called with an integer value

Implemented by

#


					
	public

hourOfMonth(?int $hour = null): int|static

Return the value of the hour starting from the beginning of the current month when called with no parameters, change…

Return the value of the hour starting from the beginning of the current month when called with no parameters, change the current hour when called with an integer value

Implemented by

#


					
	public

hourOfQuarter(?int $hour = null): int|static

Return the value of the hour starting from the beginning of the current quarter when called with no parameters, change…

Return the value of the hour starting from the beginning of the current quarter when called with no parameters, change the current hour when called with an integer value

Implemented by

#


					
	public

hourOfWeek(?int $hour = null): int|static

Return the value of the hour starting from the beginning of the current week when called with no parameters, change the…

Return the value of the hour starting from the beginning of the current week when called with no parameters, change the current hour when called with an integer value

Implemented by

#


					
	public

hourOfYear(?int $hour = null): int|static

Return the value of the hour starting from the beginning of the current year when called with no parameters, change the…

Return the value of the hour starting from the beginning of the current year when called with no parameters, change the current hour when called with an integer value

Implemented by

#


					
	public

hoursInCentury(): int

Return the number of hours contained in the current century

Implemented by

#


					
	public

hoursInDay(): int

Return the number of hours contained in the current day

Implemented by

#


					
	public

hoursInDecade(): int

Return the number of hours contained in the current decade

Implemented by

#


					
	public

hoursInMillennium(): int

Return the number of hours contained in the current millennium

Implemented by

#


					
	public

hoursInMonth(): int

Return the number of hours contained in the current month

Implemented by

#


					
	public

hoursInQuarter(): int

Return the number of hours contained in the current quarter

Implemented by

#


					
	public

hoursInWeek(): int

Return the number of hours contained in the current week

Implemented by

#


					
	public

hoursInYear(): int

Return the number of hours contained in the current year

Implemented by

#


					
	public

microsecondOfCentury(?int $microsecond = null): int|static

Return the value of the microsecond starting from the beginning of the current century when called with no parameters,…

Return the value of the microsecond starting from the beginning of the current century when called with no parameters, change the current microsecond when called with an integer value

Implemented by

#


					
	public

microsecondOfDay(?int $microsecond = null): int|static

Return the value of the microsecond starting from the beginning of the current day when called with no parameters,…

Return the value of the microsecond starting from the beginning of the current day when called with no parameters, change the current microsecond when called with an integer value

Implemented by

#


					
	public

microsecondOfDecade(?int $microsecond = null): int|static

Return the value of the microsecond starting from the beginning of the current decade when called with no parameters,…

Return the value of the microsecond starting from the beginning of the current decade when called with no parameters, change the current microsecond when called with an integer value

Implemented by

#


					
	public

microsecondOfHour(?int $microsecond = null): int|static

Return the value of the microsecond starting from the beginning of the current hour when called with no parameters,…

Return the value of the microsecond starting from the beginning of the current hour when called with no parameters, change the current microsecond when called with an integer value

Implemented by

#


					
	public

microsecondOfMillennium(?int $microsecond = null): int|static

Return the value of the microsecond starting from the beginning of the current millennium when called with no…

Return the value of the microsecond starting from the beginning of the current millennium when called with no parameters, change the current microsecond when called with an integer value

Implemented by

#


					
	public

microsecondOfMillisecond(?int $microsecond = null): int|static

Return the value of the microsecond starting from the beginning of the current millisecond when called with no…

Return the value of the microsecond starting from the beginning of the current millisecond when called with no parameters, change the current microsecond when called with an integer value

Implemented by

#


					
	public

microsecondOfMinute(?int $microsecond = null): int|static

Return the value of the microsecond starting from the beginning of the current minute when called with no parameters,…

Return the value of the microsecond starting from the beginning of the current minute when called with no parameters, change the current microsecond when called with an integer value

Implemented by

#


					
	public

microsecondOfMonth(?int $microsecond = null): int|static

Return the value of the microsecond starting from the beginning of the current month when called with no parameters,…

Return the value of the microsecond starting from the beginning of the current month when called with no parameters, change the current microsecond when called with an integer value

Implemented by

#


					
	public

microsecondOfQuarter(?int $microsecond = null): int|static

Return the value of the microsecond starting from the beginning of the current quarter when called with no parameters,…

Return the value of the microsecond starting from the beginning of the current quarter when called with no parameters, change the current microsecond when called with an integer value

Implemented by

#


					
	public

microsecondOfSecond(?int $microsecond = null): int|static

Return the value of the microsecond starting from the beginning of the current second when called with no parameters,…

Return the value of the microsecond starting from the beginning of the current second when called with no parameters, change the current microsecond when called with an integer value

Implemented by

#


					
	public

microsecondOfWeek(?int $microsecond = null): int|static

Return the value of the microsecond starting from the beginning of the current week when called with no parameters,…

Return the value of the microsecond starting from the beginning of the current week when called with no parameters, change the current microsecond when called with an integer value

Implemented by

#


					
	public

microsecondOfYear(?int $microsecond = null): int|static

Return the value of the microsecond starting from the beginning of the current year when called with no parameters,…

Return the value of the microsecond starting from the beginning of the current year when called with no parameters, change the current microsecond when called with an integer value

Implemented by

#


					
	public

microsecondsInCentury(): int

Return the number of microseconds contained in the current century

Implemented by

#


					
	public

microsecondsInDay(): int

Return the number of microseconds contained in the current day

Implemented by

#


					
	public

microsecondsInDecade(): int

Return the number of microseconds contained in the current decade

Implemented by

#


					
	public

microsecondsInHour(): int

Return the number of microseconds contained in the current hour

Implemented by

#


					
	public

microsecondsInMillennium(): int

Return the number of microseconds contained in the current millennium

Implemented by

#


					
	public

microsecondsInMillisecond(): int

Return the number of microseconds contained in the current millisecond

Implemented by

#


					
	public

microsecondsInMinute(): int

Return the number of microseconds contained in the current minute

Implemented by

#


					
	public

microsecondsInMonth(): int

Return the number of microseconds contained in the current month

Implemented by

#


					
	public

microsecondsInQuarter(): int

Return the number of microseconds contained in the current quarter

Implemented by

#


					
	public

microsecondsInSecond(): int

Return the number of microseconds contained in the current second

Implemented by

#


					
	public

microsecondsInWeek(): int

Return the number of microseconds contained in the current week

Implemented by

#


					
	public

microsecondsInYear(): int

Return the number of microseconds contained in the current year

Implemented by

#


					
	public

millisecondOfCentury(?int $millisecond = null): int|static

Return the value of the millisecond starting from the beginning of the current century when called with no parameters,…

Return the value of the millisecond starting from the beginning of the current century when called with no parameters, change the current millisecond when called with an integer value

Implemented by

#


					
	public

millisecondOfDay(?int $millisecond = null): int|static

Return the value of the millisecond starting from the beginning of the current day when called with no parameters,…

Return the value of the millisecond starting from the beginning of the current day when called with no parameters, change the current millisecond when called with an integer value

Implemented by

#


					
	public

millisecondOfDecade(?int $millisecond = null): int|static

Return the value of the millisecond starting from the beginning of the current decade when called with no parameters,…

Return the value of the millisecond starting from the beginning of the current decade when called with no parameters, change the current millisecond when called with an integer value

Implemented by

#


					
	public

millisecondOfHour(?int $millisecond = null): int|static

Return the value of the millisecond starting from the beginning of the current hour when called with no parameters,…

Return the value of the millisecond starting from the beginning of the current hour when called with no parameters, change the current millisecond when called with an integer value

Implemented by

#


					
	public

millisecondOfMillennium(?int $millisecond = null): int|static

Return the value of the millisecond starting from the beginning of the current millennium when called with no…

Return the value of the millisecond starting from the beginning of the current millennium when called with no parameters, change the current millisecond when called with an integer value

Implemented by

#


					
	public

millisecondOfMinute(?int $millisecond = null): int|static

Return the value of the millisecond starting from the beginning of the current minute when called with no parameters,…

Return the value of the millisecond starting from the beginning of the current minute when called with no parameters, change the current millisecond when called with an integer value

Implemented by

#


					
	public

millisecondOfMonth(?int $millisecond = null): int|static

Return the value of the millisecond starting from the beginning of the current month when called with no parameters,…

Return the value of the millisecond starting from the beginning of the current month when called with no parameters, change the current millisecond when called with an integer value

Implemented by

#


					
	public

millisecondOfQuarter(?int $millisecond = null): int|static

Return the value of the millisecond starting from the beginning of the current quarter when called with no parameters,…

Return the value of the millisecond starting from the beginning of the current quarter when called with no parameters, change the current millisecond when called with an integer value

Implemented by

#


					
	public

millisecondOfSecond(?int $millisecond = null): int|static

Return the value of the millisecond starting from the beginning of the current second when called with no parameters,…

Return the value of the millisecond starting from the beginning of the current second when called with no parameters, change the current millisecond when called with an integer value

Implemented by

#


					
	public

millisecondOfWeek(?int $millisecond = null): int|static

Return the value of the millisecond starting from the beginning of the current week when called with no parameters,…

Return the value of the millisecond starting from the beginning of the current week when called with no parameters, change the current millisecond when called with an integer value

Implemented by

#


					
	public

millisecondOfYear(?int $millisecond = null): int|static

Return the value of the millisecond starting from the beginning of the current year when called with no parameters,…

Return the value of the millisecond starting from the beginning of the current year when called with no parameters, change the current millisecond when called with an integer value

Implemented by

#


					
	public

millisecondsInCentury(): int

Return the number of milliseconds contained in the current century

Implemented by

#


					
	public

millisecondsInDay(): int

Return the number of milliseconds contained in the current day

Implemented by

#


					
	public

millisecondsInDecade(): int

Return the number of milliseconds contained in the current decade

Implemented by

#


					
	public

millisecondsInHour(): int

Return the number of milliseconds contained in the current hour

Implemented by

#


					
	public

millisecondsInMillennium(): int

Return the number of milliseconds contained in the current millennium

Implemented by

#


					
	public

millisecondsInMinute(): int

Return the number of milliseconds contained in the current minute

Implemented by

#


					
	public

millisecondsInMonth(): int

Return the number of milliseconds contained in the current month

Implemented by

#


					
	public

millisecondsInQuarter(): int

Return the number of milliseconds contained in the current quarter

Implemented by

#


					
	public

millisecondsInSecond(): int

Return the number of milliseconds contained in the current second

Implemented by

#


					
	public

millisecondsInWeek(): int

Return the number of milliseconds contained in the current week

Implemented by

#


					
	public

millisecondsInYear(): int

Return the number of milliseconds contained in the current year

Implemented by

#


					
	public

minuteOfCentury(?int $minute = null): int|static

Return the value of the minute starting from the beginning of the current century when called with no parameters,…

Return the value of the minute starting from the beginning of the current century when called with no parameters, change the current minute when called with an integer value

Implemented by

#


					
	public

minuteOfDay(?int $minute = null): int|static

Return the value of the minute starting from the beginning of the current day when called with no parameters, change…

Return the value of the minute starting from the beginning of the current day when called with no parameters, change the current minute when called with an integer value

Implemented by

#


					
	public

minuteOfDecade(?int $minute = null): int|static

Return the value of the minute starting from the beginning of the current decade when called with no parameters, change…

Return the value of the minute starting from the beginning of the current decade when called with no parameters, change the current minute when called with an integer value

Implemented by

#


					
	public

minuteOfHour(?int $minute = null): int|static

Return the value of the minute starting from the beginning of the current hour when called with no parameters, change…

Return the value of the minute starting from the beginning of the current hour when called with no parameters, change the current minute when called with an integer value

Implemented by

#


					
	public

minuteOfMillennium(?int $minute = null): int|static

Return the value of the minute starting from the beginning of the current millennium when called with no parameters,…

Return the value of the minute starting from the beginning of the current millennium when called with no parameters, change the current minute when called with an integer value

Implemented by

#


					
	public

minuteOfMonth(?int $minute = null): int|static

Return the value of the minute starting from the beginning of the current month when called with no parameters, change…

Return the value of the minute starting from the beginning of the current month when called with no parameters, change the current minute when called with an integer value

Implemented by

#


					
	public

minuteOfQuarter(?int $minute = null): int|static

Return the value of the minute starting from the beginning of the current quarter when called with no parameters,…

Return the value of the minute starting from the beginning of the current quarter when called with no parameters, change the current minute when called with an integer value

Implemented by

#


					
	public

minuteOfWeek(?int $minute = null): int|static

Return the value of the minute starting from the beginning of the current week when called with no parameters, change…

Return the value of the minute starting from the beginning of the current week when called with no parameters, change the current minute when called with an integer value

Implemented by

#


					
	public

minuteOfYear(?int $minute = null): int|static

Return the value of the minute starting from the beginning of the current year when called with no parameters, change…

Return the value of the minute starting from the beginning of the current year when called with no parameters, change the current minute when called with an integer value

Implemented by

#


					
	public

minutesInCentury(): int

Return the number of minutes contained in the current century

Implemented by

#


					
	public

minutesInDay(): int

Return the number of minutes contained in the current day

Implemented by

#


					
	public

minutesInDecade(): int

Return the number of minutes contained in the current decade

Implemented by

#


					
	public

minutesInHour(): int

Return the number of minutes contained in the current hour

Implemented by

#


					
	public

minutesInMillennium(): int

Return the number of minutes contained in the current millennium

Implemented by

#


					
	public

minutesInMonth(): int

Return the number of minutes contained in the current month

Implemented by

#


					
	public

minutesInQuarter(): int

Return the number of minutes contained in the current quarter

Implemented by

#


					
	public

minutesInWeek(): int

Return the number of minutes contained in the current week

Implemented by

#


					
	public

minutesInYear(): int

Return the number of minutes contained in the current year

Implemented by

#


					
	public

monthOfCentury(?int $month = null): int|static

Return the value of the month starting from the beginning of the current century when called with no parameters, change…

Return the value of the month starting from the beginning of the current century when called with no parameters, change the current month when called with an integer value

Implemented by

#


					
	public

monthOfDecade(?int $month = null): int|static

Return the value of the month starting from the beginning of the current decade when called with no parameters, change…

Return the value of the month starting from the beginning of the current decade when called with no parameters, change the current month when called with an integer value

Implemented by

#


					
	public

monthOfMillennium(?int $month = null): int|static

Return the value of the month starting from the beginning of the current millennium when called with no parameters,…

Return the value of the month starting from the beginning of the current millennium when called with no parameters, change the current month when called with an integer value

Implemented by

#


					
	public

monthOfQuarter(?int $month = null): int|static

Return the value of the month starting from the beginning of the current quarter when called with no parameters, change…

Return the value of the month starting from the beginning of the current quarter when called with no parameters, change the current month when called with an integer value

Implemented by

#


					
	public

monthOfYear(?int $month = null): int|static

Return the value of the month starting from the beginning of the current year when called with no parameters, change…

Return the value of the month starting from the beginning of the current year when called with no parameters, change the current month when called with an integer value

Implemented by

#


					
	public

monthsInCentury(): int

Return the number of months contained in the current century

Implemented by

#


					
	public

monthsInDecade(): int

Return the number of months contained in the current decade

Implemented by

#


					
	public

monthsInMillennium(): int

Return the number of months contained in the current millennium

Implemented by

#


					
	public

monthsInQuarter(): int

Return the number of months contained in the current quarter

Implemented by

#


					
	public

monthsInYear(): int

Return the number of months contained in the current year

Implemented by

#


					
	public

quarterOfCentury(?int $quarter = null): int|static

Return the value of the quarter starting from the beginning of the current century when called with no parameters,…

Return the value of the quarter starting from the beginning of the current century when called with no parameters, change the current quarter when called with an integer value

Implemented by

#


					
	public

quarterOfDecade(?int $quarter = null): int|static

Return the value of the quarter starting from the beginning of the current decade when called with no parameters,…

Return the value of the quarter starting from the beginning of the current decade when called with no parameters, change the current quarter when called with an integer value

Implemented by

#


					
	public

quarterOfMillennium(?int $quarter = null): int|static

Return the value of the quarter starting from the beginning of the current millennium when called with no parameters,…

Return the value of the quarter starting from the beginning of the current millennium when called with no parameters, change the current quarter when called with an integer value

Implemented by

#


					
	public

quarterOfYear(?int $quarter = null): int|static

Return the value of the quarter starting from the beginning of the current year when called with no parameters, change…

Return the value of the quarter starting from the beginning of the current year when called with no parameters, change the current quarter when called with an integer value

Implemented by

#


					
	public

quartersInCentury(): int

Return the number of quarters contained in the current century

Implemented by

#


					
	public

quartersInDecade(): int

Return the number of quarters contained in the current decade

Implemented by

#


					
	public

quartersInMillennium(): int

Return the number of quarters contained in the current millennium

Implemented by

#


					
	public

quartersInYear(): int

Return the number of quarters contained in the current year

Implemented by

#


					
	public

secondOfCentury(?int $second = null): int|static

Return the value of the second starting from the beginning of the current century when called with no parameters,…

Return the value of the second starting from the beginning of the current century when called with no parameters, change the current second when called with an integer value

Implemented by

#


					
	public

secondOfDay(?int $second = null): int|static

Return the value of the second starting from the beginning of the current day when called with no parameters, change…

Return the value of the second starting from the beginning of the current day when called with no parameters, change the current second when called with an integer value

Implemented by

#


					
	public

secondOfDecade(?int $second = null): int|static

Return the value of the second starting from the beginning of the current decade when called with no parameters, change…

Return the value of the second starting from the beginning of the current decade when called with no parameters, change the current second when called with an integer value

Implemented by

#


					
	public

secondOfHour(?int $second = null): int|static

Return the value of the second starting from the beginning of the current hour when called with no parameters, change…

Return the value of the second starting from the beginning of the current hour when called with no parameters, change the current second when called with an integer value

Implemented by

#


					
	public

secondOfMillennium(?int $second = null): int|static

Return the value of the second starting from the beginning of the current millennium when called with no parameters,…

Return the value of the second starting from the beginning of the current millennium when called with no parameters, change the current second when called with an integer value

Implemented by

#


					
	public

secondOfMinute(?int $second = null): int|static

Return the value of the second starting from the beginning of the current minute when called with no parameters, change…

Return the value of the second starting from the beginning of the current minute when called with no parameters, change the current second when called with an integer value

Implemented by

#


					
	public

secondOfMonth(?int $second = null): int|static

Return the value of the second starting from the beginning of the current month when called with no parameters, change…

Return the value of the second starting from the beginning of the current month when called with no parameters, change the current second when called with an integer value

Implemented by

#


					
	public

secondOfQuarter(?int $second = null): int|static

Return the value of the second starting from the beginning of the current quarter when called with no parameters,…

Return the value of the second starting from the beginning of the current quarter when called with no parameters, change the current second when called with an integer value

Implemented by

#


					
	public

secondOfWeek(?int $second = null): int|static

Return the value of the second starting from the beginning of the current week when called with no parameters, change…

Return the value of the second starting from the beginning of the current week when called with no parameters, change the current second when called with an integer value

Implemented by

#


					
	public

secondOfYear(?int $second = null): int|static

Return the value of the second starting from the beginning of the current year when called with no parameters, change…

Return the value of the second starting from the beginning of the current year when called with no parameters, change the current second when called with an integer value

Implemented by

#


					
	public

secondsInCentury(): int

Return the number of seconds contained in the current century

Implemented by

#


					
	public

secondsInDay(): int

Return the number of seconds contained in the current day

Implemented by

#


					
	public

secondsInDecade(): int

Return the number of seconds contained in the current decade

Implemented by

#


					
	public

secondsInHour(): int

Return the number of seconds contained in the current hour

Implemented by

#


					
	public

secondsInMillennium(): int

Return the number of seconds contained in the current millennium

Implemented by

#


					
	public

secondsInMinute(): int

Return the number of seconds contained in the current minute

Implemented by

#


					
	public

secondsInMonth(): int

Return the number of seconds contained in the current month

Implemented by

#


					
	public

secondsInQuarter(): int

Return the number of seconds contained in the current quarter

Implemented by

#


					
	public

secondsInWeek(): int

Return the number of seconds contained in the current week

Implemented by

#


					
	public

secondsInYear(): int

Return the number of seconds contained in the current year

Implemented by

#


					
	public

weekOfCentury(?int $week = null): int|static

Return the value of the week starting from the beginning of the current century when called with no parameters, change…

Return the value of the week starting from the beginning of the current century when called with no parameters, change the current week when called with an integer value

Implemented by

#


					
	public

weekOfDecade(?int $week = null): int|static

Return the value of the week starting from the beginning of the current decade when called with no parameters, change…

Return the value of the week starting from the beginning of the current decade when called with no parameters, change the current week when called with an integer value

Implemented by

#


					
	public

weekOfMillennium(?int $week = null): int|static

Return the value of the week starting from the beginning of the current millennium when called with no parameters,…

Return the value of the week starting from the beginning of the current millennium when called with no parameters, change the current week when called with an integer value

Implemented by

#


					
	public

weekOfMonth(?int $week = null): int|static

Return the value of the week starting from the beginning of the current month when called with no parameters, change…

Return the value of the week starting from the beginning of the current month when called with no parameters, change the current week when called with an integer value

Implemented by

#


					
	public

weekOfQuarter(?int $week = null): int|static

Return the value of the week starting from the beginning of the current quarter when called with no parameters, change…

Return the value of the week starting from the beginning of the current quarter when called with no parameters, change the current week when called with an integer value

Implemented by

#


					
	public

weekOfYear(?int $week = null): int|static

Return the value of the week starting from the beginning of the current year when called with no parameters, change the…

Return the value of the week starting from the beginning of the current year when called with no parameters, change the current week when called with an integer value

Implemented by

#


					
	public

weeksInCentury(): int

Return the number of weeks contained in the current century

Implemented by

#


					
	public

weeksInDecade(): int

Return the number of weeks contained in the current decade

Implemented by

#


					
	public

weeksInMillennium(): int

Return the number of weeks contained in the current millennium

Implemented by

#


					
	public

weeksInMonth(): int

Return the number of weeks contained in the current month

Implemented by

#


					
	public

weeksInQuarter(): int

Return the number of weeks contained in the current quarter

Implemented by

#


					
	public

yearOfCentury(?int $year = null): int|static

Return the value of the year starting from the beginning of the current century when called with no parameters, change…

Return the value of the year starting from the beginning of the current century when called with no parameters, change the current year when called with an integer value

Implemented by

#


					
	public

yearOfDecade(?int $year = null): int|static

Return the value of the year starting from the beginning of the current decade when called with no parameters, change…

Return the value of the year starting from the beginning of the current decade when called with no parameters, change the current year when called with an integer value

Implemented by

#


					
	public

yearOfMillennium(?int $year = null): int|static

Return the value of the year starting from the beginning of the current millennium when called with no parameters,…

Return the value of the year starting from the beginning of the current millennium when called with no parameters, change the current year when called with an integer value

Implemented by

#


					
	public

yearsInCentury(): int

Return the number of years contained in the current century

Implemented by

#


					
	public

yearsInDecade(): int

Return the number of years contained in the current decade

Implemented by

#


					
	public

yearsInMillennium(): int

Return the number of years contained in the current millennium

Implemented by

#

Namespaces

Classes

Interfaces

Enums

Interface Carbon\CarbonInterface

Parameters

Throws

Parameters

Throws

Implemented by

Throws

Throws

Throws

Deprecated

Parameters

Parameters

Parameters

Parameters

Parameters

Throws

Throws

Parameters

Throws

Parameters

Throws

Parameters

Throws

Parameters

Throws

Throws

Throws

Throws

Throws

Throws

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Deprecated

Deprecated

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Throws

Parameters

Throws

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Returns

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters