PHP IntlCalendar roll()用法及代碼示例

IntlCalendar::roll()函數是PHP中的內置函數，用於在不增加更重要字段的情況下為字段增加值。 IntlCalendar::roll(函數與IntlCalendar::add(函數之間的區別是IntlCalendar::roll(函數的字段值溢出，不會影響到更重要的字段。

用法:

• 麵向對象的風格

  bool IntlCalendar::roll( int $field, mixed $amountOrUpOrDown )

• 程序風格

  bool intlcal_roll( IntlCalendar $cal, int $field, mixed $amountOrUpOrDown )

參數：

• $cal:此參數保存IntlCalendar對象的資源。
• $field:此參數保存IntlCalendar日期/時間字段常量之一。字段常量的值是整數，介於0到IntlCalendar::FIELD_COUNT之間。
• $amountOrUpOrDown:此參數保存要添加到該字段的簽名數量。 TRUE值表示向上滾動(加1)，而FALSE值表示向下滾動(減1)。

返回值：如果成功，則此函數返回TRUE；如果失敗，則返回FALSE。

以下示例程序旨在說明PHP中的IntlCalendar::roll()函數：

程序：

<?php 
  
// Set the DateTime zone 
ini_set('date.timezone', 'Asia/Calcutta'); 
  
// Create an instance of IntlCalendar 
$calendar = IntlCalendar::createInstance('Asia/Calcutta'); 
  
// Set the DateTime to the calendar object 
$calendar->set(2019, 8, 24); 
  
// Display the calendar object 
var_dump(IntlDateFormatter::formatObject($calendar)); 
  
// Roll down 1 day of date field 
$calendar->roll(IntlCalendar::FIELD_DAY_OF_MONTH, false); 
  
// Display the calendar object 
var_dump(IntlDateFormatter::formatObject($calendar)); 
  
?>

string(24) "Sep 24, 2019, 8:29:48 AM"
string(24) "Sep 23, 2019, 8:29:48 AM"

參考： https://www.php.net/manual/en/intlcalendar.roll.php