* * 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\CarbonInterval; use DateInterval; use InvalidArgumentException; use Tests\AbstractTestCase; class RoundTest extends AbstractTestCase { public function testRoundWithDefaultUnit() { $dt = Carbon::create(2315, 7, 18, 22, 42, 17.643971); $copy = $dt->copy(); $ref = $copy->round(); $this->assertSame($ref, $copy); $this->assertCarbon($ref, 2315, 7, 18, 22, 42, 18, 0); $this->assertCarbon($dt->copy()->round(5), 2315, 7, 18, 22, 42, 20, 0); $this->assertCarbon($dt->copy()->floor()->round(5), 2315, 7, 18, 22, 42, 15, 0); $this->assertCarbon($dt->copy()->round(3), 2315, 7, 18, 22, 42, 18, 0); $this->assertCarbon($dt->copy()->round(4), 2315, 7, 18, 22, 42, 16, 0); $this->assertCarbon($dt->copy()->round(10), 2315, 7, 18, 22, 42, 20, 0); $this->assertCarbon($dt->copy()->round(0.5), 2315, 7, 18, 22, 42, 17, 500000); $this->assertCarbon($dt->copy()->round(0.25), 2315, 7, 18, 22, 42, 17, 750000); $this->assertCarbon($dt->copy()->round(3.8), 2315, 7, 18, 22, 42, 19, 800000); $this->assertCarbon($dt->copy()->floor(5), 2315, 7, 18, 22, 42, 15, 0); $this->assertCarbon($dt->copy()->floor()->floor(5), 2315, 7, 18, 22, 42, 15, 0); $this->assertCarbon($dt->copy()->floor(3), 2315, 7, 18, 22, 42, 15, 0); $this->assertCarbon($dt->copy()->floor(4), 2315, 7, 18, 22, 42, 16, 0); $this->assertCarbon($dt->copy()->floor(10), 2315, 7, 18, 22, 42, 10, 0); $this->assertCarbon($dt->copy()->floor(0.5), 2315, 7, 18, 22, 42, 17, 500000); $this->assertCarbon($dt->copy()->floor(0.25), 2315, 7, 18, 22, 42, 17, 500000); $this->assertCarbon($dt->copy()->floor(3.8), 2315, 7, 18, 22, 42, 15, 0); $this->assertCarbon($dt->copy()->ceil(5), 2315, 7, 18, 22, 42, 20, 0); $this->assertCarbon($dt->copy()->floor()->ceil(5), 2315, 7, 18, 22, 42, 20, 0); $this->assertCarbon($dt->copy()->ceil(3), 2315, 7, 18, 22, 42, 18, 0); $this->assertCarbon($dt->copy()->ceil(4), 2315, 7, 18, 22, 42, 20, 0); $this->assertCarbon($dt->copy()->ceil(10), 2315, 7, 18, 22, 42, 20, 0); $this->assertCarbon($dt->copy()->ceil(0.5), 2315, 7, 18, 22, 42, 18, 0); $this->assertCarbon($dt->copy()->ceil(0.25), 2315, 7, 18, 22, 42, 17, 750000); $this->assertCarbon($dt->copy()->ceil(3.8), 2315, 7, 18, 22, 42, 19, 800000); } public function testRoundWithStrings() { $dt = Carbon::create(2315, 7, 18, 22, 42, 17.643971); $this->assertCarbon($dt->copy()->round('minute'), 2315, 7, 18, 22, 42, 0, 0); $this->assertCarbon($dt->copy()->floor('5 minutes'), 2315, 7, 18, 22, 40, 0, 0); $this->assertCarbon($dt->copy()->ceil('5 minutes'), 2315, 7, 18, 22, 45, 0, 0); } public function testRoundWithStringsException() { $this->expectExceptionObject(new InvalidArgumentException( 'Rounding is only possible with single unit intervals.', )); Carbon::create(2315, 7, 18, 22, 42, 17.643971)->round('2 hours 5 minutes'); } public function testRoundWithInterval() { $dt = Carbon::create(2315, 7, 18, 22, 42, 17.643971); $this->assertCarbon($dt->copy()->round(CarbonInterval::minute()), 2315, 7, 18, 22, 42, 0, 0); $this->assertCarbon($dt->copy()->floor(CarbonInterval::minutes(5)), 2315, 7, 18, 22, 40, 0, 0); $this->assertCarbon($dt->copy()->ceil(new DateInterval('PT5M')), 2315, 7, 18, 22, 45, 0, 0); } public function testRoundWithIntervalException() { $this->expectExceptionObject(new InvalidArgumentException( 'Rounding is only possible with single unit intervals.', )); Carbon::create(2315, 7, 18, 22, 42, 17.643971)->round(CarbonInterval::day()->minutes(5)); } public function testRoundWithBaseUnit() { $dt = Carbon::create(2315, 7, 18, 22, 42, 17.643971); $copy = $dt->copy(); $ref = $copy->roundSecond(); $this->assertSame($ref, $copy); $this->assertCarbon($ref, 2315, 7, 18, 22, 42, 18, 0); $this->assertCarbon($dt->copy()->roundDay(), 2315, 7, 19, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->roundDay(5), 2315, 7, 21, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->ceilDay(), 2315, 7, 19, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->floorDay(), 2315, 7, 18, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->roundYear(), 2316, 1, 1, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->subMonths(2)->roundYear(), 2315, 1, 1, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->roundYear(2), 2315, 1, 1, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->floorYear(2), 2315, 1, 1, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->ceilYear(2), 2317, 1, 1, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->roundMonth(), 2315, 8, 1, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->floorMonth(), 2315, 7, 1, 0, 0, 0, 0); for ($i = 1; $i <= Carbon::MONTHS_PER_YEAR; $i++) { $dt = Carbon::parse("2021-$i-01")->endOfMonth()->floorMonth(); $this->assertCarbon($dt, 2021, $i, 1, 0, 0, 0, 0); } } public function testFloorYear() { $date = Carbon::create(2022)->endOfYear()->floorYear(); $this->assertCarbon($date, 2022, 1, 1, 0, 0, 0, 0); $date = Carbon::create(2022)->endOfYear()->floorDay()->floorYear(); $this->assertCarbon($date, 2022, 1, 1, 0, 0, 0, 0); $date = Carbon::create(2022)->endOfYear()->floorYear(); $this->assertCarbon($date, 2022, 1, 1, 0, 0, 0, 0); $date = Carbon::create(2022)->addMonths(6)->floorYear(); $this->assertCarbon($date, 2022, 1, 1, 0, 0, 0, 0); } public function testCeilYear() { $date = Carbon::create(2022)->addMonths(6)->ceilYear(); $this->assertCarbon($date, 2023, 1, 1, 0, 0, 0, 0); $date = Carbon::create(2022)->endOfYear()->ceilYear(); $this->assertCarbon($date, 2023, 1, 1, 0, 0, 0, 0); $date = Carbon::create(2022)->ceilYear(); $this->assertCarbon($date, 2022, 1, 1, 0, 0, 0, 0); $date = Carbon::create(2022)->addMicrosecond()->ceilYear(); $this->assertCarbon($date, 2023, 1, 1, 0, 0, 0, 0); } public function testRoundWithMetaUnit() { $dt = Carbon::create(2315, 7, 18, 22, 42, 17.643971); $copy = $dt->copy(); $ref = $copy->roundSecond(); $this->assertSame($ref, $copy); $this->assertCarbon($ref, 2315, 7, 18, 22, 42, 18, 0); $this->assertCarbon($dt->copy()->roundMillisecond(), 2315, 7, 18, 22, 42, 17, 644000); $this->assertCarbon($dt->copy()->roundMillennium(), 2001, 1, 1, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->roundQuarter(), 2315, 7, 1, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->roundQuarters(2), 2315, 7, 1, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->subMonth()->floorQuarter(), 2315, 4, 1, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->subMonth()->floorQuarters(2), 2315, 1, 1, 0, 0, 0, 0); } public function testRoundWeek() { $dt = Carbon::create(2315, 7, 18, 22, 42, 17.643971); $copy = $dt->copy(); $ref = $copy->roundSecond(); $this->assertSame($ref, $copy); $this->assertCarbon($ref, 2315, 7, 18, 22, 42, 18, 0); $this->assertCarbon($dt->copy()->floorWeek(), 2315, 7, 12, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->ceilWeek(), 2315, 7, 19, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->roundWeek(), 2315, 7, 19, 0, 0, 0, 0); $dt = Carbon::create(2315, 7, 19, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->floorWeek(), 2315, 7, 19, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->ceilWeek(), 2315, 7, 19, 0, 0, 0, 0); $this->assertCarbon($dt->copy()->roundWeek(), 2315, 7, 19, 0, 0, 0, 0); } public function testCeilMonth() { $this->assertCarbon(Carbon::parse('2021-01-29')->ceilMonth(), 2021, 2, 1, 0, 0, 0); $this->assertCarbon(Carbon::parse('2021-01-31')->ceilMonth(), 2021, 2, 1, 0, 0, 0); $this->assertCarbon(Carbon::parse('2021-12-17')->ceilMonth(), 2022, 1, 1, 0, 0, 0); } public function testFloorMonth() { $this->assertCarbon(Carbon::parse('2021-05-31')->floorMonth(3), 2021, 4, 1, 0, 0, 0); } public function testRoundInvalidArgument() { $this->expectExceptionObject(new InvalidArgumentException( 'Unknown unit \'foobar\'.', )); Carbon::now()->roundUnit('foobar'); } public function testRoundWithNumericPrecisionCarry() { // A numeric precision >= 60s must carry, like the equivalent string unit. $dt = Carbon::create(2026, 1, 1, 14, 21, 37); $this->assertCarbon($dt->copy()->round(3600), 2026, 1, 1, 14, 0, 0, 0); $this->assertTrue($dt->copy()->round(3600)->eq($dt->copy()->round('hour'))); $this->assertCarbon($dt->copy()->round(120), 2026, 1, 1, 14, 22, 0, 0); $this->assertTrue($dt->copy()->round(120)->eq($dt->copy()->round('2 minutes'))); $this->assertCarbon($dt->copy()->round(86400), 2026, 1, 2, 0, 0, 0, 0); $this->assertTrue($dt->copy()->round(86400)->eq($dt->copy()->round('day'))); // floor() with numeric precision must also carry, not just clamp within the minute. $almostNextHour = Carbon::create(2026, 1, 1, 14, 59, 59); $this->assertCarbon($almostNextHour->copy()->floor(3600), 2026, 1, 1, 14, 0, 0, 0); $this->assertTrue($almostNextHour->copy()->floor(3600)->eq($almostNextHour->copy()->floor('hour'))); // ceil() with numeric precision must carry across the hour boundary. $halfPastHour = Carbon::create(2026, 1, 1, 14, 30, 0); $this->assertCarbon($halfPastHour->copy()->ceil(3600), 2026, 1, 1, 15, 0, 0, 0); $this->assertTrue($halfPastHour->copy()->ceil(3600)->eq($halfPastHour->copy()->ceil('hour'))); // Carry across a month boundary via a day-level numeric precision. $monthEnd = Carbon::create(2026, 1, 31, 20, 0, 0); $this->assertCarbon($monthEnd->copy()->round(86400), 2026, 2, 1, 0, 0, 0, 0); // Sub-minute numeric precision must keep rounding within the second field, unchanged. $this->assertCarbon($dt->copy()->round(30), 2026, 1, 1, 14, 21, 30, 0); } }