快速切換前後日期<?phpuse Carbon\Carbon;$now=Carbon::now();echo$now;//-03-2600:36:47$today=Carbon::today();echo$today;//-03-2600:00:00$tomorrow=Carbon::tomorrow('Europe/London');echo$tomorrow;//-03-2700:00:00$yesterday=Carbon::yesterday();echo$yesterday;//-03-2500:00:00
建立特定日期的時間<?phpuse Carbon\Carbon;$timezone='Asia/Taipei';//從「年月日」建立Carbon::createFromDate($year,$month,$day,$timezone);//從「時分秒」建立Carbon::createFromTime($hour,$minute,$second,$timezone);//從完整的「年月日時分秒」建立Carbon::create($year,$month,$day,$hour,$minute,$second,$timezone);//從指定的格式建立Carbon::createFromFormat($format,$time,$tz);echoCarbon::createFromFormat('Y-m-dH','1975-05-2122')->toDateTimeString();//1975-05-2122:00:00//從時間戳記建立echoCarbon::createFromTimeStamp(-1)->toDateTimeString();//1969-12-3118:59:59echoCarbon::createFromTimeStamp(-1,'Europe/London')->toDateTimeString();//1970-01-0100:59:59echoCarbon::createFromTimeStampUTC(-1)->toDateTimeString();//1969-12-3123:59:59
轉換日期<?phpuse Carbon\Carbon;//透過文字移動日期$knownDate=Carbon::create(2001,5,21,12);//createtestingdateCarbon::setTestNow($knownDate);//setthemockechonewCarbon('tomorrow');//2001-05-2200:00:00...noticethetime!echonewCarbon('yesterday');//2001-05-2000:00:00echonewCarbon('nextwednesday');//2001-05-2300:00:00echonewCarbon('lastfriday');//2001-05-1800:00:00echonewCarbon('thisthursday');//2001-05-2400:00:00
取得日期資料<?phpuse Carbon\Carbon;$dt=Carbon::parse('-9-523:26:11.123789');//取的指定時間資料的資訊(整數)var_dump($dt->year);//int()var_dump($dt->month);//int(9)var_dump($dt->day);//int(5)var_dump($dt->hour);//int(23)var_dump($dt->minute);//int(26)var_dump($dt->second);//int(11)var_dump($dt->micro);//int(123789)var_dump($dt->dayOfWeek);//int(3)var_dump($dt->dayOfYear);//int(248)var_dump($dt->weekOfMonth);//int(1)var_dump($dt->weekOfYear);//int(36)var_dump($dt->daysInMonth);//int(30)var_dump($dt->timestamp);//int(1346901971)var_dump(Carbon::createFromDate(1975,5,21)->age);//int(39)calculatedvsnowinthesametzvar_dump($dt->quarter);//int(3)//回傳與UTC差異的秒數var_dump(Carbon::createFromTimestampUTC(0)->offset);//int(0)var_dump(Carbon::createFromTimestamp(0)->offset);//int(-18000)//回傳與UTC差異的時數var_dump(Carbon::createFromTimestamp(0)->offsetHours);//int(-5)//找出當天日否有日光節約時間var_dump(Carbon::createFromDate(,1,1)->dst);//bool(false)var_dump(Carbon::createFromDate(,9,1)->dst);//bool(true)//判斷指定的的時區是否與預設的時區相同var_dump(Carbon::now()->local);//bool(true)var_dump(Carbon::now('America/Vancouver')->local);//bool(false)//判斷是否為UTC的時區時間var_dump(Carbon::now()->utc);//bool(false)var_dump(Carbon::now('Europe/London')->utc);//bool(true)var_dump(Carbon::createFromTimestampUTC(0)->utc);//bool(true)//取得時區實例echoget_class(Carbon::now()->timezone);//DateTimeZoneechoget_class(Carbon::now()->tz);//DateTimeZone//取得時區實例的名稱echoCarbon::now()->timezoneName;//America/TorontoechoCarbon::now()->tzName;//America/Toronto
設定時間資料<?phpuse Carbon\Carbon;$dt=Carbon::now();$dt->year=1975;$dt->month=13;//年份會強制+1，且月份變為1月$dt->month=5;$dt->day=21;$dt->hour=22;$dt->minute=32;$dt->second=5;$dt->timestamp=169957925;//這個設定不會變更時區//透過字串或是DateTimeZone實例去設定時區$dt->timezone=newDateTimeZone('Europe/London');$dt->timezone='Europe/London';$dt->tz='Europe/London';//鏈結設定方式$dt->year(1975)->month(5)->day(21)->hour(22)->minute(32)->second(5)->toDateTimeString();$dt->setDate(1975,5,21)->setTime(22,32,5)->toDateTimeString();$dt->setDateTime(1975,5,21,22,32,5)->toDateTimeString();$dt->timestamp(169957925)->timezone('Europe/London');$dt->tz('America/Toronto')->setTimezone('America/Vancouver');
格式化時間資料<?phpuse Carbon\Carbon;$dt=Carbon::create(1975,12,25,14,15,16);var_dump($dt->toDateTimeString()==$dt);//bool(true)=>uses__toString()echo$dt->toDateString();//1975-12-25echo$dt->toFormattedDateString();//Dec25,1975echo$dt->toTimeString();//14:15:16echo$dt->toDateTimeString();//1975-12-2514:15:16echo$dt->toDayDateTimeString();//Thu,Dec25,19752:15PM//仍可以使用format()函式echo$dt->format('ljS\\ofFYh:i:sA');//Thursday25thofDecember197502:15:16PM//常用的時間格式echo$dt->toAtomString();//in1Jahrecho$dt->toCookieString();//Thursday,25-Dec-197514:15:16ESTecho$dt->toIso8601String();//1975-12-25T14:15:16-0500echo$dt->toRfc822String();//Thu,25Dec7514:15:16-0500echo$dt->toRfc850String();//Thursday,25-Dec-7514:15:16ESTecho$dt->toRfc1036String();//Thu,25Dec7514:15:16-0500echo$dt->toRfc1123String();//Thu,25Dec197514:15:16-0500echo$dt->toRfc2822String();//Thu,25Dec197514:15:16-0500echo$dt->toRfc3339String();//1975-12-25T14:15:16-05:00echo$dt->toRssString();//Thu,25Dec197514:15:16-0500echo$dt->toW3cString();//1975-12-25T14:15:16-05:00
比較時間差異<?phpuse Carbon\Carbon;echoCarbon::now()->tzName;//America/Toronto$first=Carbon::create(,9,5,23,26,11);$second=Carbon::create(,9,5,20,26,11,'America/Vancouver');echo$first->toDateTimeString();//-09-0523:26:11echo$first->tzName;//America/Torontoecho$second->toDateTimeString();//-09-0520:26:11echo$second->tzName;//America/Vancouver//大於、等於、小於var_dump($first->eq($second));//bool(true)var_dump($first->ne($second));//bool(false)var_dump($first->gt($second));//bool(false)var_dump($first->gte($second));//bool(true)var_dump($first->lt($second));//bool(false)var_dump($first->lte($second));//bool(true)$first->setDateTime(,1,1,0,0,0);$second->setDateTime(,1,1,0,0,0);//Remembertzis'America/Vancouver'var_dump($first->eq($second));//bool(false)var_dump($first->ne($second));//bool(true)var_dump($first->gt($second));//bool(false)var_dump($first->gte($second));//bool(false)var_dump($first->lt($second));//bool(true)var_dump($first->lte($second));//bool(true)//時間區間比較$first=Carbon::create(,9,5,1);$second=Carbon::create(,9,5,5);var_dump(Carbon::create(,9,5,3)->between($first,$second));//bool(true)var_dump(Carbon::create(,9,5,5)->between($first,$second));//bool(true)var_dump(Carbon::create(,9,5,5)->between($first,$second,false));//bool(false)//時間大小比較$dt1=Carbon::create(,1,1,0,0,0);$dt2=Carbon::create(,1,30,0,0,0);echo$dt1->min($dt2);//-01-0100:00:00$dt1=Carbon::create(,1,1,0,0,0);$dt2=Carbon::create(,1,30,0,0,0);echo$dt1->max($dt2);//-01-3000:00:00//nowisthedefaultparam$dt1=Carbon::create(2000,1,1,0,0,0);echo$dt1->max();//時間差異運算echoCarbon::now('America/Vancouver')->diffInSeconds(Carbon::now('Europe/London'));//0$dtOttawa=Carbon::createFromDate(2000,1,1,'America/Toronto');$dtVancouver=Carbon::createFromDate(2000,1,1,'America/Vancouver');echo$dtOttawa->diffInHours($dtVancouver);//3echo$dtOttawa->diffInHours($dtVancouver,false);//3echo$dtVancouver->diffInHours($dtOttawa,false);//-3$dt=Carbon::create(,1,31,0);echo$dt->diffInDays($dt->copy()->addMonth());//31echo$dt->diffInDays($dt->copy()->subMonth(),false);//-31$dt=Carbon::create(,4,30,0);echo$dt->diffInDays($dt->copy()->addMonth());//30echo$dt->diffInDays($dt->copy()->addWeek());//7$dt=Carbon::create(,1,1,0);echo$dt->diffInMinutes($dt->copy()->addSeconds(59));//0echo$dt->diffInMinutes($dt->copy()->addSeconds(60));//1echo$dt->diffInMinutes($dt->copy()->addSeconds(119));//1echo$dt->diffInMinutes($dt->copy()->addSeconds(120));//2echo$dt->addSeconds(120)->secondsSinceMidnight();//120
時間狀態<?phpuse Carbon\Carbon;$dt=Carbon::now();$dt->isWeekday();$dt->isWeekend();$dt->isYesterday();$dt->isToday();$dt->isTomorrow();$dt->isFuture();$dt->isPast();$dt->isLeapYear();$dt->isSameDay(Carbon::now());$born=Carbon::createFromDate(1987,4,23);$noCake=Carbon::createFromDate(,9,26);$yesCake=Carbon::createFromDate(,4,23);var_dump($born->isBirthday($noCake));//bool(false)var_dump($born->isBirthday($yesCake));//bool(true)
時間運算<?phpuse Carbon\Carbon;$dt=Carbon::create(,1,31,0);echo$dt->toDateTimeString();//-01-3100:00:00echo$dt->addYears(5);//-01-3100:00:00echo$dt->addYear();//-01-3100:00:00echo$dt->subYear();//-01-3100:00:00echo$dt->subYears(5);//-01-3100:00:00echo$dt->addMonths(60);//-01-3100:00:00echo$dt->addMonth();//-03-0300:00:00equivalentof$dt->month($dt->month+1);soitwrapsecho$dt->subMonth();//-02-0300:00:00echo$dt->subMonths(60);//-02-0300:00:00echo$dt->addDays(29);//-03-0300:00:00echo$dt->addDay();//-03-0400:00:00echo$dt->subDay();//-03-0300:00:00echo$dt->subDays(29);//-02-0300:00:00echo$dt->addWeekdays(4);//-02-0900:00:00echo$dt->addWeekday();//-02-1000:00:00echo$dt->subWeekday();//-02-0900:00:00echo$dt->subWeekdays(4);//-02-0300:00:00echo$dt->addWeeks(3);//-02-2400:00:00echo$dt->addWeek();//-03-0200:00:00echo$dt->subWeek();//-02-2400:00:00echo$dt->subWeeks(3);//-02-0300:00:00echo$dt->addHours(24);//-02-0400:00:00echo$dt->addHour();//-02-0401:00:00echo$dt->subHour();//-02-0400:00:00echo$dt->subHours(24);//-02-0300:00:00echo$dt->addMinutes(61);//-02-0301:01:00echo$dt->addMinute();//-02-0301:02:00echo$dt->subMinute();//-02-0301:01:00echo$dt->subMinutes(61);//-02-0300:00:00echo$dt->addSeconds(61);//-02-0300:01:01echo$dt->addSecond();//-02-0300:01:02echo$dt->subSecond();//-02-0300:01:01echo$dt->subSeconds(61);//-02-0300:00:00
人類閱讀時間格式<?phpuse Carbon\Carbon;//通常會用在留言的時間顯示//該時間會比較與現在的時間的差異echoCarbon::now()->subDays(5)->diffForHumans();//5daysagoechoCarbon::now()->diffForHumans(Carbon::now()->subYear());//1yearafter$dt=Carbon::createFromDate(,8,1);echo$dt->diffForHumans($dt->copy()->addMonth());//1monthbeforeecho$dt->diffForHumans($dt->copy()->subMonth());//1monthafterechoCarbon::now()->addSeconds(5)->diffForHumans();//5secondsfromnowechoCarbon::now()->subDays(24)->diffForHumans();//3weeksagoechoCarbon::now()->subDays(24)->diffForHumans(null,true);//3weeks
時間常數<?phpuse Carbon\Carbon;var_dump(Carbon::SUNDAY);//int(0)var_dump(Carbon::MONDAY);//int(1)var_dump(Carbon::TUESDAY);//int(2)var_dump(Carbon::WEDNESDAY);//int(3)var_dump(Carbon::THURSDAY);//int(4)var_dump(Carbon::FRIDAY);//int(5)var_dump(Carbon::SATURDAY);//int(6)var_dump(Carbon::YEARS_PER_CENTURY);//int(100)var_dump(Carbon::YEARS_PER_DECADE);//int(10)var_dump(Carbon::MONTHS_PER_YEAR);//int(12)var_dump(Carbon::WEEKS_PER_YEAR);//int(52)var_dump(Carbon::DAYS_PER_WEEK);//int(7)var_dump(Carbon::HOURS_PER_DAY);//int(24)var_dump(Carbon::MINUTES_PER_HOUR);//int(60)var_dump(Carbon::SECONDS_PER_MINUTE);//int(60)
參考資料
