Carbon

کار با تاریخ و زمان در PHP به‌شکل انسانی

۴.۸۲ از ۵ PHP

این کتابخانه چیست و چه می‌کند؟

Carbon روی DateTime پایتون‌وار سوار شده: addDays، diffInDays، فرمت فارسی‌پسند و locale — همه با API روان. در Laravel از پیش نصب است و برای محاسبه اعتبار اشتراک، مهلت پرداخت و گزارش‌های زمانی PHP انتخاب اول است.

قابلیت‌های کلیدی

  • API روان add/sub/diff
  • پشتیبانی locale فارسی
  • مقایسه و بازه‌های زمانی
  • ادغام کامل با Laravel

مثال کاربردی واقعی

قابل اجرا
use Carbon\Carbon;

$now = Carbon::now();
$expire = $now->copy()->addDays(30);
echo $expire->format('Y/m/d');
echo ' باقی‌مانده: ' . $now->diffInDays($expire) . ' روز';
Carbon::setLocale('fa');
echo $now->diffForHumans($expire);  // «۳۰ روز دیگر»

توضیح مثال: تاریخ انقضا ۳۰ روزه ساخته، اختلاف روزها محاسبه و با locale فارسی خروجی انسانی گرفته می‌شود — همان «۳ روز پیش» پنل‌ها.

نکات حرفه‌ای

  • همیشه copy() بگیرید تا آبجکت اصلی تغییر نکند.
  • برای تاریخ شمسی، jdatetime یا پکیج jalalian را کنار Carbon بگذارید.