Blame view

public/vendor/nesbot/carbon/src/Carbon/Carbon.php 96.9 KB
86143e36f   Андрей Ларионов   Коммит вторник
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
  <?php
  
  /**
   * This file is part of the Carbon package.
   *
   * (c) Brian Nesbitt <brian@nesbot.com>
   *
   * For the full copyright and license information, please view the LICENSE
   * file that was distributed with this source code.
   */
  
  namespace Carbon;
  
  use Carbon\Traits\Date;
  use Carbon\Traits\DeprecatedProperties;
  use DateTime;
  use DateTimeInterface;
  use DateTimeZone;
  
  /**
   * A simple API extension for DateTime.
   *
   * @mixin DeprecatedProperties
   *
   * <autodoc generated by `composer phpdoc`>
   *
   * @property      int                 $year
   * @property      int                 $yearIso
   * @property      int                 $month
   * @property      int                 $day
   * @property      int                 $hour
   * @property      int                 $minute
   * @property      int                 $second
   * @property      int                 $micro
   * @property      int                 $microsecond
   * @property      int|float|string    $timestamp                                                                                      seconds since the Unix Epoch
   * @property      string              $englishDayOfWeek                                                                               the day of week in English
   * @property      string              $shortEnglishDayOfWeek                                                                          the abbreviated day of week in English
   * @property      string              $englishMonth                                                                                   the month in English
   * @property      string              $shortEnglishMonth                                                                              the abbreviated month in English
   * @property      int                 $milliseconds
   * @property      int                 $millisecond
   * @property      int                 $milli
   * @property      int                 $week                                                                                           1 through 53
   * @property      int                 $isoWeek                                                                                        1 through 53
   * @property      int                 $weekYear                                                                                       year according to week format
   * @property      int                 $isoWeekYear                                                                                    year according to ISO week format
   * @property      int                 $dayOfYear                                                                                      1 through 366
   * @property      int                 $age                                                                                            does a diffInYears() with default parameters
   * @property      int                 $offset                                                                                         the timezone offset in seconds from UTC
   * @property      int                 $offsetMinutes                                                                                  the timezone offset in minutes from UTC
   * @property      int                 $offsetHours                                                                                    the timezone offset in hours from UTC
   * @property      CarbonTimeZone      $timezone                                                                                       the current timezone
   * @property      CarbonTimeZone      $tz                                                                                             alias of $timezone
   * @property-read int                 $dayOfWeek                                                                                      0 (for Sunday) through 6 (for Saturday)
   * @property-read int                 $dayOfWeekIso                                                                                   1 (for Monday) through 7 (for Sunday)
   * @property-read int                 $weekOfYear                                                                                     ISO-8601 week number of year, weeks starting on Monday
   * @property-read int                 $daysInMonth                                                                                    number of days in the given month
   * @property-read string              $latinMeridiem                                                                                  "am"/"pm" (Ante meridiem or Post meridiem latin lowercase mark)
   * @property-read string              $latinUpperMeridiem                                                                             "AM"/"PM" (Ante meridiem or Post meridiem latin uppercase mark)
   * @property-read string              $timezoneAbbreviatedName                                                                        the current timezone abbreviated name
   * @property-read string              $tzAbbrName                                                                                     alias of $timezoneAbbreviatedName
   * @property-read string              $dayName                                                                                        long name of weekday translated according to Carbon locale, in english if no translation available for current language
   * @property-read string              $shortDayName                                                                                   short name of weekday translated according to Carbon locale, in english if no translation available for current language
   * @property-read string              $minDayName                                                                                     very short name of weekday translated according to Carbon locale, in english if no translation available for current language
   * @property-read string              $monthName                                                                                      long name of month translated according to Carbon locale, in english if no translation available for current language
   * @property-read string              $shortMonthName                                                                                 short name of month translated according to Carbon locale, in english if no translation available for current language
   * @property-read string              $meridiem                                                                                       lowercase meridiem mark translated according to Carbon locale, in latin if no translation available for current language
   * @property-read string              $upperMeridiem                                                                                  uppercase meridiem mark translated according to Carbon locale, in latin if no translation available for current language
   * @property-read int                 $noZeroHour                                                                                     current hour from 1 to 24
   * @property-read int                 $weeksInYear                                                                                    51 through 53
   * @property-read int                 $isoWeeksInYear                                                                                 51 through 53
   * @property-read int                 $weekOfMonth                                                                                    1 through 5
   * @property-read int                 $weekNumberInMonth                                                                              1 through 5
   * @property-read int                 $firstWeekDay                                                                                   0 through 6
   * @property-read int                 $lastWeekDay                                                                                    0 through 6
   * @property-read int                 $daysInYear                                                                                     365 or 366
   * @property-read int                 $quarter                                                                                        the quarter of this instance, 1 - 4
   * @property-read int                 $decade                                                                                         the decade of this instance
   * @property-read int                 $century                                                                                        the century of this instance
   * @property-read int                 $millennium                                                                                     the millennium of this instance
   * @property-read bool                $dst                                                                                            daylight savings time indicator, true if DST, false otherwise
   * @property-read bool                $local                                                                                          checks if the timezone is local, true if local, false otherwise
   * @property-read bool                $utc                                                                                            checks if the timezone is UTC, true if UTC, false otherwise
   * @property-read string              $timezoneName                                                                                   the current timezone name
   * @property-read string              $tzName                                                                                         alias of $timezoneName
   * @property-read string              $locale                                                                                         locale of the current instance
   *
   * @method        bool                isUtc()                                                                                         Check if the current instance has UTC timezone. (Both isUtc and isUTC cases are valid.)
   * @method        bool                isLocal()                                                                                       Check if the current instance has non-UTC timezone.
   * @method        bool                isValid()                                                                                       Check if the current instance is a valid date.
   * @method        bool                isDST()                                                                                         Check if the current instance is in a daylight saving time.
   * @method        bool                isSunday()                                                                                      Checks if the instance day is sunday.
   * @method        bool                isMonday()                                                                                      Checks if the instance day is monday.
   * @method        bool                isTuesday()                                                                                     Checks if the instance day is tuesday.
   * @method        bool                isWednesday()                                                                                   Checks if the instance day is wednesday.
   * @method        bool                isThursday()                                                                                    Checks if the instance day is thursday.
   * @method        bool                isFriday()                                                                                      Checks if the instance day is friday.
   * @method        bool                isSaturday()                                                                                    Checks if the instance day is saturday.
   * @method        bool                isSameYear(Carbon|DateTimeInterface|string|null $date = null)                                   Checks if the given date is in the same year as the instance. If null passed, compare to now (with the same timezone).
   * @method        bool                isCurrentYear()                                                                                 Checks if the instance is in the same year as the current moment.
   * @method        bool                isNextYear()                                                                                    Checks if the instance is in the same year as the current moment next year.
   * @method        bool                isLastYear()                                                                                    Checks if the instance is in the same year as the current moment last year.
   * @method        bool                isSameWeek(Carbon|DateTimeInterface|string|null $date = null)                                   Checks if the given date is in the same week as the instance. If null passed, compare to now (with the same timezone).
   * @method        bool                isCurrentWeek()                                                                                 Checks if the instance is in the same week as the current moment.
   * @method        bool                isNextWeek()                                                                                    Checks if the instance is in the same week as the current moment next week.
   * @method        bool                isLastWeek()                                                                                    Checks if the instance is in the same week as the current moment last week.
   * @method        bool                isSameDay(Carbon|DateTimeInterface|string|null $date = null)                                    Checks if the given date is in the same day as the instance. If null passed, compare to now (with the same timezone).
   * @method        bool                isCurrentDay()                                                                                  Checks if the instance is in the same day as the current moment.
   * @method        bool                isNextDay()                                                                                     Checks if the instance is in the same day as the current moment next day.
   * @method        bool                isLastDay()                                                                                     Checks if the instance is in the same day as the current moment last day.
   * @method        bool                isSameHour(Carbon|DateTimeInterface|string|null $date = null)                                   Checks if the given date is in the same hour as the instance. If null passed, compare to now (with the same timezone).
   * @method        bool                isCurrentHour()                                                                                 Checks if the instance is in the same hour as the current moment.
   * @method        bool                isNextHour()                                                                                    Checks if the instance is in the same hour as the current moment next hour.
   * @method        bool                isLastHour()                                                                                    Checks if the instance is in the same hour as the current moment last hour.
   * @method        bool                isSameMinute(Carbon|DateTimeInterface|string|null $date = null)                                 Checks if the given date is in the same minute as the instance. If null passed, compare to now (with the same timezone).
   * @method        bool                isCurrentMinute()                                                                               Checks if the instance is in the same minute as the current moment.
   * @method        bool                isNextMinute()                                                                                  Checks if the instance is in the same minute as the current moment next minute.
   * @method        bool                isLastMinute()                                                                                  Checks if the instance is in the same minute as the current moment last minute.
   * @method        bool                isSameSecond(Carbon|DateTimeInterface|string|null $date = null)                                 Checks if the given date is in the same second as the instance. If null passed, compare to now (with the same timezone).
   * @method        bool                isCurrentSecond()                                                                               Checks if the instance is in the same second as the current moment.
   * @method        bool                isNextSecond()                                                                                  Checks if the instance is in the same second as the current moment next second.
   * @method        bool                isLastSecond()                                                                                  Checks if the instance is in the same second as the current moment last second.
   * @method        bool                isSameMicro(Carbon|DateTimeInterface|string|null $date = null)                                  Checks if the given date is in the same microsecond as the instance. If null passed, compare to now (with the same timezone).
   * @method        bool                isCurrentMicro()                                                                                Checks if the instance is in the same microsecond as the current moment.
   * @method        bool                isNextMicro()                                                                                   Checks if the instance is in the same microsecond as the current moment next microsecond.
   * @method        bool                isLastMicro()                                                                                   Checks if the instance is in the same microsecond as the current moment last microsecond.
   * @method        bool                isSameMicrosecond(Carbon|DateTimeInterface|string|null $date = null)                            Checks if the given date is in the same microsecond as the instance. If null passed, compare to now (with the same timezone).
   * @method        bool                isCurrentMicrosecond()                                                                          Checks if the instance is in the same microsecond as the current moment.
   * @method        bool                isNextMicrosecond()                                                                             Checks if the instance is in the same microsecond as the current moment next microsecond.
   * @method        bool                isLastMicrosecond()                                                                             Checks if the instance is in the same microsecond as the current moment last microsecond.
   * @method        bool                isCurrentMonth()                                                                                Checks if the instance is in the same month as the current moment.
   * @method        bool                isNextMonth()                                                                                   Checks if the instance is in the same month as the current moment next month.
   * @method        bool                isLastMonth()                                                                                   Checks if the instance is in the same month as the current moment last month.
   * @method        bool                isCurrentQuarter()                                                                              Checks if the instance is in the same quarter as the current moment.
   * @method        bool                isNextQuarter()                                                                                 Checks if the instance is in the same quarter as the current moment next quarter.
   * @method        bool                isLastQuarter()                                                                                 Checks if the instance is in the same quarter as the current moment last quarter.
   * @method        bool                isSameDecade(Carbon|DateTimeInterface|string|null $date = null)                                 Checks if the given date is in the same decade as the instance. If null passed, compare to now (with the same timezone).
   * @method        bool                isCurrentDecade()                                                                               Checks if the instance is in the same decade as the current moment.
   * @method        bool                isNextDecade()                                                                                  Checks if the instance is in the same decade as the current moment next decade.
   * @method        bool                isLastDecade()                                                                                  Checks if the instance is in the same decade as the current moment last decade.
   * @method        bool                isSameCentury(Carbon|DateTimeInterface|string|null $date = null)                                Checks if the given date is in the same century as the instance. If null passed, compare to now (with the same timezone).
   * @method        bool                isCurrentCentury()                                                                              Checks if the instance is in the same century as the current moment.
   * @method        bool                isNextCentury()                                                                                 Checks if the instance is in the same century as the current moment next century.
   * @method        bool                isLastCentury()                                                                                 Checks if the instance is in the same century as the current moment last century.
   * @method        bool                isSameMillennium(Carbon|DateTimeInterface|string|null $date = null)                             Checks if the given date is in the same millennium as the instance. If null passed, compare to now (with the same timezone).
   * @method        bool                isCurrentMillennium()                                                                           Checks if the instance is in the same millennium as the current moment.
   * @method        bool                isNextMillennium()                                                                              Checks if the instance is in the same millennium as the current moment next millennium.
   * @method        bool                isLastMillennium()                                                                              Checks if the instance is in the same millennium as the current moment last millennium.
   * @method        $this               years(int $value)                                                                               Set current instance year to the given value.
   * @method        $this               year(int $value)                                                                                Set current instance year to the given value.
   * @method        $this               setYears(int $value)                                                                            Set current instance year to the given value.
   * @method        $this               setYear(int $value)                                                                             Set current instance year to the given value.
   * @method        $this               months(int $value)                                                                              Set current instance month to the given value.
   * @method        $this               month(int $value)                                                                               Set current instance month to the given value.
   * @method        $this               setMonths(int $value)                                                                           Set current instance month to the given value.
   * @method        $this               setMonth(int $value)                                                                            Set current instance month to the given value.
   * @method        $this               days(int $value)                                                                                Set current instance day to the given value.
   * @method        $this               day(int $value)                                                                                 Set current instance day to the given value.
   * @method        $this               setDays(int $value)                                                                             Set current instance day to the given value.
   * @method        $this               setDay(int $value)                                                                              Set current instance day to the given value.
   * @method        $this               hours(int $value)                                                                               Set current instance hour to the given value.
   * @method        $this               hour(int $value)                                                                                Set current instance hour to the given value.
   * @method        $this               setHours(int $value)                                                                            Set current instance hour to the given value.
   * @method        $this               setHour(int $value)                                                                             Set current instance hour to the given value.
   * @method        $this               minutes(int $value)                                                                             Set current instance minute to the given value.
   * @method        $this               minute(int $value)                                                                              Set current instance minute to the given value.
   * @method        $this               setMinutes(int $value)                                                                          Set current instance minute to the given value.
   * @method        $this               setMinute(int $value)                                                                           Set current instance minute to the given value.
   * @method        $this               seconds(int $value)                                                                             Set current instance second to the given value.
   * @method        $this               second(int $value)                                                                              Set current instance second to the given value.
   * @method        $this               setSeconds(int $value)                                                                          Set current instance second to the given value.
   * @method        $this               setSecond(int $value)                                                                           Set current instance second to the given value.
   * @method        $this               millis(int $value)                                                                              Set current instance millisecond to the given value.
   * @method        $this               milli(int $value)                                                                               Set current instance millisecond to the given value.
   * @method        $this               setMillis(int $value)                                                                           Set current instance millisecond to the given value.
   * @method        $this               setMilli(int $value)                                                                            Set current instance millisecond to the given value.
   * @method        $this               milliseconds(int $value)                                                                        Set current instance millisecond to the given value.
   * @method        $this               millisecond(int $value)                                                                         Set current instance millisecond to the given value.
   * @method        $this               setMilliseconds(int $value)                                                                     Set current instance millisecond to the given value.
   * @method        $this               setMillisecond(int $value)                                                                      Set current instance millisecond to the given value.
   * @method        $this               micros(int $value)                                                                              Set current instance microsecond to the given value.
   * @method        $this               micro(int $value)                                                                               Set current instance microsecond to the given value.
   * @method        $this               setMicros(int $value)                                                                           Set current instance microsecond to the given value.
   * @method        $this               setMicro(int $value)                                                                            Set current instance microsecond to the given value.
   * @method        $this               microseconds(int $value)                                                                        Set current instance microsecond to the given value.
   * @method        $this               microsecond(int $value)                                                                         Set current instance microsecond to the given value.
   * @method        $this               setMicroseconds(int $value)                                                                     Set current instance microsecond to the given value.
   * @method        $this               setMicrosecond(int $value)                                                                      Set current instance microsecond to the given value.
   * @method        $this               addYears(int $value = 1)                                                                        Add years (the $value count passed in) to the instance (using date interval).
   * @method        $this               addYear()                                                                                       Add one year to the instance (using date interval).
   * @method        $this               subYears(int $value = 1)                                                                        Sub years (the $value count passed in) to the instance (using date interval).
   * @method        $this               subYear()                                                                                       Sub one year to the instance (using date interval).
   * @method        $this               addYearsWithOverflow(int $value = 1)                                                            Add years (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               addYearWithOverflow()                                                                           Add one year to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               subYearsWithOverflow(int $value = 1)                                                            Sub years (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               subYearWithOverflow()                                                                           Sub one year to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               addYearsWithoutOverflow(int $value = 1)                                                         Add years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addYearWithoutOverflow()                                                                        Add one year to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subYearsWithoutOverflow(int $value = 1)                                                         Sub years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subYearWithoutOverflow()                                                                        Sub one year to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addYearsWithNoOverflow(int $value = 1)                                                          Add years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addYearWithNoOverflow()                                                                         Add one year to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subYearsWithNoOverflow(int $value = 1)                                                          Sub years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subYearWithNoOverflow()                                                                         Sub one year to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addYearsNoOverflow(int $value = 1)                                                              Add years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addYearNoOverflow()                                                                             Add one year to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subYearsNoOverflow(int $value = 1)                                                              Sub years (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subYearNoOverflow()                                                                             Sub one year to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addMonths(int $value = 1)                                                                       Add months (the $value count passed in) to the instance (using date interval).
   * @method        $this               addMonth()                                                                                      Add one month to the instance (using date interval).
   * @method        $this               subMonths(int $value = 1)                                                                       Sub months (the $value count passed in) to the instance (using date interval).
   * @method        $this               subMonth()                                                                                      Sub one month to the instance (using date interval).
   * @method        $this               addMonthsWithOverflow(int $value = 1)                                                           Add months (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               addMonthWithOverflow()                                                                          Add one month to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               subMonthsWithOverflow(int $value = 1)                                                           Sub months (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               subMonthWithOverflow()                                                                          Sub one month to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               addMonthsWithoutOverflow(int $value = 1)                                                        Add months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addMonthWithoutOverflow()                                                                       Add one month to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subMonthsWithoutOverflow(int $value = 1)                                                        Sub months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subMonthWithoutOverflow()                                                                       Sub one month to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addMonthsWithNoOverflow(int $value = 1)                                                         Add months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addMonthWithNoOverflow()                                                                        Add one month to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subMonthsWithNoOverflow(int $value = 1)                                                         Sub months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subMonthWithNoOverflow()                                                                        Sub one month to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addMonthsNoOverflow(int $value = 1)                                                             Add months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addMonthNoOverflow()                                                                            Add one month to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subMonthsNoOverflow(int $value = 1)                                                             Sub months (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subMonthNoOverflow()                                                                            Sub one month to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addDays(int $value = 1)                                                                         Add days (the $value count passed in) to the instance (using date interval).
   * @method        $this               addDay()                                                                                        Add one day to the instance (using date interval).
   * @method        $this               subDays(int $value = 1)                                                                         Sub days (the $value count passed in) to the instance (using date interval).
   * @method        $this               subDay()                                                                                        Sub one day to the instance (using date interval).
   * @method        $this               addHours(int $value = 1)                                                                        Add hours (the $value count passed in) to the instance (using date interval).
   * @method        $this               addHour()                                                                                       Add one hour to the instance (using date interval).
   * @method        $this               subHours(int $value = 1)                                                                        Sub hours (the $value count passed in) to the instance (using date interval).
   * @method        $this               subHour()                                                                                       Sub one hour to the instance (using date interval).
   * @method        $this               addMinutes(int $value = 1)                                                                      Add minutes (the $value count passed in) to the instance (using date interval).
   * @method        $this               addMinute()                                                                                     Add one minute to the instance (using date interval).
   * @method        $this               subMinutes(int $value = 1)                                                                      Sub minutes (the $value count passed in) to the instance (using date interval).
   * @method        $this               subMinute()                                                                                     Sub one minute to the instance (using date interval).
   * @method        $this               addSeconds(int $value = 1)                                                                      Add seconds (the $value count passed in) to the instance (using date interval).
   * @method        $this               addSecond()                                                                                     Add one second to the instance (using date interval).
   * @method        $this               subSeconds(int $value = 1)                                                                      Sub seconds (the $value count passed in) to the instance (using date interval).
   * @method        $this               subSecond()                                                                                     Sub one second to the instance (using date interval).
   * @method        $this               addMillis(int $value = 1)                                                                       Add milliseconds (the $value count passed in) to the instance (using date interval).
   * @method        $this               addMilli()                                                                                      Add one millisecond to the instance (using date interval).
   * @method        $this               subMillis(int $value = 1)                                                                       Sub milliseconds (the $value count passed in) to the instance (using date interval).
   * @method        $this               subMilli()                                                                                      Sub one millisecond to the instance (using date interval).
   * @method        $this               addMilliseconds(int $value = 1)                                                                 Add milliseconds (the $value count passed in) to the instance (using date interval).
   * @method        $this               addMillisecond()                                                                                Add one millisecond to the instance (using date interval).
   * @method        $this               subMilliseconds(int $value = 1)                                                                 Sub milliseconds (the $value count passed in) to the instance (using date interval).
   * @method        $this               subMillisecond()                                                                                Sub one millisecond to the instance (using date interval).
   * @method        $this               addMicros(int $value = 1)                                                                       Add microseconds (the $value count passed in) to the instance (using date interval).
   * @method        $this               addMicro()                                                                                      Add one microsecond to the instance (using date interval).
   * @method        $this               subMicros(int $value = 1)                                                                       Sub microseconds (the $value count passed in) to the instance (using date interval).
   * @method        $this               subMicro()                                                                                      Sub one microsecond to the instance (using date interval).
   * @method        $this               addMicroseconds(int $value = 1)                                                                 Add microseconds (the $value count passed in) to the instance (using date interval).
   * @method        $this               addMicrosecond()                                                                                Add one microsecond to the instance (using date interval).
   * @method        $this               subMicroseconds(int $value = 1)                                                                 Sub microseconds (the $value count passed in) to the instance (using date interval).
   * @method        $this               subMicrosecond()                                                                                Sub one microsecond to the instance (using date interval).
   * @method        $this               addMillennia(int $value = 1)                                                                    Add millennia (the $value count passed in) to the instance (using date interval).
   * @method        $this               addMillennium()                                                                                 Add one millennium to the instance (using date interval).
   * @method        $this               subMillennia(int $value = 1)                                                                    Sub millennia (the $value count passed in) to the instance (using date interval).
   * @method        $this               subMillennium()                                                                                 Sub one millennium to the instance (using date interval).
   * @method        $this               addMillenniaWithOverflow(int $value = 1)                                                        Add millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               addMillenniumWithOverflow()                                                                     Add one millennium to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               subMillenniaWithOverflow(int $value = 1)                                                        Sub millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               subMillenniumWithOverflow()                                                                     Sub one millennium to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               addMillenniaWithoutOverflow(int $value = 1)                                                     Add millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addMillenniumWithoutOverflow()                                                                  Add one millennium to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subMillenniaWithoutOverflow(int $value = 1)                                                     Sub millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subMillenniumWithoutOverflow()                                                                  Sub one millennium to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addMillenniaWithNoOverflow(int $value = 1)                                                      Add millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addMillenniumWithNoOverflow()                                                                   Add one millennium to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subMillenniaWithNoOverflow(int $value = 1)                                                      Sub millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subMillenniumWithNoOverflow()                                                                   Sub one millennium to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addMillenniaNoOverflow(int $value = 1)                                                          Add millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addMillenniumNoOverflow()                                                                       Add one millennium to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subMillenniaNoOverflow(int $value = 1)                                                          Sub millennia (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subMillenniumNoOverflow()                                                                       Sub one millennium to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addCenturies(int $value = 1)                                                                    Add centuries (the $value count passed in) to the instance (using date interval).
   * @method        $this               addCentury()                                                                                    Add one century to the instance (using date interval).
   * @method        $this               subCenturies(int $value = 1)                                                                    Sub centuries (the $value count passed in) to the instance (using date interval).
   * @method        $this               subCentury()                                                                                    Sub one century to the instance (using date interval).
   * @method        $this               addCenturiesWithOverflow(int $value = 1)                                                        Add centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               addCenturyWithOverflow()                                                                        Add one century to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               subCenturiesWithOverflow(int $value = 1)                                                        Sub centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               subCenturyWithOverflow()                                                                        Sub one century to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               addCenturiesWithoutOverflow(int $value = 1)                                                     Add centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addCenturyWithoutOverflow()                                                                     Add one century to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subCenturiesWithoutOverflow(int $value = 1)                                                     Sub centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subCenturyWithoutOverflow()                                                                     Sub one century to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addCenturiesWithNoOverflow(int $value = 1)                                                      Add centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addCenturyWithNoOverflow()                                                                      Add one century to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subCenturiesWithNoOverflow(int $value = 1)                                                      Sub centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subCenturyWithNoOverflow()                                                                      Sub one century to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addCenturiesNoOverflow(int $value = 1)                                                          Add centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addCenturyNoOverflow()                                                                          Add one century to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subCenturiesNoOverflow(int $value = 1)                                                          Sub centuries (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subCenturyNoOverflow()                                                                          Sub one century to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addDecades(int $value = 1)                                                                      Add decades (the $value count passed in) to the instance (using date interval).
   * @method        $this               addDecade()                                                                                     Add one decade to the instance (using date interval).
   * @method        $this               subDecades(int $value = 1)                                                                      Sub decades (the $value count passed in) to the instance (using date interval).
   * @method        $this               subDecade()                                                                                     Sub one decade to the instance (using date interval).
   * @method        $this               addDecadesWithOverflow(int $value = 1)                                                          Add decades (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               addDecadeWithOverflow()                                                                         Add one decade to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               subDecadesWithOverflow(int $value = 1)                                                          Sub decades (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               subDecadeWithOverflow()                                                                         Sub one decade to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               addDecadesWithoutOverflow(int $value = 1)                                                       Add decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addDecadeWithoutOverflow()                                                                      Add one decade to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subDecadesWithoutOverflow(int $value = 1)                                                       Sub decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subDecadeWithoutOverflow()                                                                      Sub one decade to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addDecadesWithNoOverflow(int $value = 1)                                                        Add decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addDecadeWithNoOverflow()                                                                       Add one decade to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subDecadesWithNoOverflow(int $value = 1)                                                        Sub decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subDecadeWithNoOverflow()                                                                       Sub one decade to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addDecadesNoOverflow(int $value = 1)                                                            Add decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addDecadeNoOverflow()                                                                           Add one decade to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subDecadesNoOverflow(int $value = 1)                                                            Sub decades (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subDecadeNoOverflow()                                                                           Sub one decade to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addQuarters(int $value = 1)                                                                     Add quarters (the $value count passed in) to the instance (using date interval).
   * @method        $this               addQuarter()                                                                                    Add one quarter to the instance (using date interval).
   * @method        $this               subQuarters(int $value = 1)                                                                     Sub quarters (the $value count passed in) to the instance (using date interval).
   * @method        $this               subQuarter()                                                                                    Sub one quarter to the instance (using date interval).
   * @method        $this               addQuartersWithOverflow(int $value = 1)                                                         Add quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               addQuarterWithOverflow()                                                                        Add one quarter to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               subQuartersWithOverflow(int $value = 1)                                                         Sub quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               subQuarterWithOverflow()                                                                        Sub one quarter to the instance (using date interval) with overflow explicitly allowed.
   * @method        $this               addQuartersWithoutOverflow(int $value = 1)                                                      Add quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addQuarterWithoutOverflow()                                                                     Add one quarter to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subQuartersWithoutOverflow(int $value = 1)                                                      Sub quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subQuarterWithoutOverflow()                                                                     Sub one quarter to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addQuartersWithNoOverflow(int $value = 1)                                                       Add quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addQuarterWithNoOverflow()                                                                      Add one quarter to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subQuartersWithNoOverflow(int $value = 1)                                                       Sub quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subQuarterWithNoOverflow()                                                                      Sub one quarter to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addQuartersNoOverflow(int $value = 1)                                                           Add quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addQuarterNoOverflow()                                                                          Add one quarter to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subQuartersNoOverflow(int $value = 1)                                                           Sub quarters (the $value count passed in) to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               subQuarterNoOverflow()                                                                          Sub one quarter to the instance (using date interval) with overflow explicitly forbidden.
   * @method        $this               addWeeks(int $value = 1)                                                                        Add weeks (the $value count passed in) to the instance (using date interval).
   * @method        $this               addWeek()                                                                                       Add one week to the instance (using date interval).
   * @method        $this               subWeeks(int $value = 1)                                                                        Sub weeks (the $value count passed in) to the instance (using date interval).
   * @method        $this               subWeek()                                                                                       Sub one week to the instance (using date interval).
   * @method        $this               addWeekdays(int $value = 1)                                                                     Add weekdays (the $value count passed in) to the instance (using date interval).
   * @method        $this               addWeekday()                                                                                    Add one weekday to the instance (using date interval).
   * @method        $this               subWeekdays(int $value = 1)                                                                     Sub weekdays (the $value count passed in) to the instance (using date interval).
   * @method        $this               subWeekday()                                                                                    Sub one weekday to the instance (using date interval).
   * @method        $this               addRealMicros(int $value = 1)                                                                   Add microseconds (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealMicro()                                                                                  Add one microsecond to the instance (using timestamp).
   * @method        $this               subRealMicros(int $value = 1)                                                                   Sub microseconds (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealMicro()                                                                                  Sub one microsecond to the instance (using timestamp).
   * @method        CarbonPeriod        microsUntil($endDate = null, int $factor = 1)                                                   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.
   * @method        $this               addRealMicroseconds(int $value = 1)                                                             Add microseconds (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealMicrosecond()                                                                            Add one microsecond to the instance (using timestamp).
   * @method        $this               subRealMicroseconds(int $value = 1)                                                             Sub microseconds (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealMicrosecond()                                                                            Sub one microsecond to the instance (using timestamp).
   * @method        CarbonPeriod        microsecondsUntil($endDate = null, int $factor = 1)                                             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.
   * @method        $this               addRealMillis(int $value = 1)                                                                   Add milliseconds (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealMilli()                                                                                  Add one millisecond to the instance (using timestamp).
   * @method        $this               subRealMillis(int $value = 1)                                                                   Sub milliseconds (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealMilli()                                                                                  Sub one millisecond to the instance (using timestamp).
   * @method        CarbonPeriod        millisUntil($endDate = null, int $factor = 1)                                                   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.
   * @method        $this               addRealMilliseconds(int $value = 1)                                                             Add milliseconds (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealMillisecond()                                                                            Add one millisecond to the instance (using timestamp).
   * @method        $this               subRealMilliseconds(int $value = 1)                                                             Sub milliseconds (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealMillisecond()                                                                            Sub one millisecond to the instance (using timestamp).
   * @method        CarbonPeriod        millisecondsUntil($endDate = null, int $factor = 1)                                             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.
   * @method        $this               addRealSeconds(int $value = 1)                                                                  Add seconds (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealSecond()                                                                                 Add one second to the instance (using timestamp).
   * @method        $this               subRealSeconds(int $value = 1)                                                                  Sub seconds (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealSecond()                                                                                 Sub one second to the instance (using timestamp).
   * @method        CarbonPeriod        secondsUntil($endDate = null, int $factor = 1)                                                  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.
   * @method        $this               addRealMinutes(int $value = 1)                                                                  Add minutes (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealMinute()                                                                                 Add one minute to the instance (using timestamp).
   * @method        $this               subRealMinutes(int $value = 1)                                                                  Sub minutes (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealMinute()                                                                                 Sub one minute to the instance (using timestamp).
   * @method        CarbonPeriod        minutesUntil($endDate = null, int $factor = 1)                                                  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.
   * @method        $this               addRealHours(int $value = 1)                                                                    Add hours (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealHour()                                                                                   Add one hour to the instance (using timestamp).
   * @method        $this               subRealHours(int $value = 1)                                                                    Sub hours (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealHour()                                                                                   Sub one hour to the instance (using timestamp).
   * @method        CarbonPeriod        hoursUntil($endDate = null, int $factor = 1)                                                    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.
   * @method        $this               addRealDays(int $value = 1)                                                                     Add days (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealDay()                                                                                    Add one day to the instance (using timestamp).
   * @method        $this               subRealDays(int $value = 1)                                                                     Sub days (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealDay()                                                                                    Sub one day to the instance (using timestamp).
   * @method        CarbonPeriod        daysUntil($endDate = null, int $factor = 1)                                                     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.
   * @method        $this               addRealWeeks(int $value = 1)                                                                    Add weeks (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealWeek()                                                                                   Add one week to the instance (using timestamp).
   * @method        $this               subRealWeeks(int $value = 1)                                                                    Sub weeks (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealWeek()                                                                                   Sub one week to the instance (using timestamp).
   * @method        CarbonPeriod        weeksUntil($endDate = null, int $factor = 1)                                                    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.
   * @method        $this               addRealMonths(int $value = 1)                                                                   Add months (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealMonth()                                                                                  Add one month to the instance (using timestamp).
   * @method        $this               subRealMonths(int $value = 1)                                                                   Sub months (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealMonth()                                                                                  Sub one month to the instance (using timestamp).
   * @method        CarbonPeriod        monthsUntil($endDate = null, int $factor = 1)                                                   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.
   * @method        $this               addRealQuarters(int $value = 1)                                                                 Add quarters (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealQuarter()                                                                                Add one quarter to the instance (using timestamp).
   * @method        $this               subRealQuarters(int $value = 1)                                                                 Sub quarters (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealQuarter()                                                                                Sub one quarter to the instance (using timestamp).
   * @method        CarbonPeriod        quartersUntil($endDate = null, int $factor = 1)                                                 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.
   * @method        $this               addRealYears(int $value = 1)                                                                    Add years (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealYear()                                                                                   Add one year to the instance (using timestamp).
   * @method        $this               subRealYears(int $value = 1)                                                                    Sub years (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealYear()                                                                                   Sub one year to the instance (using timestamp).
   * @method        CarbonPeriod        yearsUntil($endDate = null, int $factor = 1)                                                    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.
   * @method        $this               addRealDecades(int $value = 1)                                                                  Add decades (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealDecade()                                                                                 Add one decade to the instance (using timestamp).
   * @method        $this               subRealDecades(int $value = 1)                                                                  Sub decades (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealDecade()                                                                                 Sub one decade to the instance (using timestamp).
   * @method        CarbonPeriod        decadesUntil($endDate = null, int $factor = 1)                                                  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.
   * @method        $this               addRealCenturies(int $value = 1)                                                                Add centuries (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealCentury()                                                                                Add one century to the instance (using timestamp).
   * @method        $this               subRealCenturies(int $value = 1)                                                                Sub centuries (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealCentury()                                                                                Sub one century to the instance (using timestamp).
   * @method        CarbonPeriod        centuriesUntil($endDate = null, int $factor = 1)                                                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.
   * @method        $this               addRealMillennia(int $value = 1)                                                                Add millennia (the $value count passed in) to the instance (using timestamp).
   * @method        $this               addRealMillennium()                                                                             Add one millennium to the instance (using timestamp).
   * @method        $this               subRealMillennia(int $value = 1)                                                                Sub millennia (the $value count passed in) to the instance (using timestamp).
   * @method        $this               subRealMillennium()                                                                             Sub one millennium to the instance (using timestamp).
   * @method        CarbonPeriod        millenniaUntil($endDate = null, int $factor = 1)                                                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.
   * @method        $this               roundYear(float $precision = 1, string $function = "round")                                     Round the current instance year with given precision using the given function.
   * @method        $this               roundYears(float $precision = 1, string $function = "round")                                    Round the current instance year with given precision using the given function.
   * @method        $this               floorYear(float $precision = 1)                                                                 Truncate the current instance year with given precision.
   * @method        $this               floorYears(float $precision = 1)                                                                Truncate the current instance year with given precision.
   * @method        $this               ceilYear(float $precision = 1)                                                                  Ceil the current instance year with given precision.
   * @method        $this               ceilYears(float $precision = 1)                                                                 Ceil the current instance year with given precision.
   * @method        $this               roundMonth(float $precision = 1, string $function = "round")                                    Round the current instance month with given precision using the given function.
   * @method        $this               roundMonths(float $precision = 1, string $function = "round")                                   Round the current instance month with given precision using the given function.
   * @method        $this               floorMonth(float $precision = 1)                                                                Truncate the current instance month with given precision.
   * @method        $this               floorMonths(float $precision = 1)                                                               Truncate the current instance month with given precision.
   * @method        $this               ceilMonth(float $precision = 1)                                                                 Ceil the current instance month with given precision.
   * @method        $this               ceilMonths(float $precision = 1)                                                                Ceil the current instance month with given precision.
   * @method        $this               roundDay(float $precision = 1, string $function = "round")                                      Round the current instance day with given precision using the given function.
   * @method        $this               roundDays(float $precision = 1, string $function = "round")                                     Round the current instance day with given precision using the given function.
   * @method        $this               floorDay(float $precision = 1)                                                                  Truncate the current instance day with given precision.
   * @method        $this               floorDays(float $precision = 1)                                                                 Truncate the current instance day with given precision.
   * @method        $this               ceilDay(float $precision = 1)                                                                   Ceil the current instance day with given precision.
   * @method        $this               ceilDays(float $precision = 1)                                                                  Ceil the current instance day with given precision.
   * @method        $this               roundHour(float $precision = 1, string $function = "round")                                     Round the current instance hour with given precision using the given function.
   * @method        $this               roundHours(float $precision = 1, string $function = "round")                                    Round the current instance hour with given precision using the given function.
   * @method        $this               floorHour(float $precision = 1)                                                                 Truncate the current instance hour with given precision.
   * @method        $this               floorHours(float $precision = 1)                                                                Truncate the current instance hour with given precision.
   * @method        $this               ceilHour(float $precision = 1)                                                                  Ceil the current instance hour with given precision.
   * @method        $this               ceilHours(float $precision = 1)                                                                 Ceil the current instance hour with given precision.
   * @method        $this               roundMinute(float $precision = 1, string $function = "round")                                   Round the current instance minute with given precision using the given function.
   * @method        $this               roundMinutes(float $precision = 1, string $function = "round")                                  Round the current instance minute with given precision using the given function.
   * @method        $this               floorMinute(float $precision = 1)                                                               Truncate the current instance minute with given precision.
   * @method        $this               floorMinutes(float $precision = 1)                                                              Truncate the current instance minute with given precision.
   * @method        $this               ceilMinute(float $precision = 1)                                                                Ceil the current instance minute with given precision.
   * @method        $this               ceilMinutes(float $precision = 1)                                                               Ceil the current instance minute with given precision.
   * @method        $this               roundSecond(float $precision = 1, string $function = "round")                                   Round the current instance second with given precision using the given function.
   * @method        $this               roundSeconds(float $precision = 1, string $function = "round")                                  Round the current instance second with given precision using the given function.
   * @method        $this               floorSecond(float $precision = 1)                                                               Truncate the current instance second with given precision.
   * @method        $this               floorSeconds(float $precision = 1)                                                              Truncate the current instance second with given precision.
   * @method        $this               ceilSecond(float $precision = 1)                                                                Ceil the current instance second with given precision.
   * @method        $this               ceilSeconds(float $precision = 1)                                                               Ceil the current instance second with given precision.
   * @method        $this               roundMillennium(float $precision = 1, string $function = "round")                               Round the current instance millennium with given precision using the given function.
   * @method        $this               roundMillennia(float $precision = 1, string $function = "round")                                Round the current instance millennium with given precision using the given function.
   * @method        $this               floorMillennium(float $precision = 1)                                                           Truncate the current instance millennium with given precision.
   * @method        $this               floorMillennia(float $precision = 1)                                                            Truncate the current instance millennium with given precision.
   * @method        $this               ceilMillennium(float $precision = 1)                                                            Ceil the current instance millennium with given precision.
   * @method        $this               ceilMillennia(float $precision = 1)                                                             Ceil the current instance millennium with given precision.
   * @method        $this               roundCentury(float $precision = 1, string $function = "round")                                  Round the current instance century with given precision using the given function.
   * @method        $this               roundCenturies(float $precision = 1, string $function = "round")                                Round the current instance century with given precision using the given function.
   * @method        $this               floorCentury(float $precision = 1)                                                              Truncate the current instance century with given precision.
   * @method        $this               floorCenturies(float $precision = 1)                                                            Truncate the current instance century with given precision.
   * @method        $this               ceilCentury(float $precision = 1)                                                               Ceil the current instance century with given precision.
   * @method        $this               ceilCenturies(float $precision = 1)                                                             Ceil the current instance century with given precision.
   * @method        $this               roundDecade(float $precision = 1, string $function = "round")                                   Round the current instance decade with given precision using the given function.
   * @method        $this               roundDecades(float $precision = 1, string $function = "round")                                  Round the current instance decade with given precision using the given function.
   * @method        $this               floorDecade(float $precision = 1)                                                               Truncate the current instance decade with given precision.
   * @method        $this               floorDecades(float $precision = 1)                                                              Truncate the current instance decade with given precision.
   * @method        $this               ceilDecade(float $precision = 1)                                                                Ceil the current instance decade with given precision.
   * @method        $this               ceilDecades(float $precision = 1)                                                               Ceil the current instance decade with given precision.
   * @method        $this               roundQuarter(float $precision = 1, string $function = "round")                                  Round the current instance quarter with given precision using the given function.
   * @method        $this               roundQuarters(float $precision = 1, string $function = "round")                                 Round the current instance quarter with given precision using the given function.
   * @method        $this               floorQuarter(float $precision = 1)                                                              Truncate the current instance quarter with given precision.
   * @method        $this               floorQuarters(float $precision = 1)                                                             Truncate the current instance quarter with given precision.
   * @method        $this               ceilQuarter(float $precision = 1)                                                               Ceil the current instance quarter with given precision.
   * @method        $this               ceilQuarters(float $precision = 1)                                                              Ceil the current instance quarter with given precision.
   * @method        $this               roundMillisecond(float $precision = 1, string $function = "round")                              Round the current instance millisecond with given precision using the given function.
   * @method        $this               roundMilliseconds(float $precision = 1, string $function = "round")                             Round the current instance millisecond with given precision using the given function.
   * @method        $this               floorMillisecond(float $precision = 1)                                                          Truncate the current instance millisecond with given precision.
   * @method        $this               floorMilliseconds(float $precision = 1)                                                         Truncate the current instance millisecond with given precision.
   * @method        $this               ceilMillisecond(float $precision = 1)                                                           Ceil the current instance millisecond with given precision.
   * @method        $this               ceilMilliseconds(float $precision = 1)                                                          Ceil the current instance millisecond with given precision.
   * @method        $this               roundMicrosecond(float $precision = 1, string $function = "round")                              Round the current instance microsecond with given precision using the given function.
   * @method        $this               roundMicroseconds(float $precision = 1, string $function = "round")                             Round the current instance microsecond with given precision using the given function.
   * @method        $this               floorMicrosecond(float $precision = 1)                                                          Truncate the current instance microsecond with given precision.
   * @method        $this               floorMicroseconds(float $precision = 1)                                                         Truncate the current instance microsecond with given precision.
   * @method        $this               ceilMicrosecond(float $precision = 1)                                                           Ceil the current instance microsecond with given precision.
   * @method        $this               ceilMicroseconds(float $precision = 1)                                                          Ceil the current instance microsecond with given precision.
   * @method        string              shortAbsoluteDiffForHumans(DateTimeInterface $other = null, int $parts = 1)                     Get the difference (short format, 'Absolute' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)
   * @method        string              longAbsoluteDiffForHumans(DateTimeInterface $other = null, int $parts = 1)                      Get the difference (long format, 'Absolute' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)
   * @method        string              shortRelativeDiffForHumans(DateTimeInterface $other = null, int $parts = 1)                     Get the difference (short format, 'Relative' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)
   * @method        string              longRelativeDiffForHumans(DateTimeInterface $other = null, int $parts = 1)                      Get the difference (long format, 'Relative' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)
   * @method        string              shortRelativeToNowDiffForHumans(DateTimeInterface $other = null, int $parts = 1)                Get the difference (short format, 'RelativeToNow' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)
   * @method        string              longRelativeToNowDiffForHumans(DateTimeInterface $other = null, int $parts = 1)                 Get the difference (long format, 'RelativeToNow' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)
   * @method        string              shortRelativeToOtherDiffForHumans(DateTimeInterface $other = null, int $parts = 1)              Get the difference (short format, 'RelativeToOther' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)
   * @method        string              longRelativeToOtherDiffForHumans(DateTimeInterface $other = null, int $parts = 1)               Get the difference (long format, 'RelativeToOther' mode) in a human readable format in the current locale. ($other and $parts parameters can be swapped.)
   * @method        static static|false createFromFormat(string $format, string $time, DateTimeZone|string|false|null $timezone = null) Parse a string into a new Carbon object according to the specified format.
   * @method        static static       __set_state(array $array)                                                                       https://php.net/manual/en/datetime.set-state.php
   *
   * </autodoc>
   */
  class Carbon extends DateTime implements CarbonInterface
  {
      use Date;
  
      /**
       * Returns true if the current class/instance is mutable.
       *
       * @return bool
       */
      public static function isMutable()
      {
          return true;
      }
  }