DateTime 類別

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

簡介

日期和時間的表示法。

此類別的行為與 DateTimeImmutable 相同，不同之處在於當呼叫修改方法（例如 DateTime::modify()）時，物件本身會被修改。

警告

呼叫 DateTime 類別物件上的方法將會更改封裝在這些物件中的資訊，如果您想要防止這種情況，您必須使用 clone 運算子來建立新的物件。請使用 DateTimeImmutable 取代 DateTime 以預設取得此建議的行為。

類別概要

類別 DateTime 實作 DateTimeInterface {

/* 繼承的常數 */

公開常數字串 DateTimeInterface::ATOM = "Y-m-d\\TH:i:sP";

公開常數字串 DateTimeInterface::COOKIE = "l, d-M-Y H:i:s T";

公開常數字串 DateTimeInterface::ISO8601 = "Y-m-d\\TH:i:sO";

公開常數字串 DateTimeInterface::ISO8601_EXPANDED = "X-m-d\\TH:i:sP";

公開常數字串 DateTimeInterface::RFC822 = "D, d M y H:i:s O";

公開常數字串 DateTimeInterface::RFC850 = "l, d-M-y H:i:s T";

公開常數字串 DateTimeInterface::RFC1036 = "D, d M y H:i:s O";

公開常數字串 DateTimeInterface::RFC1123 = "D, d M Y H:i:s O";

公開常數字串 DateTimeInterface::RFC7231 = "D, d M Y H:i:s \\G\\M\\T";

公開常數字串 DateTimeInterface::RFC2822 = "D, d M Y H:i:s O";

公開常數字串 DateTimeInterface::RFC3339 = "Y-m-d\\TH:i:sP";

公開常數字串 DateTimeInterface::RFC3339_EXTENDED = "Y-m-d\\TH:i:s.vP";

公開常數字串 DateTimeInterface::RSS = "D, d M Y H:i:s O";

公開常數字串 DateTimeInterface::W3C = "Y-m-d\\TH:i:sP";

/* 方法 */

公開 __construct(字串 $datetime = "now", ?DateTimeZone $timezone = null)

公開 add(DateInterval $interval): DateTime

公開靜態 createFromFormat(字串 $format, 字串 $datetime, ?DateTimeZone $timezone = null): DateTime|false｜假

公開靜態 createFromImmutable(DateTimeImmutable $object): static

公開靜態 createFromInterface(DateTimeInterface $object): DateTime

公開 modify(字串 $modifier): DateTime

公開靜態 __set_state(陣列 $array): DateTime

公開 setDate(整數 $year, 整數 $month, 整數 $day): DateTime

公開 setISODate(整數 $year, 整數 $week, 整數 $dayOfWeek = 1): DateTime

公開 setTime(
    整數 $hour,
    整數 $minute,
    整數 $second = 0,
    整數 $microsecond = 0
): DateTime

公開 setTimestamp(整數 $timestamp): DateTime

公開 setTimezone(DateTimeZone $timezone): DateTime

公開 sub(DateInterval $interval): DateTime

公開 diff(DateTimeInterface $targetObject, 布林值 $absolute = false): DateInterval

公開 format(字串 $format): 字串

公開 getOffset(): 整數

公開 getTimestamp(): 整數

公開 getTimezone(): DateTimeZone|false

公開 __wakeup(): void

}

更新日誌

版本	說明
8.4.0	類別常數現在已設定類型。
7.2.0	DateTime 的類別常數現在定義在 DateTimeInterface 上。
7.1.0	DateTime 建構函式現在會將目前的微秒數包含在建構的值中。在此之前，它總是將微秒數初始化為 `0`。

DateTime::add — 修改 DateTime 物件，加上指定的天數、月數、年數、小時數、分鐘數和秒數
DateTime::__construct — 傳回新的 DateTime 物件
DateTime::createFromFormat — 根據指定的格式解析時間字串
DateTime::createFromImmutable — 傳回新的 DateTime 實例，其中封裝了給定的 DateTimeImmutable 物件
DateTime::createFromInterface — 回傳以指定 DateTimeInterface 物件封裝的新 DateTime 物件
DateTime::getLastErrors — DateTimeImmutable::getLastErrors 的別名
DateTime::modify — 修改時間戳記
DateTime::__set_state — __set_state 處理器
DateTime::setDate — 設定日期
DateTime::setISODate — 設定 ISO 日期
DateTime::setTime — 設定時間
DateTime::setTimestamp — 根據 Unix 時間戳記設定日期和時間
DateTime::setTimezone — 設定 DateTime 物件的時區
DateTime::sub — 從 DateTime 物件減去指定的天數、月數、年數、小時數、分鐘數和秒數

發現問題了嗎？

瞭解如何改進此頁面 • 提交 Pull Request • 回報錯誤

＋新增註解

使用者貢獻的註解

此頁面沒有使用者貢獻的註解。

DateTime 類別

簡介

類別概要

更新日誌

目錄

發現問題了嗎？

使用者貢獻的註解