La clase DateTimeImmutable

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

Introducción

Representación de fecha y hora.

Esta clase se comporta igual que DateTime con la excepción de que devuelve nuevos objetos cuando se llaman a métodos de modificación como DateTime::modify().

Sinopsis de la Clase

class DateTimeImmutable implements DateTimeInterface {

/* Constantaes heredadas constants */

public const string DateTimeInterface::ATOM = "Y-m-d\\TH:i:sP";

public const string DateTimeInterface::COOKIE = "l, d-M-Y H:i:s T";

public const string DateTimeInterface::ISO8601 = "Y-m-d\\TH:i:sO";

public const string DateTimeInterface::ISO8601_EXPANDED = "X-m-d\\TH:i:sP";

public const string DateTimeInterface::RFC822 = "D, d M y H:i:s O";

public const string DateTimeInterface::RFC850 = "l, d-M-y H:i:s T";

public const string DateTimeInterface::RFC1036 = "D, d M y H:i:s O";

public const string DateTimeInterface::RFC1123 = "D, d M Y H:i:s O";

public const string DateTimeInterface::RFC7231 = "D, d M Y H:i:s \\G\\M\\T";

public const string DateTimeInterface::RFC2822 = "D, d M Y H:i:s O";

public const string DateTimeInterface::RFC3339 = "Y-m-d\\TH:i:sP";

public const string DateTimeInterface::RFC3339_EXTENDED = "Y-m-d\\TH:i:s.vP";

public const string DateTimeInterface::RSS = "D, d M Y H:i:s O";

public const string DateTimeInterface::W3C = "Y-m-d\\TH:i:sP";

/* Métodos */

public __construct(string $datetime = "now", ?DateTimeZone $timezone = null)

#[\NoDiscard]
public add(DateInterval $interval): DateTimeImmutable

public static createFromFormat(string $format, string $datetime, ?DateTimeZone $timezone = null): DateTimeImmutable|false

public static createFromInterface(DateTimeInterface $object): DateTimeImmutable

public static createFromMutable(DateTime $object): static

public static getLastErrors(): array|false

#[\NoDiscard]
public modify(string $modifier): DateTimeImmutable

public static __set_state(array $array): DateTimeImmutable

#[\NoDiscard]
public setDate(int $year, int $month, int $day): DateTimeImmutable

#[\NoDiscard]
public setISODate(int $year, int $week, int $dayOfWeek = 1): DateTimeImmutable

#[\NoDiscard]
public setTime(
    int $hour,
    int $minute,
    int $second = 0,
    int $microsecond = 0
): DateTimeImmutable

#[\NoDiscard]
public setTimestamp(int $timestamp): DateTimeImmutable

#[\NoDiscard]
public setTimezone(DateTimeZone $timezone): DateTimeImmutable

#[\NoDiscard]
public sub(DateInterval $interval): DateTimeImmutable

public diff(DateTimeInterface $targetObject, bool $absolute = false): DateInterval

public format(string $format): string

public getOffset(): int

public getTimestamp(): int

public getTimezone(): DateTimeZone|false

public __serialize(): array

public __unserialize(array $data): void

#[\Deprecated]
public __wakeup(): void

}

Historial de cambios

Versión	Descripción
8.4.0	Las constantes de clase ahora están tipadas.
7.1.0	El constructor de DateTimeImmutable ahora incluye los microsegundos actuales en el valor construido. Antes de esto, siempre inicializaría los microsegundos a `0`.

Tabla de contenidos

DateTimeImmutable::add — Devuelve un nuevo objeto, con una cantidad añadida de días, meses, años, horas, minutos y segundos
DateTimeImmutable::__construct — Devuelve un nuevo objeto DateTimeImmutable
DateTimeImmutable::createFromFormat — Analiza un string de tiempo según el formato especificado
DateTimeImmutable::createFromInterface — Devuelve un nuevo objeto DateTimeImmutable que encapsula el objeto DateTimeInterface dado
DateTimeImmutable::createFromMutable — Devuelve un nuevo objeto DateTimeImmutable que encapsula el objeto DateTime dado
DateTimeImmutable::getLastErrors — Devuelve las advertencias y errores
DateTimeImmutable::modify — Crea un nuevo objeto con la marca de tiempo modificada
DateTimeImmutable::__set_state — El gestor __set_state
DateTimeImmutable::setDate — Establece la fecha
DateTimeImmutable::setISODate — Establece la fecha ISO
DateTimeImmutable::setTime — Establece la hora
DateTimeImmutable::setTimestamp — Establece la fecha y hora basadas en una marca de tiempo Unix (Unix timestamp)
DateTimeImmutable::setTimezone — Establece la zona horaria
DateTimeImmutable::sub — Sustrae una cantidad de días, meses, años, horas, minutos y segundos

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.