Класс IntlCalendar

(PHP 5.5.0, PHP 7, PECL >= 3.0.0a1)

Введение

Обзор классов

IntlCalendar {

/* Constants */

const integer FIELD_ERA = 0 ;

const integer FIELD_YEAR = 1 ;

const integer FIELD_MONTH = 2 ;

const integer FIELD_WEEK_OF_YEAR = 3 ;

const integer FIELD_WEEK_OF_MONTH = 4 ;

const integer FIELD_DATE = 5 ;

const integer FIELD_DAY_OF_YEAR = 6 ;

const integer FIELD_DAY_OF_WEEK = 7 ;

const integer FIELD_DAY_OF_WEEK_IN_MONTH = 8 ;

const integer FIELD_AM_PM = 9 ;

const integer FIELD_HOUR = 10 ;

const integer FIELD_HOUR_OF_DAY = 11 ;

const integer FIELD_MINUTE = 12 ;

const integer FIELD_SECOND = 13 ;

const integer FIELD_MILLISECOND = 14 ;

const integer FIELD_ZONE_OFFSET = 15 ;

const integer FIELD_DST_OFFSET = 16 ;

const integer FIELD_YEAR_WOY = 17 ;

const integer FIELD_DOW_LOCAL = 18 ;

const integer FIELD_EXTENDED_YEAR = 19 ;

const integer FIELD_JULIAN_DAY = 20 ;

const integer FIELD_MILLISECONDS_IN_DAY = 21 ;

const integer FIELD_IS_LEAP_MONTH = 22 ;

const integer FIELD_FIELD_COUNT = 23 ;

const integer FIELD_DAY_OF_MONTH = 5 ;

const integer DOW_SUNDAY = 1 ;

const integer DOW_MONDAY = 2 ;

const integer DOW_TUESDAY = 3 ;

const integer DOW_WEDNESDAY = 4 ;

const integer DOW_THURSDAY = 5 ;

const integer DOW_FRIDAY = 6 ;

const integer DOW_SATURDAY = 7 ;

const integer DOW_TYPE_WEEKDAY = 0 ;

const integer DOW_TYPE_WEEKEND = 1 ;

const integer DOW_TYPE_WEEKEND_OFFSET = 2 ;

const integer DOW_TYPE_WEEKEND_CEASE = 3 ;

const integer WALLTIME_FIRST = 1 ;

const integer WALLTIME_LAST = 0 ;

const integer WALLTIME_NEXT_VALID = 2 ;

/* Методы */

public bool add ( int $field , int $amount )

bool intlcal_add ( IntlCalendar $cal , int $field , int $amount )

public bool after ( IntlCalendar $other )

bool intlcal_after ( IntlCalendar $cal , IntlCalendar $other )

public bool before ( IntlCalendar $other )

bool intlcal_before ( IntlCalendar $cal , IntlCalendar $other )

public bool clear ([ int $field = NULL ] )

bool intlcal_clear ( IntlCalendar $cal [, int $field = NULL ] )

private __construct ( void )

public static IntlCalendar createInstance ([ mixed $timeZone = NULL [, string $locale = "" ]] )

IntlCalendar intlcal_create_instance ([ mixed $timeZone = NULL [, string $locale = "" ]] )

public bool equals ( IntlCalendar $other )

bool intlcal_equals ( IntlCalendar $cal , IntlCalendar $other )

public int fieldDifference ( float $when , int $field )

int intlcal_field_difference ( IntlCalendar $cal , float $when , int $field )

public static IntlCalendar fromDateTime ( mixed $dateTime )

IntlCalendar intlcal_from_date_time ( mixed $dateTime )

public int get ( int $field )

int intlcal_get ( IntlCalendar> $cal , int $field )

public int getActualMaximum ( int $field )

int intlcal_get_actual_maximum ( IntlCalendar $cal , int $field )

public int getActualMinimum ( int $field )

int intlcal_get_actual_minimum ( IntlCalendar $cal , int $field )

public static array getAvailableLocales ( void )

array intlcal_get_available_locales ( void )

public int getDayOfWeekType ( int $dayOfWeek )

int intlcal_get_day_of_week_type ( IntlCalendar $cal , int $dayOfWeek )

public int getErrorCode ( void )

public string getErrorMessage ( void )

public int getFirstDayOfWeek ( void )

int intlcal_get_first_day_of_week ( IntlCalendar $cal )

public int getGreatestMinimum ( int $field )

int intlcal_get_greatest_minimum ( IntlCalendar $cal , int $field )

public static Iterator getKeywordValuesForLocale ( string $key , string $locale , boolean $commonlyUsed )

Iterator intlcal_get_keyword_values_for_locale ( string $key , string $locale , boolean $commonlyUsed )

public int getLeastMaximum ( int $field )

int intlcal_get_least_maximum ( IntlCalendar $cal , int $field )

public string getLocale ( int $localeType )

string intlcal_get_locale ( IntlCalendar $cal , int $localeType )

public int getMaximum ( int $field )

int intlcal_get_maximum ( IntlCalendar $cal , int $field )

public int getMinimalDaysInFirstWeek ( void )

int intlcal_get_minimal_days_in_first_week ( IntlCalendar $cal )

public int getMinimum ( int $field )

int intlcal_get_minimum ( IntlCalendar $cal , int $field )

public static float getNow ( void )

float intlcal_get_now ( void )

public int getRepeatedWallTimeOption ( void )

int intlcal_get_repeated_wall_time_option ( IntlCalendar $cal )

public int getSkippedWallTimeOption ( void )

int intlcal_get_skipped_wall_time_option ( IntlCalendar $cal )

public float getTime ( void )

float intlcal_get_time ( IntlCalendar $cal )

public IntlTimeZone getTimeZone ( void )

IntlTimeZone intlcal_get_time_zone ( IntlCalendar $cal )

public string getType ( void )

string intlcal_get_type ( IntlCalendar $cal )

public int getWeekendTransition ( string $dayOfWeek )

int intlcal_get_weekend_transition ( IntlCalendar $cal , string $dayOfWeek )

public bool inDaylightTime ( void )

bool intlcal_in_daylight_time ( IntlCalendar $cal )

public bool isEquivalentTo ( IntlCalendar $other )

bool intlcal_is_equivalent_to ( IntlCalendar $cal , IntlCalendar $other )

public bool isLenient ( void )

bool intlcal_is_lenient ( IntlCalendar $cal )

public bool isSet ( int $field )

bool intlcal_is_set ( IntlCalendar $cal , int $field )

public bool isWeekend ([ float $date = NULL ] )

bool intlcal_is_weekend ( IntlCalendar $cal [, float $date = NULL ] )

public bool roll ( int $field , mixed $amountOrUpOrDown )

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

public bool set ( int $field , int $value )

public bool set ( int $year , int $month [, int $dayOfMonth = NULL [, int $hour = NULL [, int $minute = NULL [, int $second = NULL ]]]] )

bool intlcal_set ( IntlCalendar $cal , int $field , int $value )

bool intlcal_set ( IntlCalendar $cal , int $year , int $month [, int $dayOfMonth = NULL [, int $hour = NULL [, int $minute = NULL [, int $second = NULL ]]]] )

public bool setFirstDayOfWeek ( int $dayOfWeek )

bool intlcal_set_first_day_of_week ( IntlCalendar $cal , int $dayOfWeek )

public ReturnType setLenient ( string $isLenient )

ReturnType intlcal_set_lenient ( IntlCalendar $cal , string $isLenient )

public bool setMinimalDaysInFirstWeek ( int $minimalDays )

bool intlcal_get_minimal_days_in_first_week ( IntlCalendar $cal , int $minimalDays )

public bool setRepeatedWallTimeOption ( int $wallTimeOption )

bool intlcal_set_repeated_wall_time_option ( IntlCalendar $cal , int $wallTimeOption )

public bool setSkippedWallTimeOption ( int $wallTimeOption )

bool intlcal_set_skipped_wall_time_option ( IntlCalendar $cal , int $wallTimeOption )

public bool setTime ( float $date )

bool intlcal_set_time ( IntlCalendar $cal , float $date )

public bool setTimeZone ( mixed $timeZone )

bool intlcal_set_time_zone ( IntlCalendar $cal , mixed $timeZone )

public DateTime toDateTime ( void )

DateTime intlcal_to_date_time ( IntlCalendar $cal )

}

Предопределенные константы

IntlCalendar::FIELD_ERA

Поле календаря численно представляет эпоху, например 1 для "от рождества Христова" и 0 для "до рождества Христова" в Грирогианском и Юлианском календарях и 235 для периода Хэйсэй (平成) в Японском календаре. Не все календари имеют больше одной эпохи.

IntlCalendar::FIELD_YEAR

Поле календаря для года. Не уникально в контексте нескольких эпох. Если календарь содержит более одной эры, то, обычно, минимальное значение этого поля равно 1.

IntlCalendar::FIELD_MONTH

Поле календаря для месяца. Последовательность месяцев начинается с нуля, следовательно Janurary (Январь) (здесь используется для обозначения первого месяца года, но по факту может быть совсем другое имя, например Muharram для Исламского календаря) будет представлен числом 0, February (Февраль) числом 1, …, December (Декабрь) числом 11 и, для некоторых календарей, 13й или високосный месяц, значение будет равно 12.

IntlCalendar::FIELD_WEEK_OF_YEAR

Поле календаря для номера недели в году. Зависит от того, с какого дня начинается неделя и минимального количества дней в неделе.

IntlCalendar::FIELD_WEEK_OF_MONTH

Поле календаря для номера недели в месяце. Зависит от того, с какого дня начинается неделя и минимального количества дней в неделе.

IntlCalendar::FIELD_DATE

Поле календаря для номера дня в месяце. То же самое, что и IntlCalendar::FIELD_DAY_OF_MONTH.

IntlCalendar::FIELD_DAY_OF_YEAR

Поле календаря для номера дня в году. Для Грегорианского календаря находится в диапазоне от 1 до 365 или 366.

IntlCalendar::FIELD_DAY_OF_WEEK

Поле календаря для номера дня в неделе. Начинается с 1 (Воскресенье, смотри IntlCalendar::DOW_SUNDAY и связанные константы) и заканчивается 7 (Суббота).

IntlCalendar::FIELD_DAY_OF_WEEK_IN_MONTH

Номер дня недели (Воскресенье, Понедельник, …) в месяце. Допустим это значение равно 1, а значение дня недели равно 2 (Понедельник), следовательно это первый понедельник месяца. Максимальное значение равно 5.

Также допустимы значения 0 и ниже (отрицательные). Значение 0 охватывает 7 дней непосредственно перед началом месяца (первый подходящий день в месяце имеет значение 1). Отрицательные значения отсчитываются от конца месяца. Так, значение -1 указывает на последний подходящий день месяца, -2 на второй с конца и т.д.

В отличие от IntlCalendar::FIELD_WEEK_OF_MONTH и IntlCalendar::FIELD_WEEK_OF_YEAR, это значение не зависит от IntlCalendar::getFirstDayOfWeek() и IntlCalendar::getMinimalDaysInFirstWeek(). Первая среда - это первая среда, даже если неделя началась в предыдущем месяце.

IntlCalendar::FIELD_AM_PM

Поле календаря определяющее время до/после полудня. Соответственно 0 - до полудня, (1) - после. Полночь считается как "до полудня", полдень как "после полудня".

IntlCalendar::FIELD_HOUR

Поле календаря для часов, без указания до или после полудня. Допустимы значения в интервале от 0 до 11.

IntlCalendar::FIELD_HOUR_OF_DAY

Поле календаня для полных (24-часовой формат) часов. Допустимы значения от 0 до 23.

IntlCalendar::FIELD_MINUTE

Поле календаря для минут.

IntlCalendar::FIELD_SECOND

Поле календаря для секунд.

IntlCalendar::FIELD_MILLISECOND

Поле календаря для миллисекунд.

IntlCalendar::FIELD_ZONE_OFFSET

Поле календаря для "сырого" смещения временной зона, в миллисекундах. "Сырое" смещение не учитывает переходы на летнее/зимнее время.

IntlCalendar::FIELD_DST_OFFSET

Поле календаря для смещения временной зоны в миллисекундах в зависимости от летнего/зимнего времени, если применимо к данной временной зоне.

IntlCalendar::FIELD_YEAR_WOY

Поле календаря представляющее год для недели года.

IntlCalendar::FIELD_DOW_LOCAL

Поле календаря для локализованного дня недели. Принимает значения в диапазоне от 1 до 7. 1 используется для дня недели соответствующего значению возвращаемому функцией IntlCalendar::getFirstDayOfWeek().

IntlCalendar::FIELD_EXTENDED_YEAR

Поле календаря для представления номера года в контексте обеспечения непрерывности между эпохами. Например, для Грегорианского календаря, это значение для эпохи "после рождества Христова" будет соответствовать IntlCalendar::FIELD_YEAR, а для эпохи "до рождества Христова", год y будет представлен как -y + 1.

IntlCalendar::FIELD_JULIAN_DAY

Поле календаря для модифицированых номеров дней Юлианского календаря. В отличии от стандартного Юлианского календаря, в нем переход происходит в полночь по локальному времени, а не в полдень по UTC. Он однозначно идентифицирует дату.

IntlCalendar::FIELD_MILLISECONDS_IN_DAY

Поле календаря, охватывающее IntlCalendar::FIELD_HOUR_OF_DAY, IntlCalendar::FIELD_MINUTE, IntlCalendar::FIELD_SECOND и IntlCalendar::FIELD_MILLISECOND. Находится в диапазоне от 0 до 24 * 3600 * 1000 - 1. Это не количество миллисекунд, прошедшее с полуночи, так как в моменты перехода на летнее/зимнее время будет иметь разрывы.

IntlCalendar::FIELD_IS_LEAP_MONTH

Поле календаря принимающее значение 1 для високосного месяца и 0 для обычного.

IntlCalendar::FIELD_FIELD_COUNT

Общее количество полей.

IntlCalendar::FIELD_DAY_OF_MONTH

Псевдоним для IntlCalendar::FIELD_DATE.

IntlCalendar::DOW_SUNDAY

Воскресенье.

IntlCalendar::DOW_MONDAY

Понедельник.

IntlCalendar::DOW_TUESDAY

Вторник.

IntlCalendar::DOW_WEDNESDAY

Среда.

IntlCalendar::DOW_THURSDAY

Четверг.

IntlCalendar::DOW_FRIDAY

Пятница.

IntlCalendar::DOW_SATURDAY

Суббота.

IntlCalendar::DOW_TYPE_WEEKDAY

Вывод IntlCalendar::getDayOfWeekType() означает, что день будний.

IntlCalendar::DOW_TYPE_WEEKEND

Вывод IntlCalendar::getDayOfWeekType() означает, что день выходной.

IntlCalendar::DOW_TYPE_WEEKEND_OFFSET

Вывод IntlCalendar::getDayOfWeekType() означает, что выходные начинаются в этот день.

IntlCalendar::DOW_TYPE_WEEKEND_CEASE

Вывод IntlCalendar::getDayOfWeekType() означает, что выходные заканчиваются в этот день.

IntlCalendar::WALLTIME_FIRST

Вывод IntlCalendar::getSkippedWallTimeOption() означает, что время в пропущеном диапазоне должно ссылаться на момент времени меньший на один час и вывод IntlCalendar::getRepeatedWallTimeOption() означает, что время в повторяемом диапазоне должно относиться к моменту первого появления такого времени.

IntlCalendar::WALLTIME_LAST

Вывод IntlCalendar::getSkippedWallTimeOption() означает, что время в пропущеном диапазоне должно ссылаться на момент времени больший на один час и вывод IntlCalendar::getRepeatedWallTimeOption() означает, что время в повторяемом диапазоне должно относиться к моменту второго появления такого времени.

IntlCalendar::WALLTIME_NEXT_VALID

Вывод IntlCalendar::getSkippedWallTimeOption() означает, что время в пропущеном диапазоне относится к моменту, когда случился переход на зимнее/летнее время.

Содержание

IntlCalendar::add — Add a (signed) amount of time to a field
IntlCalendar::after — Whether this objectʼs time is after that of the passed object
IntlCalendar::before — Whether this objectʼs time is before that of the passed object
IntlCalendar::clear — Clear a field or all fields
IntlCalendar::__construct — Private constructor for disallowing instantiation
IntlCalendar::createInstance — Create a new IntlCalendar
IntlCalendar::equals — Compare time of two IntlCalendar objects for equality
IntlCalendar::fieldDifference — Calculate difference between given time and this objectʼs time
IntlCalendar::fromDateTime — Create an IntlCalendar from a DateTime object or string
IntlCalendar::get — Get the value for a field
IntlCalendar::getActualMaximum — The maximum value for a field, considering the objectʼs current time
IntlCalendar::getActualMinimum — The minimum value for a field, considering the objectʼs current time
IntlCalendar::getAvailableLocales — Get array of locales for which there is data
IntlCalendar::getDayOfWeekType — Tell whether a day is a weekday, weekend or a day that has a transition between the two
IntlCalendar::getErrorCode — Get last error code on the object
IntlCalendar::getErrorMessage — Get last error message on the object
IntlCalendar::getFirstDayOfWeek — Get the first day of the week for the calendarʼs locale
IntlCalendar::getGreatestMinimum — Get the largest local minimum value for a field
IntlCalendar::getKeywordValuesForLocale — Get set of locale keyword values
IntlCalendar::getLeastMaximum — Get the smallest local maximum for a field
IntlCalendar::getLocale — Get the locale associated with the object
IntlCalendar::getMaximum — Get the global maximum value for a field
IntlCalendar::getMinimalDaysInFirstWeek — Get minimal number of days the first week in a year or month can have
IntlCalendar::getMinimum — Get the global minimum value for a field
IntlCalendar::getNow — Get number representing the current time
IntlCalendar::getRepeatedWallTimeOption — Get behavior for handling repeating wall time
IntlCalendar::getSkippedWallTimeOption — Get behavior for handling skipped wall time
IntlCalendar::getTime — Get time currently represented by the object
IntlCalendar::getTimeZone — Get the objectʼs timezone
IntlCalendar::getType — Get the calendar type
IntlCalendar::getWeekendTransition — Get time of the day at which weekend begins or ends
IntlCalendar::inDaylightTime — Whether the objectʼs time is in Daylight Savings Time
IntlCalendar::isEquivalentTo — Whether another calendar is equal but for a different time
IntlCalendar::isLenient — Whether date/time interpretation is in lenient mode
IntlCalendar::isSet — Whether a field is set
IntlCalendar::isWeekend — Whether a certain date/time is in the weekend
IntlCalendar::roll — Add value to field without carrying into more significant fields
IntlCalendar::set — Set a time field or several common fields at once
IntlCalendar::setFirstDayOfWeek — Set the day on which the week is deemed to start
IntlCalendar::setLenient — Set whether date/time interpretation is to be lenient
IntlCalendar::setMinimalDaysInFirstWeek — Set minimal number of days the first week in a year or month can have
IntlCalendar::setRepeatedWallTimeOption — Set behavior for handling repeating wall times at negative timezone offset transitions
IntlCalendar::setSkippedWallTimeOption — Set behavior for handling skipped wall times at positive timezone offset transitions
IntlCalendar::setTime — Set the calendar time in milliseconds since the epoch
IntlCalendar::setTimeZone — Set the timezone used by this calendar
IntlCalendar::toDateTime — Convert an IntlCalendar into a DateTime object