array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'class.intldateformatter.php', 1 => 'IntlDateFormatter', 2 => 'La clase IntlDateFormatter', ), 'up' => array ( 0 => 'book.intl.php', 1 => 'intl', ), 'prev' => array ( 0 => 'intltimezone.usedaylighttime.php', 1 => 'IntlTimeZone::useDaylightTime', ), 'next' => array ( 0 => 'intldateformatter.create.php', 1 => 'IntlDateFormatter::create', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/intl/dateformatter.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.intldateformatter.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 PATTERN;
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
}

Historial de cambios

Versión Descripción
8.4.0 Se añadió IntlDateFormatter::PATTERN.

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.
IntlDateFormatter::PATTERN int
Utiliza el patrón dado en pattern. Disponible a partir de PHP 8.4.0.

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