* * For the full copyright and license information, please view the LICENSE * file that was distributed with this source code. */ namespace Tests\Carbon; use Carbon\Carbon; use Carbon\Exceptions\InvalidFormatException; use Closure; use DateMalformedStringException; use InvalidArgumentException; use Tests\AbstractTestCase; class ModifyTest extends AbstractTestCase { public function testSimpleModify() { $a = new Carbon('2014-03-30 00:00:00'); $b = $a->copy(); $b->addHours(24); $this->assertSame(24.0, $a->diffInHours($b)); } public function testTimezoneModify() { $php81Fix = 1.0; // For daylight saving time reason 2014-03-30 0h59 is immediately followed by 2h00 $a = new Carbon('2014-03-30 00:00:00', 'Europe/London'); $b = $a->copy(); $b->addHours(24); $this->assertSame(23.0 + $php81Fix, $a->diffInRealHours($b)); $this->assertSame(23.0 + $php81Fix, $b->diffInRealHours($a, true)); $this->assertSame(-(23.0 + $php81Fix), $b->diffInRealHours($a)); $this->assertSame(-(23.0 + $php81Fix) * 60, $b->diffInRealMinutes($a)); $this->assertSame(-(23.0 + $php81Fix) * 60 * 60, $b->diffInRealSeconds($a)); $this->assertSame(-(23.0 + $php81Fix) * 60 * 60 * 1000, $b->diffInRealMilliseconds($a)); $this->assertSame(-(23.0 + $php81Fix) * 60 * 60 * 1000000, $b->diffInRealMicroseconds($a)); $a = new Carbon('2014-03-30 00:00:00', 'Europe/London'); $b = $a->copy(); $b->addUTCHours(24); $this->assertSame(-24.0, $b->diffInHours($a, false)); $this->assertSame(-24.0 * 60, $b->diffInMinutes($a, false)); $this->assertSame(-24.0 * 60 * 60, $b->diffInSeconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000, $b->diffInMilliseconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000000, $b->diffInMicroseconds($a, false)); $b->subRealHours(24); $this->assertSame(0.0, $b->diffInHours($a, false)); $this->assertSame(0.0, $b->diffInHours($a, false)); $a = new Carbon('2014-03-30 00:59:00', 'Europe/London'); $a->addRealHour(); $this->assertSame('02:59', $a->format('H:i')); $a->subRealHour(); $this->assertSame('00:59', $a->format('H:i')); $a = new Carbon('2014-03-30 00:59:00', 'Europe/London'); $a->addRealMinutes(2); $this->assertSame('02:01', $a->format('H:i')); $a->subRealMinutes(2); $this->assertSame('00:59', $a->format('H:i')); $a = new Carbon('2014-03-30 00:59:30', 'Europe/London'); $a->addRealMinute(); $this->assertSame('02:00:30', $a->format('H:i:s')); $a->subRealMinute(); $this->assertSame('00:59:30', $a->format('H:i:s')); $a = new Carbon('2014-03-30 00:59:30', 'Europe/London'); $a->addRealSeconds(40); $this->assertSame('02:00:10', $a->format('H:i:s')); $a->subRealSeconds(40); $this->assertSame('00:59:30', $a->format('H:i:s')); $a = new Carbon('2014-03-30 00:59:59', 'Europe/London'); $a->addRealSecond(); $this->assertSame('02:00:00', $a->format('H:i:s')); $a->subRealSecond(); $this->assertSame('00:59:59', $a->format('H:i:s')); $a = new Carbon('2014-03-30 00:59:59.990000', 'Europe/London'); $a->addRealMilliseconds(20); $this->assertSame('02:00:00.010000', $a->format('H:i:s.u')); $a->subRealMilliseconds(20); $this->assertSame('00:59:59.990000', $a->format('H:i:s.u')); $a = new Carbon('2014-03-30 00:59:59.999990', 'Europe/London'); $a->addRealMicroseconds(20); $this->assertSame('02:00:00.000010', $a->format('H:i:s.u')); $a->subRealMicroseconds(20); $this->assertSame('00:59:59.999990', $a->format('H:i:s.u')); $a = new Carbon('2014-03-30 00:59:59.999999', 'Europe/London'); $a->addRealMicrosecond(); $this->assertSame('02:00:00.000000', $a->format('H:i:s.u')); $a->subRealMicrosecond(); $this->assertSame('00:59:59.999999', $a->format('H:i:s.u')); $a = new Carbon('2014-03-30 00:00:00', 'Europe/London'); $b = $a->copy(); $b->addRealDay(); $this->assertSame(-24.0, $b->diffInHours($a, false)); $this->assertSame(-24.0 * 60, $b->diffInMinutes($a, false)); $this->assertSame(-24.0 * 60 * 60, $b->diffInSeconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000, $b->diffInMilliseconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000000, $b->diffInMicroseconds($a, false)); $a = new Carbon('2014-03-30 00:00:00', 'Europe/London'); $b = $a->copy(); $b->addUTCDay(); $this->assertSame(-24.0, $b->diffInHours($a, false)); $this->assertSame(-24.0 * 60, $b->diffInMinutes($a, false)); $this->assertSame(-24.0 * 60 * 60, $b->diffInSeconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000, $b->diffInMilliseconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000000, $b->diffInMicroseconds($a, false)); $a = new Carbon('2014-03-30 00:00:00', 'Europe/London'); $b = $a->copy(); $b->addRealWeeks(1 / 7); $this->assertSame(-24.0, $b->diffInHours($a, false)); $this->assertSame(-24.0 * 60, $b->diffInMinutes($a, false)); $this->assertSame(-24.0 * 60 * 60, $b->diffInSeconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000, $b->diffInMilliseconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000000, $b->diffInMicroseconds($a, false)); $a = new Carbon('2014-03-30 00:00:00', 'Europe/London'); $b = $a->copy(); $b->addRealMonths(1 / 30); $this->assertSame(-24.0, $b->diffInHours($a, false)); $this->assertSame(-24.0 * 60, $b->diffInMinutes($a, false)); $this->assertSame(-24.0 * 60 * 60, $b->diffInSeconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000, $b->diffInMilliseconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000000, $b->diffInMicroseconds($a, false)); $a = new Carbon('2014-03-30 00:00:00', 'Europe/London'); $b = $a->copy(); $b->addRealQuarters(1 / 90); $this->assertSame(-24.0, $b->diffInHours($a, false)); $this->assertSame(-24.0 * 60, $b->diffInMinutes($a, false)); $this->assertSame(-24.0 * 60 * 60, $b->diffInSeconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000, $b->diffInMilliseconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000000, $b->diffInMicroseconds($a, false)); $a = new Carbon('2014-03-30 00:00:00', 'Europe/London'); $b = $a->copy(); $b->addRealYears(1 / 365); $this->assertSame(-24.0, $b->diffInHours($a, false)); $this->assertSame(-24.0 * 60, $b->diffInMinutes($a, false)); $this->assertSame(-24.0 * 60 * 60, $b->diffInSeconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000, $b->diffInMilliseconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000000, $b->diffInMicroseconds($a, false)); $a = new Carbon('2014-03-30 00:00:00', 'Europe/London'); $b = $a->copy(); $b->addRealDecades(1 / 3650); $this->assertSame(-24.0, $b->diffInHours($a, false)); $this->assertSame(-24.0 * 60, $b->diffInMinutes($a, false)); $this->assertSame(-24.0 * 60 * 60, $b->diffInSeconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000, $b->diffInMilliseconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000000, $b->diffInMicroseconds($a, false)); $a = new Carbon('2014-03-30 00:00:00', 'Europe/London'); $b = $a->copy(); $b->addRealCenturies(1 / 36500); $this->assertSame(-24.0, $b->diffInHours($a, false)); $this->assertSame(-24.0 * 60, $b->diffInMinutes($a, false)); $this->assertSame(-24.0 * 60 * 60, $b->diffInSeconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000, $b->diffInMilliseconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000000, $b->diffInMicroseconds($a, false)); $a = new Carbon('2014-03-30 00:00:00', 'Europe/London'); $b = $a->copy(); $b->addRealMillennia(1 / 365000); $this->assertSame(-24.0, $b->diffInHours($a, false)); $this->assertSame(-24.0 * 60, $b->diffInMinutes($a, false)); $this->assertSame(-24.0 * 60 * 60, $b->diffInSeconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000, $b->diffInMilliseconds($a, false)); $this->assertSame(-24.0 * 60 * 60 * 1000000, $b->diffInMicroseconds($a, false)); } public function testAddRealUnitException() { $this->expectExceptionObject(new InvalidArgumentException( 'Invalid unit for real timestamp add/sub: \'foobar\'', )); (new Carbon('2014-03-30 00:00:00'))->addRealUnit('foobar'); } public function testAddRealMicrosecondWithLowFloatPrecision() { $precision = ini_set('precision', '9'); $a = new Carbon('2014-03-30 00:59:59.999999', 'Europe/London'); $a->addRealMicrosecond(); $this->assertSame('02:00:00.000000', $a->format('H:i:s.u')); ini_set('precision', $precision); } public function testNextAndPrevious() { Carbon::setTestNow('2019-06-02 13:27:09.816752'); $this->assertSame('2019-06-02 14:00:00', Carbon::now()->next('2pm')->format('Y-m-d H:i:s')); $this->assertSame('2019-06-01 14:00:00', Carbon::now()->previous('2pm')->format('Y-m-d H:i:s')); $this->assertSame('2019-06-02 14:00:00', Carbon::now()->next('14h')->format('Y-m-d H:i:s')); $this->assertSame('2019-06-01 14:00:00', Carbon::now()->previous('14h')->format('Y-m-d H:i:s')); $this->assertSame('2019-06-03 09:00:00', Carbon::now()->next('9am')->format('Y-m-d H:i:s')); $this->assertSame('2019-06-02 09:00:00', Carbon::now()->previous('9am')->format('Y-m-d H:i:s')); $this->assertSame('2019-06-02 14:00:00', Carbon::parse('next 2pm')->format('Y-m-d H:i:s')); $this->assertSame('2019-06-01 14:00:00', Carbon::parse('previous 2pm')->format('Y-m-d H:i:s')); $this->assertSame('2019-06-02 14:00:00', Carbon::parse('next 14h')->format('Y-m-d H:i:s')); $this->assertSame('2019-06-01 14:00:00', Carbon::parse('previous 14h')->format('Y-m-d H:i:s')); $this->assertSame('2019-06-03 09:00:00', Carbon::parse('next 9am')->format('Y-m-d H:i:s')); $this->assertSame('2019-06-02 09:00:00', Carbon::parse('previous 9am')->format('Y-m-d H:i:s')); $this->assertSame( '2019-06-04 00:00:00', Carbon::parse('after tomorrow')->format('Y-m-d H:i:s'), ); $this->assertSame( '2000-01-27 00:00:00', Carbon::parse('2000-01-25')->change('after tomorrow')->format('Y-m-d H:i:s'), ); $this->assertSame( '2019-05-31 00:00:00', Carbon::parse('before yesterday')->format('Y-m-d H:i:s'), ); $this->assertSame( '2000-01-23 00:00:00', Carbon::parse('2000-01-25')->change('before yesterday')->format('Y-m-d H:i:s'), ); } public function testInvalidModifier(): void { $this->checkInvalid('invalid', static function () { return @Carbon::parse('2000-01-25')->change('invalid'); }); $this->checkInvalid('next invalid', static function () { return @Carbon::now()->next('invalid'); }); $this->checkInvalid('last invalid', static function () { return @Carbon::now()->previous('invalid'); }); } private function checkInvalid(string $message, Closure $callback): void { $this->expectExceptionObject( PHP_VERSION < 8.3 ? new InvalidFormatException('Could not modify with: '.var_export($message, true)) : new DateMalformedStringException("Failed to parse time string ($message)"), ); $callback(); } public function testImplicitCast(): void { $this->assertSame( '2000-01-25 06:00:00.000000', Carbon::parse('2000-01-25')->addRealHours('6')->format('Y-m-d H:i:s.u') ); $this->assertSame( '2000-01-25 07:00:00.000000', Carbon::parse('2000-01-25')->addRealUnit('hour', '7')->format('Y-m-d H:i:s.u') ); $this->assertSame( '2000-01-24 17:00:00.000000', Carbon::parse('2000-01-25')->subRealUnit('hour', '7')->format('Y-m-d H:i:s.u') ); $this->assertSame( '2000-01-25 00:08:00.000000', Carbon::parse('2000-01-25')->addRealUnit('minute', '8')->format('Y-m-d H:i:s.u') ); $this->assertSame( '2000-01-25 00:00:00.007000', Carbon::parse('2000-01-25')->addRealUnit('millisecond', '7')->format('Y-m-d H:i:s.u') ); } }