Клас IntlDateFormatter
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)
Вступ
Це клас, який дозволяє форматувати/розбирати дати відповідно до налаштувань локалі, використовуючи рядкові та/або бібліотечні шаблони.
Клас надає функціональність форматування дат ICU. Він дозволяє користувачам відображати дати у форматі, прийнятому в їхній локалі. Або розбирати значення дат, використовуючи рядкові та/або бібліотечні шаблони.
Синопсис класу
class IntlDateFormatter
{
/* Константы */
public
const
int
FULL;
public
const
int
LONG;
public
const
int
MEDIUM;
public
const
int
SHORT;
public
const
int
NONE;
public
const
int
RELATIVE_FULL;
public
const
int
RELATIVE_LONG;
public
const
int
RELATIVE_MEDIUM;
public
const
int
RELATIVE_SHORT;
public
const
int
GREGORIAN;
public
const
int
TRADITIONAL;
/* Методы */
public __construct( ?string $locale, int $dateType = IntlDateFormatter::FULL, int $timeType = IntlDateFormatter::FULL, IntlTimeZone|DateTimeZone|string|null $timezone = null, IntlCalendar|int|null $calendar = null, ?string $pattern = null)
public static create( ?string $locale, int $dateType = IntlDateFormatter::FULL, int $timeType = IntlDateFormatter::FULL, IntlTimeZone|DateTimeZone|string|null $timezone = null, IntlCalendar|int|null $calendar = null, ?string $pattern = null): ?IntlDateFormatter
public format(IntlCalendar|DateTimeInterface|array|string|int|float $datetime): string|false
public static formatObject(IntlCalendar|DateTimeInterface $datetime, array|int|string|null $format = null, ?string $locale = null): string|false
public getCalendar(): int|false
public getDateType(): int|false
public getErrorCode(): int
public getErrorMessage(): string
public getLocale(int $type = ULOC_ACTUAL_LOCALE): string|false
public getPattern(): string|false
public getTimeType(): int|false
public getTimeZoneId(): string|false
public getCalendarObject(): IntlCalendar|false|null
public getTimeZone(): IntlTimeZone|false
public isLenient(): bool
public localtime(string $string, int &$offset = null): array|false
public parse(string $string, int &$offset = null): int|float|false
public setCalendar(IntlCalendar|int|null $calendar): bool
public setLenient(bool $lenient): void
public setPattern(string $pattern): bool
public setTimeZone(IntlTimeZone|DateTimeZone|string|null $timezone): bool
}
Дивіться також
Обумовлені константи
Ці константи використовуються для завдання формату в конструкторах DateType та TimeType.
IntlDateFormatter::NONE
Не вмикати цей елемент
IntlDateFormatter::FULL
Повний формат (Tuesday, April 12, 1952 AD or 3:30:42pm PST)
IntlDateFormatter::LONG
Довгий формат (January 12, 1952 or 3:30:32pm)
IntlDateFormatter::MEDIUM
Середній формат (Jan 12, 1952)
IntlDateFormatter::SHORT
Найбільш скорочений формат, тільки найнеобхідніші дані (12/13/52 або 3:30pm)
IntlDateFormatter::RELATIVE_FULL
Те саме, що і IntlDateFormatter::FULL
, але "вчора", "сьогодні" та "завтра" виводяться як yesterday
today
иtomorrow
. Доступно з PHP 8.0.0 тільки для dateType
IntlDateFormatter::RELATIVE_LONG
Те саме, що і IntlDateFormatter::LONG
, але "вчора", "сьогодні" та "завтра" виводяться як yesterday
today
иtomorrow
. Доступно з PHP 8.0.0 тільки для dateType
IntlDateFormatter::RELATIVE_MEDIUM
Те саме, що і IntlDateFormatter::MEDIUM
, але "вчора", "сьогодні" та "завтра" виводяться як yesterday
today
иtomorrow
. Доступно з PHP 8.0.0 тільки для dateType
IntlDateFormatter::RELATIVE_SHORT
Те саме, що і IntlDateFormatter::SHORT
, але "вчора", "сьогодні" та "завтра" виводяться як yesterday
today
иtomorrow
. Доступно з PHP 8.0.0 тільки для dateType
Наступні константи використовуються для визначення типу календаря. Ці календарі зав'язані прямо на Григоріанський календар. Не Григоріанський календар має бути заданий у локалі. Наприклад, locale="hi@calendar=BUDDHIST".
IntlDateFormatter::TRADITIONAL
Чи не Григоріанський календар
IntlDateFormatter::GREGORIAN
Григоріанський календар
Зміст
- IntlDateFormatter::create— Створює засіб форматування дати
- IntlDateFormatter::format— Форматує значення дати/часу у вигляді рядка
- IntlDateFormatter::formatObject - Форматує об'єкт
- IntlDateFormatter::getCalendar— Отримує тип календаря для об'єкта IntlDateFormatter
- IntlDateFormatter::getDateType— Отримує тип дати, який використовується IntlDateFormatter
- IntlDateFormatter::getErrorCode— Отримує код помилки останньої операції
- IntlDateFormatter::getErrorMessage— Отримує текст помилки останньої операції
- IntlDateFormatter::getLocale— Отримує мовний стандарт, який використовується засобом форматування
- IntlDateFormatter::getPattern— Отримує шаблон, який використовується IntlDateFormatter
- IntlDateFormatter::getTimeType— Отримує тип часу, який використовується IntlDateFormatter
- IntlDateFormatter::getTimeZoneId— Отримує ідентифікатор часового поясу, який використовується IntlDateFormatter
- IntlDateFormatter::getCalendarObject— Отримує копію об'єкта календаря засобу форматування
- IntlDateFormatter::getTimeZone— Отримує часовий пояс засобу форматування
- IntlDateFormatter::isLenient— Отримує поблажливість, яка використовується для IntlDateFormatter
- IntlDateFormatter::localtime— Перетворює рядок на значення часу на основі поля
- IntlDateFormatter::parse— Перетворює рядок на значення позначки часу
- IntlDateFormatter::setCalendar— Встановлює тип календаря за допомогою форматування.
- IntlDateFormatter::setLenient - Встановлює м'який режим аналізатора
- IntlDateFormatter::setPattern— Встановлює шаблон, який використовується IntlDateFormatter
- IntlDateFormatter::setTimeZone— Встановлює часовий пояс засобу форматування