AddTest.php 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441
  1. <?php
  2. declare(strict_types=1);
  3. /**
  4. * This file is part of the Carbon package.
  5. *
  6. * (c) Brian Nesbitt <brian@nesbot.com>
  7. *
  8. * For the full copyright and license information, please view the LICENSE
  9. * file that was distributed with this source code.
  10. */
  11. namespace Tests\CarbonImmutable;
  12. use Carbon\CarbonImmutable as Carbon;
  13. use Carbon\CarbonInterval;
  14. use DateTimeImmutable;
  15. use Tests\AbstractTestCase;
  16. class AddTest extends AbstractTestCase
  17. {
  18. public function testAddMethod()
  19. {
  20. $this->assertSame(1977, Carbon::createFromDate(1975)->add(2, 'year')->year);
  21. $this->assertSame(1977, Carbon::createFromDate(1975)->add('year', 2)->year);
  22. $this->assertSame(1977, Carbon::createFromDate(1975)->add('2 years')->year);
  23. $lastNegated = null;
  24. $date = Carbon::createFromDate(1975)->add(
  25. function (DateTimeImmutable $date, bool $negated = false) use (&$lastNegated): DateTimeImmutable {
  26. $lastNegated = $negated;
  27. return new DateTimeImmutable($date->format('Y-m-d H:i:s').' + 2 years');
  28. }
  29. );
  30. $this->assertInstanceOf(Carbon::class, $date);
  31. $this->assertSame(1977, $date->year);
  32. $this->assertFalse($lastNegated);
  33. /** @var CarbonInterval $interval */
  34. $interval = include __DIR__.'/../Fixtures/dynamicInterval.php';
  35. $originalDate = Carbon::parse('2020-06-04');
  36. $date = $originalDate->add($interval);
  37. $this->assertInstanceOf(Carbon::class, $date);
  38. $this->assertSame('2020-06-08', $date->format('Y-m-d'));
  39. $this->assertNotSame($date, $originalDate);
  40. $date = Carbon::parse('2020-06-23')->add($interval);
  41. $this->assertInstanceOf(Carbon::class, $date);
  42. $this->assertSame('2020-07-16', $date->format('Y-m-d'));
  43. }
  44. public function testAddYearsPositive()
  45. {
  46. $this->assertSame(1976, Carbon::createFromDate(1975)->addYears(1)->year);
  47. }
  48. public function testAddYearsZero()
  49. {
  50. $this->assertSame(1975, Carbon::createFromDate(1975)->addYears(0)->year);
  51. }
  52. public function testAddYearsNegative()
  53. {
  54. $this->assertSame(1974, Carbon::createFromDate(1975)->addYears(-1)->year);
  55. }
  56. public function testAddYear()
  57. {
  58. $this->assertSame(1976, Carbon::createFromDate(1975)->addYear()->year);
  59. $this->assertSame(1977, Carbon::createFromDate(1975)->add(2, 'year')->year);
  60. $this->assertSame(1977, Carbon::createFromDate(1975)->add(2, 'years')->year);
  61. $this->assertSame(1977, Carbon::createFromDate(1975)->add(CarbonInterval::years(2))->year);
  62. }
  63. public function testAddDaysPositive()
  64. {
  65. $this->assertSame(1, Carbon::createFromDate(1975, 5, 31)->addDays(1)->day);
  66. }
  67. public function testAddDaysZero()
  68. {
  69. $this->assertSame(31, Carbon::createFromDate(1975, 5, 31)->addDays(0)->day);
  70. }
  71. public function testAddDaysNegative()
  72. {
  73. $this->assertSame(30, Carbon::createFromDate(1975, 5, 31)->addDays(-1)->day);
  74. }
  75. public function testAddDay()
  76. {
  77. $this->assertSame(1, Carbon::createFromDate(1975, 5, 31)->addDay()->day);
  78. }
  79. public function testAddOverflow()
  80. {
  81. $this->assertSame(
  82. '2021-03-03',
  83. Carbon::parse('2021-01-31')->add(1, 'months', true)->format('Y-m-d')
  84. );
  85. $this->assertSame(
  86. '2021-03-03',
  87. Carbon::parse('2021-01-31')->add(1, 'months')->format('Y-m-d')
  88. );
  89. $this->assertSame(
  90. '2021-02-28',
  91. Carbon::parse('2021-01-31')->add(1, 'months', false)->format('Y-m-d')
  92. );
  93. }
  94. public function testAddWeekdaysPositive()
  95. {
  96. $dt = Carbon::create(2012, 1, 4, 13, 2, 1)->addWeekdays(9);
  97. $this->assertSame(17, $dt->day);
  98. // test for https://bugs.php.net/bug.php?id=54909
  99. $this->assertSame(13, $dt->hour);
  100. $this->assertSame(2, $dt->minute);
  101. $this->assertSame(1, $dt->second);
  102. }
  103. public function testAddWeekdaysZero()
  104. {
  105. $this->assertSame(4, Carbon::createFromDate(2012, 1, 4)->addWeekdays(0)->day);
  106. }
  107. public function testAddWeekdaysNegative()
  108. {
  109. $this->assertSame(18, Carbon::createFromDate(2012, 1, 31)->addWeekdays(-9)->day);
  110. }
  111. public function testAddWeekday()
  112. {
  113. $this->assertSame(9, Carbon::createFromDate(2012, 1, 6)->addWeekday()->day);
  114. }
  115. public function testAddWeekdayDuringWeekend()
  116. {
  117. $this->assertSame(9, Carbon::createFromDate(2012, 1, 7)->addWeekday()->day);
  118. }
  119. public function testAddWeeksPositive()
  120. {
  121. $this->assertSame(28, Carbon::createFromDate(1975, 5, 21)->addWeeks(1)->day);
  122. }
  123. public function testAddWeeksZero()
  124. {
  125. $this->assertSame(21, Carbon::createFromDate(1975, 5, 21)->addWeeks(0)->day);
  126. }
  127. public function testAddWeeksNegative()
  128. {
  129. $this->assertSame(14, Carbon::createFromDate(1975, 5, 21)->addWeeks(-1)->day);
  130. }
  131. public function testAddWeek()
  132. {
  133. $this->assertSame(28, Carbon::createFromDate(1975, 5, 21)->addWeek()->day);
  134. }
  135. public function testAddHoursPositive()
  136. {
  137. $this->assertSame(1, Carbon::createFromTime(0)->addHours(1)->hour);
  138. }
  139. public function testAddHoursZero()
  140. {
  141. $this->assertSame(0, Carbon::createFromTime(0)->addHours(0)->hour);
  142. }
  143. public function testAddHoursNegative()
  144. {
  145. $this->assertSame(23, Carbon::createFromTime(0)->addHours(-1)->hour);
  146. }
  147. public function testAddHour()
  148. {
  149. $this->assertSame(1, Carbon::createFromTime(0)->addHour()->hour);
  150. }
  151. public function testAddMinutesPositive()
  152. {
  153. $this->assertSame(1, Carbon::createFromTime(0, 0)->addMinutes(1)->minute);
  154. }
  155. public function testAddMinutesZero()
  156. {
  157. $this->assertSame(0, Carbon::createFromTime(0, 0)->addMinutes(0)->minute);
  158. }
  159. public function testAddMinutesNegative()
  160. {
  161. $this->assertSame(59, Carbon::createFromTime(0, 0)->addMinutes(-1)->minute);
  162. }
  163. public function testAddMinute()
  164. {
  165. $this->assertSame(1, Carbon::createFromTime(0, 0)->addMinute()->minute);
  166. }
  167. public function testAddSecondsPositive()
  168. {
  169. $this->assertSame(1, Carbon::createFromTime(0, 0, 0)->addSeconds(1)->second);
  170. }
  171. public function testAddSecondsZero()
  172. {
  173. $this->assertSame(0, Carbon::createFromTime(0, 0, 0)->addSeconds(0)->second);
  174. }
  175. public function testAddSecondsNegative()
  176. {
  177. $this->assertSame(59, Carbon::createFromTime(0, 0, 0)->addSeconds(-1)->second);
  178. }
  179. public function testAddSecond()
  180. {
  181. $this->assertSame(1, Carbon::createFromTime(0, 0, 0)->addSecond()->second);
  182. }
  183. public function testAddMillisecondsPositive()
  184. {
  185. $this->assertSame(1, Carbon::createFromTime(0, 0, 0)->addMilliseconds(1)->millisecond);
  186. }
  187. public function testAddMillisecondsZero()
  188. {
  189. $this->assertSame(100, Carbon::createFromTime(0, 0, 0.1)->addMilliseconds(0)->millisecond);
  190. }
  191. public function testAddMillisecondsNegative()
  192. {
  193. $this->assertSame(999, Carbon::createFromTime(0, 0, 0)->addMilliseconds(-1)->millisecond);
  194. $this->assertSame(99, Carbon::createFromTime(0, 0, 0.1)->addMilliseconds(-1)->millisecond);
  195. }
  196. public function testAddMillisecond()
  197. {
  198. $this->assertSame(101, Carbon::createFromTime(0, 0, 0.1)->addMillisecond()->millisecond);
  199. }
  200. public function testAddMicrosecondsPositive()
  201. {
  202. $this->assertSame(1, Carbon::createFromTime(0, 0, 0)->addMicroseconds(1)->microsecond);
  203. }
  204. public function testAddMicrosecondsZero()
  205. {
  206. $this->assertSame(100000, Carbon::createFromTime(0, 0, 0.1)->addMicroseconds(0)->microsecond);
  207. }
  208. public function testAddMicrosecondsNegative()
  209. {
  210. $this->assertSame(999999, Carbon::createFromTime(0, 0, 0)->addMicroseconds(-1)->microsecond);
  211. $this->assertSame(99999, Carbon::createFromTime(0, 0, 0.1)->addMicroseconds(-1)->microsecond);
  212. }
  213. public function testAddMicrosecond()
  214. {
  215. $this->assertSame(100001, Carbon::createFromTime(0, 0, 0.1)->addMicrosecond()->microsecond);
  216. }
  217. /**
  218. * Test non plural methods with non default args.
  219. */
  220. public function testAddYearPassingArg()
  221. {
  222. /** @var mixed $date */
  223. $date = Carbon::createFromDate(1975);
  224. $this->assertSame(1977, $date->addYear(2)->year);
  225. }
  226. public function testAddDayPassingArg()
  227. {
  228. /** @var mixed $date */
  229. $date = Carbon::createFromDate(1975, 5, 10);
  230. $this->assertSame(12, $date->addDay(2)->day);
  231. }
  232. public function testAddHourPassingArg()
  233. {
  234. /** @var mixed $date */
  235. $date = Carbon::createFromTime(10);
  236. $this->assertSame(12, $date->addHour(2)->hour);
  237. }
  238. public function testAddMinutePassingArg()
  239. {
  240. /** @var mixed $date */
  241. $date = Carbon::createFromTime(0);
  242. $this->assertSame(2, $date->addMinute(2)->minute);
  243. }
  244. public function testAddSecondPassingArg()
  245. {
  246. /** @var mixed $date */
  247. $date = Carbon::createFromTime(0);
  248. $this->assertSame(2, $date->addSecond(2)->second);
  249. }
  250. public function testAddQuarter()
  251. {
  252. $this->assertSame(8, Carbon::createFromDate(1975, 5, 6)->addQuarter()->month);
  253. }
  254. public function testAddQuarterNegative()
  255. {
  256. /** @var mixed $date */
  257. $date = Carbon::createFromDate(1975, 5, 6);
  258. $this->assertSame(2, $date->addQuarter(-1)->month);
  259. }
  260. public function testSubQuarter()
  261. {
  262. $this->assertSame(2, Carbon::createFromDate(1975, 5, 6)->subQuarter()->month);
  263. }
  264. public function testSubQuarterNegative()
  265. {
  266. $this->assertCarbon(Carbon::createFromDate(1975, 5, 6)->subQuarters(2), 1974, 11, 6);
  267. }
  268. public function testAddCentury()
  269. {
  270. $this->assertSame(2075, Carbon::createFromDate(1975)->addCentury()->year);
  271. /** @var mixed $date */
  272. $date = Carbon::createFromDate(1975);
  273. $this->assertSame(2075, $date->addCentury(1)->year);
  274. /** @var mixed $date */
  275. $date = Carbon::createFromDate(1975);
  276. $this->assertSame(2175, $date->addCentury(2)->year);
  277. }
  278. public function testAddCenturyNegative()
  279. {
  280. /** @var mixed $date */
  281. $date = Carbon::createFromDate(1975);
  282. $this->assertSame(1875, $date->addCentury(-1)->year);
  283. /** @var mixed $date */
  284. $date = Carbon::createFromDate(1975);
  285. $this->assertSame(1775, $date->addCentury(-2)->year);
  286. }
  287. public function testAddCenturies()
  288. {
  289. $this->assertSame(2075, Carbon::createFromDate(1975)->addCenturies(1)->year);
  290. $this->assertSame(2175, Carbon::createFromDate(1975)->addCenturies(2)->year);
  291. }
  292. public function testAddCenturiesNegative()
  293. {
  294. $this->assertSame(1875, Carbon::createFromDate(1975)->addCenturies(-1)->year);
  295. $this->assertSame(1775, Carbon::createFromDate(1975)->addCenturies(-2)->year);
  296. }
  297. public function testSubCentury()
  298. {
  299. $this->assertSame(1875, Carbon::createFromDate(1975)->subCentury()->year);
  300. /** @var mixed $date */
  301. $date = Carbon::createFromDate(1975);
  302. $this->assertSame(1875, $date->subCentury(1)->year);
  303. /** @var mixed $date */
  304. $date = Carbon::createFromDate(1975);
  305. $this->assertSame(1775, $date->subCentury(2)->year);
  306. }
  307. public function testSubCenturyNegative()
  308. {
  309. /** @var mixed $date */
  310. $date = Carbon::createFromDate(1975);
  311. $this->assertSame(2075, $date->subCentury(-1)->year);
  312. /** @var mixed $date */
  313. $date = Carbon::createFromDate(1975);
  314. $this->assertSame(2175, $date->subCentury(-2)->year);
  315. }
  316. public function testSubCenturies()
  317. {
  318. $this->assertSame(1875, Carbon::createFromDate(1975)->subCenturies(1)->year);
  319. $this->assertSame(1775, Carbon::createFromDate(1975)->subCenturies(2)->year);
  320. }
  321. public function testSubCenturiesNegative()
  322. {
  323. $this->assertSame(2075, Carbon::createFromDate(1975)->subCenturies(-1)->year);
  324. $this->assertSame(2175, Carbon::createFromDate(1975)->subCenturies(-2)->year);
  325. }
  326. public function testAddYearNoOverflow()
  327. {
  328. $this->assertCarbon(Carbon::createFromDate(2016, 2, 29)->addYearNoOverflow(), 2017, 2, 28);
  329. }
  330. public function testAddYearWithOverflow()
  331. {
  332. $this->assertCarbon(Carbon::createFromDate(2016, 2, 29)->addYearWithOverflow(), 2017, 3, 1);
  333. }
  334. public function testAddYearNoOverflowPassingArg()
  335. {
  336. $this->assertCarbon(Carbon::createFromDate(2016, 2, 29)->addYearsNoOverflow(2), 2018, 2, 28);
  337. }
  338. public function testAddYearWithOverflowPassingArg()
  339. {
  340. $this->assertCarbon(Carbon::createFromDate(2016, 2, 29)->addYearsWithOverflow(2), 2018, 3, 1);
  341. }
  342. public function testSubYearNoOverflowPassingArg()
  343. {
  344. $this->assertCarbon(Carbon::createFromDate(2016, 2, 29)->subYearsNoOverflow(2), 2014, 2, 28);
  345. }
  346. public function testSubYearWithOverflowPassingArg()
  347. {
  348. $this->assertCarbon(Carbon::createFromDate(2016, 2, 29)->subYearsWithOverflow(2), 2014, 3, 1);
  349. }
  350. public function testSubYearNoOverflow()
  351. {
  352. $this->assertCarbon(Carbon::createFromDate(2016, 2, 29)->subYearNoOverflow(), 2015, 2, 28);
  353. }
  354. public function testSubYearWithOverflow()
  355. {
  356. $this->assertCarbon(Carbon::createFromDate(2016, 2, 29)->subYearWithOverflow(), 2015, 3, 1);
  357. }
  358. public function testUseYearsOverflow()
  359. {
  360. $this->assertTrue(Carbon::shouldOverflowYears());
  361. $this->assertCarbon(Carbon::createFromDate(2016, 2, 29)->addYears(2), 2018, 3, 1);
  362. Carbon::useYearsOverflow(false);
  363. $this->assertFalse(Carbon::shouldOverflowYears());
  364. $this->assertCarbon(Carbon::createFromDate(2016, 2, 29)->addYears(2), 2018, 2, 28);
  365. Carbon::resetYearsOverflow();
  366. $this->assertTrue(Carbon::shouldOverflowYears());
  367. $this->assertCarbon(Carbon::createFromDate(2016, 2, 29)->addYears(2), 2018, 3, 1);
  368. }
  369. }