La clase DateTime

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

Introducción

Representación de la fecha y la hora.

Esta clase se comporta igual que DateTimeImmutable, excepto que los objetos se modifican cuando se llaman métodos de modificación como DateTime::modify().

Advertencia

Llamando metodos en objetos de la clase DateTime cambiará la información encapsulada en ese objeto, si deseas prevenir eso tendrás que usar el operador clone para crear un nuevo objeto. Usa DateTimeImmutable en lugar de DateTime para obtener este comportamiento recomendado por defecto.

Sinopsis de la Clase

class DateTime 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)

public add(DateInterval $interval): DateTime

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

public static createFromImmutable(DateTimeImmutable $object): static

public static createFromInterface(DateTimeInterface $object): DateTime

public modify(string $modifier): DateTime

public static __set_state(array $array): DateTime

public setDate(int $year, int $month, int $day): DateTime

public setISODate(int $year, int $week, int $dayOfWeek = 1): DateTime

public setTime(
    int $hour,
    int $minute,
    int $second = 0,
    int $microsecond = 0
): DateTime

public setTimestamp(int $timestamp): DateTime

public setTimezone(DateTimeZone $timezone): DateTime

public sub(DateInterval $interval): DateTime

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.2.0	Las constantes de clase de DateTime ahora están definidas en DateTimeInterface.
7.1.0	El constructor de DateTime ahora incluye los microsegundos actuales en el valor construido. Antes de esto, siempre inicializaría los microsegundos a `0`.

Tabla de contenidos

DateTime::add — Modifica un objeto DateTime, añadiendo una cantidad de días, meses, años, horas, minutos y segundos
DateTime::__construct — Devuelve un nuevo objeto DateTime
DateTime::createFromFormat — Analiza una cadena con un instante según un formato especificado
DateTime::createFromImmutable — Devuelve una nueva instancia de DateTime encapsulando el objeto DateTimeImmutable dado
DateTime::createFromInterface — RDevuelve un nuevo objeto DateTime que encapsula el objeto DateTimeInterface dado
DateTime::getLastErrors — Alias de DateTimeImmutable::getLastErrors
DateTime::modify — Altera la marca temporal
DateTime::__set_state — El gestor __set_state
DateTime::setDate — Establece la fecha
DateTime::setISODate — Establece la fecha ISO
DateTime::setTime — Establece la hora
DateTime::setTimestamp — Establece la fecha y la hora basándose en una marca temporal de Unix
DateTime::setTimezone — Establece la zona horaria para el objeto DateTime
DateTime::sub — Sustrae una cantidad de días, meses, años, horas, minutos y segundos de un objeto DateTime

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.