PHP：日期/时间函数库

陈一男学习网站[ ChenYinan.com ] - CCF - NOI - 菜鸟教程 - 编程题库 - C++语言 - API

在 PHP 中，有丰富的日期时间函数库可以用于处理日期和时间相关的操作。以下是一些主要的方面：

一、获取当前日期时间

1. time()：

time()函数返回一个整数，表示当前的Unix时间戳。即从 1970 年 1 月 1 日 00:00:00 GMT 到当前时间的秒数。

例如，在2024年11月13日某一时刻调用time()函数，可能会返回类似于1700169600这样的数字。

$timestamp = time();
echo $timestamp;

将时间戳转换为日期时间格式：

$currentTimeStamp = time();
// 将时间戳转换为日期时间格式
$dateTime = date('Y-m-d H:i:s', $currentTimeStamp);
echo "当前日期时间: ". $dateTime;

在这个示例中，使用date()函数将time()函数获取的时间戳转换为常见的日期时间格式Y-m-d H:i:s，即年-月-日 时:分:秒的形式，方便人们阅读和理解。

time()函数是PHP中处理时间相关操作的基础函数之一，与其他日期时间函数结合使用，可以实现各种复杂的时间处理功能。

2. date($format, $timestamp);：

date()函数是 PHP 中用于格式化日期和时间的常用函数，以下是对它的详细介绍：

format：必需参数，规定了日期和时间的输出格式。

timestamp：可选参数，用于指定一个时间戳，如果省略，则使用当前的时间戳。

常用的格式化字符

年：

Y：四位数字表示的年份，例如 2024。

y：两位数字表示的年份，例如 24。

月：

m：两位数字表示的月份，有前导零，例如 11 表示 11 月。

M：三个字母缩写表示的月份，例如 Nov。

n：没有前导零的月份数字，例如 11。

F：完整的月份名称，例如 November。

日：

d：两位数字表示的日期，有前导零，例如 13 表示 13 日。

j：没有前导零的日期数字，例如 13。

D：三个字母缩写表示的星期几，例如 Wed。

l（小写的L）：完整的星期几名称，例如 Wednesday。

时、分、秒：

H：24 小时制的小时数，有前导零，例如 14。

h：12 小时制的小时数，有前导零，例如 02。

i：分钟数，有前导零，例如 30。

s：秒数，有前导零，例如 55。

其他：

a：小写的上午或下午，例如 am 或 pm。

A：大写的上午或下午，例如 AM 或 PM。

// 获取当前日期和时间，并按照不同格式输出
echo date('Y-m-d H:i:s'). "<br>"; // 2024-11-13 15:23:45
echo date('Y年m月d日 H点i分s秒'). "<br>"; // 2024年11月13日 15点23分45秒
echo date('l, F jS, Y'). "<br>"; // Wednesday, November 13th, 2024
// 使用指定的时间戳输出日期和时间
$timestamp = strtotime('2024-12-25 00:00:00');
echo date('Y-m-d H:i:s', $timestamp). "<br>"; // 2024-12-25 00:00:00
// 输出昨天的日期
$yesterday = strtotime('-1 day');
echo date('Y-m-d', $yesterday). "<br>"; // 2024-11-12

注意事项

date()函数返回的日期和时间是基于服务器的当前设置。如果服务器的时区设置不正确，可能会导致输出的日期和时间与预期不符。可以通过设置 date_default_timezone_set() 函数来更改时区。

时间戳是从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的秒数。在使用时间戳时，要注意其范围和精度，以及可能受到系统限制的情况。

date()函数在处理日期和时间相关的操作中非常实用，可以根据具体的需求灵活地格式化和输出日期和时间信息。

echo date('Y-m-d H:i:s'); // 输出类似 2024-10-16 12:34:56 的格式

二、格式化日期时间

1. date_format()（针对 DateTime 对象）：

如果使用 DateTime 对象，可以使用 date_format() 方法来格式化日期时间。

$date = new DateTime();
echo date_format($date, 'Y-m-d H:i:s');

2. strftime()：

根据本地化设置格式化日期和时间。

setlocale(LC_TIME, 'en_US.UTF-8');
echo strftime('%A, %B %d, %Y %H:%M:%S'); // 输出类似 Wednesday, October 16, 2024 12:34:56 的格式

三、日期时间的创建与修改

  1. DateTime 类：

DateTime 类是 PHP 中用于处理日期和时间的强大类，它提供了一系列方法来创建、操作和格式化日期和时间，以下是对它的详细介绍：

创建 DateTime 对象

使用当前日期和时间：可以直接实例化 DateTime 类来获取当前的日期和时间。

$dateTime = new DateTime();
echo $dateTime->format('Y-m-d H:i:s');

使用指定的日期和时间：通过传递一个有效的日期和时间字符串作为参数来创建指定日期和时间的 DateTime 对象。

$dateTime = new DateTime('2024-12-25 12:30:00');
echo $dateTime->format('Y-m-d H:i:s');

日期和时间的操作

修改日期和时间：可以使用 modify() 方法对日期和时间进行修改，该方法接受一个相对时间或绝对时间的字符串作为参数。

$dateTime = new DateTime('2024-12-25 12:30:00');
$dateTime->modify('+1 day');
echo $dateTime->format('Y-m-d H:i:s');

比较日期和时间：DateTime 类支持比较运算符，可以直接比较两个 DateTime 对象的大小。

$date1 = new DateTime('2024-12-25 12:30:00');
$date2 = new DateTime('2024-12-26 12:30:00');
if ($date1 < $date2) {
    echo 'date1 is earlier than date2';
}

日期和时间的格式化

使用 format() 方法可以将 DateTime 对象格式化为指定的字符串格式，其格式化字符与 date() 函数类似。

$dateTime = new DateTime('2024-12-25 12:30:00');
echo $dateTime->format('Y年m月d日 H点i分s秒');

时区设置

可以通过 setTimezone() 方法为 DateTime 对象设置时区。

$dateTime = new DateTime('2024-12-25 12:30:00');
$timezone = new DateTimeZone('America/New_York');
$dateTime->setTimezone($timezone);
echo $dateTime->format('Y-m-d H:i:s T');

与时间戳的转换

可以使用 getTimestamp() 方法获取 DateTime 对象对应的时间戳，也可以通过 DateTime 类的构造函数或 setTimestamp() 方法从时间戳创建或设置 DateTime 对象。

// 从时间戳创建 DateTime 对象
$timestamp = 1608879000;
$dateTime = new DateTime();
$dateTime->setTimestamp($timestamp);
echo $dateTime->format('Y-m-d H:i:s');
// 获取 DateTime 对象的时间戳
$dateTime = new DateTime('2024-12-25 12:30:00');
echo $dateTime->getTimestamp();

异常处理

当传递给 DateTime 类的构造函数或其他方法的日期和时间字符串无效时，会抛出 Exception 异常。因此，在使用时建议进行适当的异常处理。

try {
    $dateTime = new DateTime('invalid_date_time');
} catch (Exception $e) {
    echo 'Error: '. $e->getMessage();
}

2. strtotime($time_string, $now_timestamp);

strtotime()函数是PHP中用于将日期时间的字符串表示形式转换为Unix时间戳的一个非常实用的函数。

time_string：必需参数，规定了要解析的日期时间字符串。

now_timestamp：可选参数，用于指定一个基准时间戳，如果省略，则以当前时间为基准。

日期时间字符串的格式

常见日期格式：可以接受如Y-m-d、Y/m/d、d-m-Y等多种常见的日期格式，例如strtotime('2024-11-14')将返回2024年11月14日00:00:00的时间戳。

日期时间组合格式：也能处理包含日期和时间的字符串，如Y-m-d H:i:s格式，例如strtotime('2024-11-14 12:30:00')会将其转换为对应的时间戳。

相对时间格式：还支持相对时间的字符串表示，比如+1 day表示明天，-1 week表示上周，strtotime('+1 day')会返回从当前时间开始往后推一天的时间戳。

// 将指定日期转换为时间戳
echo strtotime('2024-12-25'). "<br>";
// 将指定日期时间转换为时间戳
echo strtotime('2024-12-25 12:30:00'). "<br>";
// 计算相对时间的时间戳
echo strtotime('+2 weeks'). "<br>";
echo strtotime('-3 days'). "<br>";
// 使用基准时间戳计算相对时间
$baseTime = strtotime('2024-11-14 10:00:00');
echo strtotime('+1 hour', $baseTime). "<br>";

注意事项

字符串的合法性：输入的日期时间字符串必须是能够被strtotime()函数正确解析的格式，否则可能会返回false。例如，strtotime('2024-13-01')会返回false，因为11月没有13日。

时区的影响：该函数的结果会受到服务器时区设置的影响。如果服务器时区设置不正确，可能会导致转换后的时间戳与预期不符。可以通过date_default_timezone_set()函数来设置正确的时区。

时间范围限制：由于Unix时间戳的范围限制，strtotime()函数能够处理的日期范围也有限制，一般来说是从1901年12月13日20:45:54 UTC到2038年1月19日03:14:07 UTC。

strtotime()函数在处理日期时间相关的计算和转换时非常方便，可以灵活地将各种日期时间的字符串表示转换为时间戳，以便进行进一步的操作和处理。

$timestamp = strtotime('next Monday');
echo date('Y-m-d', $timestamp);

四、日期时间的比较

1. DateTime::diff()：

可以比较两个 DateTime 对象，并返回一个 DateInterval 对象，包含时间差的信息。

$date1 = new DateTime('2024-10-16');
$date2 = new DateTime('2024-10-18');
$interval = $date1->diff($date2);
echo $interval->format('%R%a days'); // 输出 +2 days，表示两个日期之间相差两天

五、时区设置

1. date_default_timezone_set()：

设置默认的时区。

date_default_timezone_set('Asia/Shanghai');
echo date('Y-m-d H:i:s');

PHP 的日期时间函数库提供了强大的功能，可以满足各种日期时间处理的需求。在使用时，要注意时区的设置和不同函数的参数要求，以确保得到正确的结果。

PHP编程语言基础