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 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

}

Ver también

» Formateador de fechas ICU

» Formatos de fechas ICU

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

IntlDateFormatter::create — Crea un formateador de fecha
IntlDateFormatter::format — Formatea la fecha y la hora como string
IntlDateFormatter::formatObject — Formatea un objeto
IntlDateFormatter::getCalendar — Lee el calendario utilizado por el objeto IntlDateFormatter
IntlDateFormatter::getDateType — Lee el tipo de fecha utilizado por IntlDateFormatter
IntlDateFormatter::getErrorCode — Lee el código de error de la última operación
IntlDateFormatter::getErrorMessage — Lee el último mensaje de error
IntlDateFormatter::getLocale — Lee la configuración local utilizada por el formateador
IntlDateFormatter::getPattern — Lee el patrón utilizado por IntlDateFormatter
IntlDateFormatter::getTimeType — Lee el tipo de tiempo para IntlDateFormatter
IntlDateFormatter::getTimeZoneId — Lee el huso horario de IntlDateFormatter
IntlDateFormatter::getCalendarObject — Obtiene una copia del objeto formateador de calendario
IntlDateFormatter::getTimeZone — Obtiene el formateador del huso horario
IntlDateFormatter::isLenient — Devuelve la severidad utilizada para IntlDateFormatter
IntlDateFormatter::localtime — Analiza una cadena y la convierte en tiempo
IntlDateFormatter::parse — Analiza una cadena hacia un timestamp
IntlDateFormatter::setCalendar — Define el tipo de calendario utilizado por el formateador
IntlDateFormatter::setLenient — Configura la flexibilidad del analizador
IntlDateFormatter::setPattern — Configura el patrón utilizado por IntlDateFormatter
IntlDateFormatter::setTimeZone — Define el formateador para el desplazamiento horario

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.