Клас IntlCalendar
(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)
Вступ
Огляд класів
class IntlCalendar
{
/* Константы */
public
const
int
FIELD_ERA;
public
const
int
FIELD_YEAR;
public
const
int
FIELD_MONTH;
public
const
int
FIELD_WEEK_OF_YEAR;
public
const
int
FIELD_WEEK_OF_MONTH;
public
const
int
FIELD_DATE;
public
const
int
FIELD_DAY_OF_YEAR;
public
const
int
FIELD_DAY_OF_WEEK;
public
const
int
FIELD_DAY_OF_WEEK_IN_MONTH;
public
const
int
FIELD_AM_PM;
public
const
int
FIELD_HOUR;
public
const
int
FIELD_HOUR_OF_DAY;
public
const
int
FIELD_MINUTE;
public
const
int
FIELD_SECOND;
public
const
int
FIELD_MILLISECOND;
public
const
int
FIELD_ZONE_OFFSET;
public
const
int
FIELD_DST_OFFSET;
public
const
int
FIELD_YEAR_WOY;
public
const
int
FIELD_DOW_LOCAL;
public
const
int
FIELD_EXTENDED_YEAR;
public
const
int
FIELD_JULIAN_DAY;
public
const
int
FIELD_MILLISECONDS_IN_DAY;
public
const
int
FIELD_IS_LEAP_MONTH;
public
const
int
FIELD_FIELD_COUNT;
public
const
int
FIELD_DAY_OF_MONTH;
public
const
int
DOW_SUNDAY;
public
const
int
DOW_MONDAY;
public
const
int
DOW_TUESDAY;
public
const
int
DOW_WEDNESDAY;
public
const
int
DOW_THURSDAY;
public
const
int
DOW_FRIDAY;
public
const
int
DOW_SATURDAY;
public
const
int
DOW_TYPE_WEEKDAY;
public
const
int
DOW_TYPE_WEEKEND;
public
const
int
DOW_TYPE_WEEKEND_OFFSET;
public
const
int
DOW_TYPE_WEEKEND_CEASE;
public
const
int
WALLTIME_FIRST;
public
const
int
WALLTIME_LAST;
public
const
int
WALLTIME_NEXT_VALID;
/* Методы */
private __construct()
public add(int $field, int $value): bool
public after(IntlCalendar $other): bool
public before(IntlCalendar $other): bool
public clear(?int $field = null): true
public static createInstance(IntlTimeZone|DateTimeZone|string|null $timezone = null, ?string $locale = null): ?IntlCalendar
public equals(IntlCalendar $other): bool
public fieldDifference(float $timestamp, int $field): int|false
public static fromDateTime(DateTime|string $datetime, ?string $locale = null): ?IntlCalendar
public get(int $field): int|false
public getActualMaximum(int $field): int|false
public getActualMinimum(int $field): int|false
public static getAvailableLocales(): array
public getDayOfWeekType(int $dayOfWeek): int|false
public getErrorCode(): int|false
public getErrorMessage(): string|false
public getFirstDayOfWeek(): int|false
public getGreatestMinimum(int $field): int|false
public static getKeywordValuesForLocale(string $keyword, string $locale, bool $onlyCommon): IntlIterator|false
public getLeastMaximum(int $field): int|false
public getLocale(int $type): string|false
public getMaximum(int $field): int|false
public getMinimalDaysInFirstWeek(): int|false
public getMinimum(int $field): int|false
public static getNow(): float
public getRepeatedWallTimeOption(): int
public getSkippedWallTimeOption(): int
public getTime(): float|false
public getTimeZone(): IntlTimeZone|false
public getType(): string
public getWeekendTransition(int $dayOfWeek): int|false
public inDaylightTime(): bool
public isEquivalentTo(IntlCalendar $other): bool
public isLenient(): bool
public isSet(int $field): bool
public isWeekend(?float $timestamp = null): bool
public roll(int $field, int|bool $value): bool
public set(int $field, int $value): true
public set( int $year, int $month, int $dayOfMonth = NULL, int $hour = NULL, int $minute = NULL, int $second = NULL): true
public setDate(int $year, int $month, int $dayOfMonth): void
public setDateTime( int $year, int $month, int $dayOfMonth, int $hour, int $minute, int $second = null): void
public setFirstDayOfWeek(int $dayOfWeek): true
public setLenient(bool $lenient): true
public setMinimalDaysInFirstWeek(int $days): true
public setRepeatedWallTimeOption(int $option): true
public setSkippedWallTimeOption(int $option): true
public setTime(float $timestamp): bool
public setTimeZone(IntlTimeZone|DateTimeZone|string|null $timezone): bool
public toDateTime(): DateTime|false
}
Обумовлені константи
IntlCalendar::FIELD_ERA
Поле календаря чисельно представляє епоху, наприклад для "від Різдва Христового" та для "до Різдва Христового" у Григоріанському та Юліанському календарях та 235
для періоду Хейсей в Японському календарі. Не всі календарі мають більше за одну епоху.
IntlCalendar::FIELD_YEAR
Поле календар для року. Не унікально у тих кількох епох. Якщо календар містить більше однієї ери, то, як правило, мінімальне значення цього поля дорівнює
IntlCalendar::FIELD_MONTH
Поле календар для місяця. Послідовність місяців починається з нуля, отже Janurary (Січень) (тут використовується для позначення першого місяця року, але за фактом може бути зовсім інше ім'я, наприклад Muharram для Ісламського календаря) буде представлено числом , February (Февраль) числом , …, 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
Поле календар для номера дня в році. Для Грегоріанського календаря знаходиться в діапазоні від до**365
** або **366
**
IntlCalendar::FIELD_DAY_OF_WEEK
Поле календаря для номера дня тижня. Починається з (Воскресенье, смотриIntlCalendar::DOW_SUNDAY
і пов'язані константи) і закінчується 7 (субота).
IntlCalendar::FIELD_DAY_OF_WEEK_IN_MONTH
Номер дня тижня (Неділя, Понеділок, …) на місяць. Допустимо це значення одно , а значення дня тижня рівне (Понеділок), отже, це перший понеділок місяця. Максимальне значення дорівнює 5
Також допустимі значення та нижче (негативні). Значення охоплює 7 днів безпосередньо перед початком місяця (перший відповідний день у місяці має значення ). Негативні значення відраховуються від кінця місяця. Так, значення -1
вказує на останній відповідний день місяця, -2
на другий з кінця і т.д.
В отличие отIntlCalendar::FIELD_WEEK_OF_MONTH
і IntlCalendar::FIELD_WEEK_OF_YEAR
, це значення не залежить від IntlCalendar::getFirstDayOfWeek() і IntlCalendar::getMinimalDaysInFirstWeek(). Перше середовище - це перше середовище, навіть якщо тиждень розпочався попереднього місяця.
IntlCalendar::FIELD_AM_PM
Поле календаря определяющее время до/после полудня. Соответственно - до полудня, ( ) - після. Північ вважається як "до полудня", опівдні як "після полудня".
IntlCalendar::FIELD_HOUR
Поле календаря для годинника, без вказівки до або після полудня. Допустимі значення в інтервалі від до11
IntlCalendar::FIELD_HOUR_OF_DAY
Поле календаря для повного (24-годинного формату) годинника. Допустимі значення від до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
Поле календар для локалізованого дня тижня. Приймає значення в діапазоні від до7
. . використовується для дня тижня відповідного значення повертається функцією 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
**Находится в диапазоне от до24 * 3600 * 1000 - 1
. Це не кількість мілісекунд, що минула з півночі, тому що в моменти переходу на літній/зимовий час матиме розриви.
IntlCalendar::FIELD_IS_LEAP_MONTH
Поле календаря принимающее значение для високосного месяца и для звичайного.
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 - Додає кількість (зі знаком) часу в полі
- IntlCalendar::after - Визначає, час цього об'єкта пізніше часу переданого об'єкта
- IntlCalendar::before— Визначає, час цього об'єкта раніше переданого об'єкта
- IntlCalendar::clear— Очищає поле чи всі поля
- IntlCalendar::__construct— Закритий конструктор для заборони створення екземплярів
- IntlCalendar::createInstance— Створює новий об'єкт IntlCalendar
- IntlCalendar::equals— Порівнює час двох об'єктів IntlCalendar щодо рівності
- IntlCalendar::fieldDifference— Обчислює різницю між заданим часом та часом об'єкта
- IntlCalendar::fromDateTime— Створює IntlCalendar з об'єкта чи рядка DateTime
- IntlCalendar::get— Отримує значення поля
- IntlCalendar::getActualMaximum— Максимальне значення для поля з урахуванням поточного часу об'єкта
- IntlCalendar::getActualMinimum— Мінімальне значення для поля з урахуванням поточного часу об'єкта
- IntlCalendar::getAvailableLocales— Отримує масив мовних стандартів, для яких є дані
- IntlCalendar::getDayOfWeekType— Повідомляє, чи є день буднім, вихідним чи днем із переходом між ними
- IntlCalendar::getErrorCode— Отримує останній код помилки об'єкта
- IntlCalendar::getErrorMessage— Отримує останнє повідомлення про помилку об'єкта
- IntlCalendar::getFirstDayOfWeek— отримує перший день тижня для мовного стандарту календаря
- IntlCalendar::getGreatestMinimum— Отримує найбільше локальне мінімальне значення поля
- IntlCalendar::getKeywordValuesForLocale— Набір значень ключових слів мовного стандарту
- IntlCalendar::getLeastMaximum— Отримує найменший локальний максимум для поля
- IntlCalendar::getLocale— Отримує мовний стандарт, пов'язаний із об'єктом
- IntlCalendar::getMaximum— Отримує глобальне максимальне значення поля
- IntlCalendar::getMinimalDaysInFirstWeek— Отримує мінімальну кількість днів, яка може бути у першому тижні на рік чи місяць
- IntlCalendar::getMinimum— Отримує глобальне мінімальне значення поля
- IntlCalendar::getNow— Отримує число, що становить поточний час
- IntlCalendar::getRepeatedWallTimeOption— Отримує поведінку для обробки часу процесора, що повторюється.
- IntlCalendar::getSkippedWallTimeOption— Отримує поведінку для обробки пропущеного часу процесора
- IntlCalendar::getTime— Отримує час, представлений на даний момент об'єктом
- IntlCalendar::getTimeZone— Отримує часовий пояс об'єкту
- IntlCalendar::getType— Отримує тип календаря
- IntlCalendar::getWeekendTransition— Отримує час, коли вихідні починаються або закінчуються.
- IntlCalendar::inDaylightTime— Визначає, чи час об'єкта переходить на літній час.
- IntlCalendar::isEquivalentTo— Визначає, чи дорівнює інший календар, але для іншого часу
- IntlCalendar::isLenient— Визначає, чи інтерпретація дати/часу є м'якою.
- IntlCalendar::isSet— Визначає, чи встановлено поле
- IntlCalendar::isWeekend— Визначає, чи доводиться певна дата/час на вихідні
- IntlCalendar::roll— Додає значення в поле без перенесення до найважливіших полів
- IntlCalendar::set— Встановлює поле часу або одразу кілька спільних полів
- IntlCalendar::setDate - Встановлює поля дати
- IntlCalendar::setDateTime— Встановлює поля дати та часу
- IntlCalendar::setFirstDayOfWeek— Встановлює день, який є початком тижня
- IntlCalendar::setLenient— Встановлює, чи інтерпретація дати/часу повинна бути м'якою.
- IntlCalendar::setMinimalDaysInFirstWeek— Встановлює мінімальну кількість днів, яка може бути у першому тижні на рік чи місяць
- IntlCalendar::setRepeatedWallTimeOption— Встановлює поведінку для обробки часу процесора, що повторюється, при негативних переходах зміщення часового поясу.
- IntlCalendar::setSkippedWallTimeOption— Встановлює поведінку для обробки пропущеного часу процесора при позитивних переходах усунення часового поясу
- IntlCalendar::setTime— Встановлює календарний час у мілісекундах від початку епохи Unix
- IntlCalendar::setTimeZone— Встановлює часовий пояс, який використовується календарем.
- IntlCalendar::toDateTime— Перетворює об'єкт IntlCalendar на об'єкт DateTime