PHP - Manual: DateTime::getTimestamp

2024-12-20

DateTime::getTimestamp

DateTimeImmutable::getTimestamp

DateTimeInterface::getTimestamp

date_timestamp_get

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

DateTime::getTimestamp -- DateTimeImmutable::getTimestamp -- DateTimeInterface::getTimestamp -- date_timestamp_get — Gets the Unix timestamp

说明

面向对象风格

public DateTime::getTimestamp(): int

public DateTimeImmutable::getTimestamp(): int

public DateTimeInterface::getTimestamp(): int

过程化风格

date_timestamp_get(DateTimeInterface $object): int

Gets the Unix timestamp.

参数

此函数没有参数。

返回值

Returns the Unix timestamp representing the date.

错误／异常

If the timestamp cannot be represented as int, a ValueError is thrown. Prior to PHP 8.0.0, false was returned in this case. Still, the timestamp can be retrieved as string by using DateTimeInterface::format() with the U format.

更新日志

版本	说明
8.0.0	These functions no longer return `false` on failure.

范例

示例 #1 DateTime::getTimestamp() example

面向对象风格


<?php
$date = new DateTime();
echo $date->getTimestamp();
?>

过程化风格


<?php
$date = date_create();
echo date_timestamp_get($date);
?>

以上例程的输出类似于：

1272509157

参见

DateTime::setTimestamp() - 以 Unix 时间戳的方式设置 DateTime 对象
DateTime::format() - Returns date formatted according to given format

add a note

User Contributed Notes 4 notes

down

heiccih at gmail dot com ¶

8 years ago


In 32-bit system the unix timestamp will overflow if the date goes beyond year 2038 and this method will return false. In 64-bit systems this function will still work as intended. For more information please see http://en.wikipedia.org/wiki/Year_2038_problem.

down

Justin Heesemann ¶

12 years ago


Note that for dates before the unix epoch getTimestamp() will return false, whereas format("U") will return a negative number.

<?php
$date = new DateTime("1899-12-31");
// "-2209078800"
echo $date->format("U");
// false
echo $date->getTimestamp();
?>

down

mike at eastghost dot com ¶

27 days ago


Not clearly noted in documentation:

UNIX timestamps are by definition in UTC timezone only: @1234567890 represents the same date/time regardless of timezone.

Therefore, DateTime::getTimestamp() always returns (seconds since epoch) in the UTC timezone, even when DateTime object has its DateTimeZone set to any non-UTC timezone.

To make a 'timestamp' that is local to your server (in any non-UTC timezone), use mktime() and feed it the desired/offset local time components.

down

-7

Julien Bornstein ¶

2 years ago


Please note that DateTime::gettimestamp() will return an integer, but DateTime::format("U") will return a string.

timestamp must always be typed as int because in PHP, timestamps are integers.

eg:
- strftime ( string $format [, int $timestamp = time() ] ) : string
- time() // return int
- ...

So IMHO, as PHP becomes more and more a typed language, avoid using DateTime::format("U") to avoid this kind of errors "strftime() expects parameter 2 to be int, string given"

add a note

官方地址：https://www.php.net/manual/en/datetime.gettimestamp.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络数据库 JAVA 面试 NoSQL C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 adodb手册 ADORecordSet对象 opcache预加载 Composer的Packagist资源 array_multisort() 多字段排序 PHPMailer设置utf8 PHPMailer字符集CharSet PHP json解析（json_decode）页面工具 mysql面试题纯php实现DES以及TripleDES加密算法 php中几种注释规范两千行PHP学习笔记 php 修改图片大小支持php7的性能采集扩展利用PHP SOAP实现WEB SERVICE

略微加速

PHP官方手册 - 互联网笔记

DateTime::getTimestamp

DateTimeImmutable::getTimestamp

DateTimeInterface::getTimestamp

date_timestamp_get

说明

参数

返回值

错误／异常

更新日志

范例

参见

User Contributed Notes 4 notes