IntlCalendar::fieldDifference
(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)
IntlCalendar::fieldDifference — Обчислює різницю між заданим часом та часом об'єкта
Опис
Об'єктно-орієнтований стиль
public IntlCalendar::fieldDifference(float $timestamp, int $field): int|false
Процедурний стиль
intlcal_field_difference(IntlCalendar $calendar, float $timestamp, int $field): int|false
Повертає різницю між заданим часом та часом, встановленим для об'єкта, щодо кількості, зазначеної у параметрі field
Метод призначений для послідовного виклику, в першу чергу від найбільш значущою областю інтересів до найменш значущої області. Як побічний ефект, значення календаря для вказаного поля збільшується на повернену суму.
Список параметрів
calendar
Екземпляр IntlCalendar
timestamp
Час, з яким порівнюється кількість, представлена field. Щоб результат був позитивним, час, вказаний у цьому параметрі, повинен випереджати час об'єкта, якого викликається метод.
field
Поле, що становить кількість, що порівнюється.
Одна з представлених у класі IntlCalendar константполей типа дата/время. Целое число от до**IntlCalendar::FIELD_COUNT**
Значення, що повертаються
Повертає різницю часу (зі знаком) в одиницях виміру, пов'язаних із зазначеним полем або **false**в случае возникновения ошибки.
Приклади
Приклад #1 Приклад використання IntlCalendar::fieldDifference()****
Результат виконання наведеного прикладу:
Время до: 29 févr. 2012 09:00:11
Разница во времени: 1 год(лет), 0 месяц(ев), 1 день(дней), 0 час(ов) and 19 минуту(минут)
Время после: 1 mars 2013 09:19:11