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 {

/* Constantes heredadas */

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 function __construct(string $datetime = "now", ?DateTimeZone $timezone = null)

#[\NoDiscard(message: "as DateTimeImmutable::add() does not modify the object itself")]
public function add(DateInterval $interval): DateTimeImmutable

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

public static function createFromInterface(DateTimeInterface $object): DateTimeImmutable

public static function createFromMutable(DateTime $object): static

public static function createFromTimestamp(int|float $timestamp): static

public static function getLastErrors(): array|false

#[\NoDiscard(message: "as DateTimeImmutable::modify() does not modify the object itself")]
public function modify(string $modifier): DateTimeImmutable

public static function __set_state(array $array): DateTimeImmutable

#[\NoDiscard(message: "as DateTimeImmutable::setDate() does not modify the object itself")]
public function setDate(int $year, int $month, int $day): DateTimeImmutable

#[\NoDiscard(message: "as DateTimeImmutable::setISODate() does not modify the object itself")]
public function setISODate(int $year, int $week, int $dayOfWeek = 1): DateTimeImmutable

#[\NoDiscard(message: "as DateTimeImmutable::setMicrosecond() does not modify the object itself")]
public function setMicrosecond(int $microsecond): static

#[\NoDiscard(message: "as DateTimeImmutable::setTime() does not modify the object itself")]
public function setTime(
    int $hour,
    int $minute,
    int $second = 0,
    int $microsecond = 0
): DateTimeImmutable

#[\NoDiscard(message: "as DateTimeImmutable::setTimestamp() does not modify the object itself")]
public function setTimestamp(int $timestamp): DateTimeImmutable

#[\NoDiscard(message: "as DateTimeImmutable::setTimezone() does not modify the object itself")]
public function setTimezone(DateTimeZone $timezone): DateTimeImmutable

#[\NoDiscard(message: "as DateTimeImmutable::sub() does not modify the object itself")]
public function sub(DateInterval $interval): DateTimeImmutable

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

public function format(string $format): string

public function getMicrosecond(): int

public function getOffset(): int

public function getTimestamp(): int

public function getTimezone(): DateTimeZone|false

public function __serialize(): array

public function __unserialize(array $data): void

#[\Deprecated(
since: '8.5',
message: 'this method is obsolete, as serialization hooks are provided by __unserialize() and __serialize()',
)]
public function __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::createFromTimestamp — Crea una instancia a partir de una marca de tiempo Unix
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::setMicrosecond — Establece la parte de microsegundos de la hora
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.