A classe IntlDateFormatter

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

    Introdução

    O formatador de datas é uma classe concreta que habilita formatação/interpretação dependetes de localidade de datas usando strings de padrões e/ou padrões já existentes.

    Esta classe representa a funcionalidade de formatação de datas da ICU. Permite aos usuários apresentar datas em formato dependente de localidade ou converter strings em valores de datas do PHP usando strings de padrões e/ou padrões já existentes.

    Resumo da classe

    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 PATTERN;
    public const int GREGORIAN;
    public const int TRADITIONAL;
    /* Métodos */
    public function __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 function 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 function format(IntlCalendar|DateTimeInterface|array|string|int|float $datetime): string|false
    public static function formatObject(IntlCalendar|DateTimeInterface $datetime, array|int|string|null $format = null, ?string $locale = null): string|false
    public function getCalendar(): int|false
    public function getDateType(): int|false
    public function getErrorCode(): int
    public function getErrorMessage(): string
    public function getLocale(int $type = ULOC_ACTUAL_LOCALE): string|false
    public function getPattern(): string|false
    public function getTimeType(): int|false
    public function getTimeZoneId(): string|false
    public function getCalendarObject(): IntlCalendar|false|null
    public function getTimeZone(): IntlTimeZone|false
    public function isLenient(): bool
    public function localtime(string $string, int &$offset = null): array|false
    public function parse(string $string, int &$offset = null): int|float|false
    public function setCalendar(IntlCalendar|int|null $calendar): bool
    public function setLenient(bool $lenient): void
    public function setPattern(string $pattern): bool
    public function setTimeZone(IntlTimeZone|DateTimeZone|string|null $timezone): bool
    }

    Registro de Alterações

    Versão Descrição
    8.4.0 Adicionada a constante IntlDateFormatter::PATTERN.

    Constantes predefinidas

    Estas constantes são usadas para especificar diferentes formatos nos construtores para DateType e TimeType.

    IntlDateFormatter::NONE int
    Não incluir este elemento
    IntlDateFormatter::FULL int
    Estilo completamente especificado (Tuesday, April 12, 1952 AD ou 3:30:42pm PST)
    IntlDateFormatter::LONG int
    Estilo longo (January 12, 1952 ou 3:30:32pm)
    IntlDateFormatter::MEDIUM int
    Estilo médio (Jan 12, 1952)
    IntlDateFormatter::SHORT int
    O estilo mais abreviado, apenas dados essenciais (12/13/52 ou 3:30pm)
    IntlDateFormatter::RELATIVE_FULL int
    O mesmo que IntlDateFormatter::FULL, porém ontem, hoje e amanhã são mostrados como yesterday, today, e tomorrow, respectivamente. Disponível a partir do PHP 8.0.0, somente para dateType.
    IntlDateFormatter::RELATIVE_LONG int
    O mesmo que IntlDateFormatter::LONG, porém ontem, hoje e amanhã são mostrados como yesterday, today, e tomorrow, respectivamente. Disponível a partir do PHP 8.0.0, somente para dateType.
    IntlDateFormatter::RELATIVE_MEDIUM int
    O mesmo que IntlDateFormatter::MEDIUM, porém ontem, hoje e amanhã são mostrados como yesterday, today, e tomorrow, respectivamente. Disponível a partir do PHP 8.0.0, somente para dateType.
    IntlDateFormatter::RELATIVE_SHORT int
    O mesmo que IntlDateFormatter::SHORT, porém ontem, hoje e amanhã são mostrados como yesterday, today, e tomorrow, respectivamente. Disponível a partir do PHP 8.0.0, somente para dateType.
    IntlDateFormatter::PATTERN int
    Usa o padrão informado em pattern. Disponível a partir do PHP 8.4.0.

    As constantes inteiras a seguir são usadas para especificar o calendário. Estes calendários são todos baseados diretamente no calendário gregoriano. Calendários não gregorianos precisam ser especificados na localidade. Exemplos podem incluir locale="hi@calendar=BUDDHIST".

    IntlDateFormatter::TRADITIONAL int
    Calendário Não Gregoriano
    IntlDateFormatter::GREGORIAN int
    Calendário Gregoriano

    Registro de Alterações

    Versão Descrição
    8.4.0 As constantes de classe agora são tipadas.

    Índice

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicionar nota

    Notas de Usuários

    Não há notas de usuários para esta página.
    To Top