La clase IntlDateFormatter

    (PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

    Introducción

    La clase DateFormatter es una clase concreta, que activa el análisis y el formato de fechas, basado en cadenas modelo, o reglas.

    Esta clase representa las funcionalidades de formato de fechas ICU. Permite a los usuarios mostrar fechas en un formato localizado, o analizar cadenas PHP para extraer fechas.

    Sinopsis de la clase

    class IntlDateFormatter {
    /* Constantes */
    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;
    /* Métodos */
    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
    }

    Constantes predefinidas

    Estas constantes se utilizan para especificar diferentes formatos en el constructor de las clases DateType y TimeType.

    IntlDateFormatter::NONE int
    No incluye este elemento
    IntlDateFormatter::FULL int
    Estilo completamente especificado (Tuesday, April 12, 1952 AD or 3:30:42pm PST)
    IntlDateFormatter::LONG int
    Estilo largo (January 12, 1952 or 3:30:32pm)
    IntlDateFormatter::MEDIUM int
    Estilo intermedio (Jan 12, 1952)
    IntlDateFormatter::SHORT int
    Estilo abreviado, solo la información esencial (12/13/52 o 3:30pm)
    IntlDateFormatter::RELATIVE_FULL int
    Idéntico a IntlDateFormatter::FULL, pero ayer, hoy, y mañana se muestran como yesterday, today, y tomorrow, respectivamente. Disponible a partir de PHP 8.0.0, para dateType únicamente.
    IntlDateFormatter::RELATIVE_LONG int
    Idéntico a IntlDateFormatter::LONG, pero ayer, hoy, y mañana se muestran como yesterday, today, y tomorrow, respectivamente. Disponible a partir de PHP 8.0.0, para dateType únicamente.
    IntlDateFormatter::RELATIVE_MEDIUM int
    Idéntico a IntlDateFormatter::MEDIUM, pero ayer, hoy, y mañana se muestran como yesterday, today, y tomorrow, respectivamente. Disponible a partir de PHP 8.0.0, para dateType únicamente.
    IntlDateFormatter::RELATIVE_SHORT int
    Idéntico a IntlDateFormatter::SHORT, pero ayer, hoy, y mañana se muestran como yesterday, today, y tomorrow, respectivamente. Disponible a partir de PHP 8.0.0, para dateType únicamente.

    Las constantes enteras siguientes se utilizan para especificar calendarios. Estos calendarios se basan directamente en el calendario gregoriano. Los calendarios no gregorianos deben especificarse en una configuración local. Los ejemplos pueden incluir locale="hi@calendar=BUDDHIST".

    IntlDateFormatter::TRADITIONAL int
    Calendario no gregoriano
    IntlDateFormatter::GREGORIAN int
    Calendario gregoriano

    Historial de cambios

    Versión Descripción
    8.4.0 Las constantes de clase ahora están tipadas.

    Tabla de contenidos

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top