摘要訊息 : 學習 PHP 中的時間和日期表示方法.

目錄 隱藏
0. 前言
1. UNIX 时间戳
2. 获取时间日期信息
3. 时间检验
4. 输出格式化时间戳的日期和时间
5. 时间戳转换
TIP : 閣下正在檢閱歸檔文章, 該文章不再享受任何更新.

0. 前言

在讲时间与日期之前, 需要设置好 PHP 的配置文件 php.ini 里的 date.timezone= 选项. 否则, 一些关于时间的函数将不会生效. 如果你是按照本博客给出的方式安装 PHP 的话, 可以无视. 如果不想在配置文件里设置的话, 可以通过 date_default_timezone_set() 函数设置.

本文于 2022 年 3 月 18 日进行一次更新和修正. 修正之后本文已经归档, 不再享受更新.

1. UNIX 时间戳

在 UNIX 和 UNIX-like 系统中, 时间都是通过时间戳的方式进行存储的. 时间戳就是现在距离 GMT (1970 年 1月 1 日 零点整) 的时间差, 单位为秒. 它是一个整数, 而且不可改变

PHP 完全采用了 UNIX 时间戳, 在 PHP 中可以通过 time() 函数获取时间戳 :

<?php
    $time = time();
?>

2. 获取时间日期信息

PHP 中提供了 date 函数使得时间戳可以转换为能看得懂的通用时间. 除此之外, 还提供了 getdate 函数, 不过这个函数返回的是一个关于时间的数组. date 函数中, 有一个 formate 参数, 下面给出这个参数的具体值和对应的含义 :

  • d : 一个月中的第几天 (从 01 到 31);
  • D : 星期几的文本表示 (用三个字母表示);
  • j : 一个月中的第几天, 不带前导零 (1 到 31);
  • l : 星期几的完整的文本表示;
  • N : 星期几的 ISO-8601 数字格式表示 (1 表示 Monday[星期一], 7 表示 Sunday[星期日]);
  • S : 一个月中的第几天的英语序数后缀 (2 个字符 : st、nd、rd 或 th. 与 j 搭配使用);
  • w : 星期几的数字表示 (0 表示 Sunday[星期日], 6 表示 Saturday[星期六]);
  • z : 一年中的第几天 (从 0 到 365);
  • W : 用 ISO-8601 数字格式表示一年中的星期数字 (每周从 Monday[星期一] 开始);
  • F : 月份的完整的文本表示 (January[一月份] 到 December[十二月份]);
  • m : 月份的数字表示 (从 01 到 12);
  • M : 月份的短文本表示 (用三个字母表示);
  • n : 月份的数字表示, 不带前导零 (1 到 12);
  • t : 给定月份中包含的天数;
  • L : 是否是闰年 (如果是闰年则为 1, 否则为 0);
  • o : ISO-8601 标准下的年份数字;
  • Y : 年份的四位数表示;
  • y : 年份的两位数表示;
  • a : 小写形式表示 : am 或 pm;
  • A : 大写形式表示 : AM 或 PM;
  • B : Swatch Internet Time (000 到 999);
  • g : 12 小时制, 不带前导零 (1 到 12);
  • G : 24 小时制, 不带前导零 (0 到 23);
  • h : 12 小时制, 带前导零 (01 到 12);
  • H : 24 小时制, 带前导零 (00 到 23);
  • i : 分，带前导零 (00 到 59);
  • s : 秒，带前导零 (00 到 59);
  • u : 微秒;
  • e : 时区标识符 (例如 : UTC、GMT、Atlantic/Azores);
  • I : 日期是否是在夏令时 (如果是夏令时则为 1, 否则为 0);
  • O : 格林威治时间 (GMT)的差值，单位是小时 (实例 : +0100);
  • P : 格林威治时间 (GMT)的差值，单位是 hours:minutes;
  • T : 时区的简写 (实例 : EST, MDT)
  • Z : 以秒为单位的时区偏移量. UTC 以西时区的偏移量为负数 (-43200 到 50400);
  • c : ISO-8601 标准的日期 (例如 2013-05-05T16:34:42+00:00);
  • r : RFC 2822 格式的日期 (例如 Fri, 12 Apr 2013 12:01:05 +0200);
  • U : 自 Unix 纪元 (January 1 1970 00:00:00 GMT)以来经过的秒数.
<?php
    echo date("Y");    // 结果 : 輸出目前的年份
?>

getdate 函数同样也可以返回一些时间信息, 它对比 date 函数, 更能让人明白. 因为这是一个关联数组. 接下来给出数组如何访问 :

  • [seconds] : 秒;
  • [minutes] : 分;
  • [hours] : 小时;
  • [mday] : 一个月中的第几天;
  • [wday] : 一周中的某天;
  • [mon] : 月;
  • [year] : 年;
  • [yday] : 一年中的某天;
  • [weekday] : 星期几的名称;
  • [month] : 月份的名称;
  • [0] : 自 Unix 纪元以来经过的秒数.

访问的时候, 可以对里面的索引加引号, 也可以不加.

3. 时间检验

PHP 提供 checkdate 函数来对时间进行检验, 如果没有这个函数, 就要自己写 switch 语句进行检验了. 自己写函数检验非常麻烦. checkdate 函数可以检验日期的有效性, 例如 2 月 31 日到底合不合法 : checkdate($month, $date, $year);.

4. 输出格式化时间戳的日期和时间

PHP 提供了 strftime 函数来讲时间戳格式化为日期, 这个有点类似于 C 中的 sprinf 函数 : strftime($format, $time);. 现在给出 $format 的具体格式 :

  • %a : 星期几名称的简写;
  • %A : 星期几名称的全称;
  • %b : 月份名称的简写;
  • %B : 月份名称的全称;
  • %c : 首选的日期和时间表示法;
  • %C : 表示世纪的数字 (年份除以 100, 范围从 00 到 99);
  • %d : 一个月中的第几天 (01 到 31);
  • %D : 时间格式, 与 %m/%d/%y 表示法相同;
  • %e : 一个月中的第几天 (1 到 31);
  • %g : 与 %G 表示法类似，但不带世纪;
  • %G : 与 ISO 星期数对应的 4 位数年份 (见 %V);
  • %h : 与 %b 表示法相同;
  • %H : 小时, 使用 24 小时制 (00 到 23);
  • %I : 小时, 使用 12 小时制 (01 到 12);
  • %j : 一年中的第几天 (001 到 366);
  • %m : 月份 (01 到 12);
  • %M : 分;
  • %n : 换行符;
  • %p : 与给定的时间值相对应的 am 或 pm;
  • %r : a.m. 和 p.m. 的时间标记法;
  • %R : 24 小时制的时间标记法;
  • %S : 秒;
  • %t : tab 制表符;
  • %T : 当前时间，与 %H:%M:%S 表示法相同;
  • %u : 星期几的数字表示 (1 到 7), Monday[星期一] = 1. 警告 : 在 Sun Solaris 系统中, Sunday[星期日] = 1;
  • %U : 当年包含的周数，从第一个星期日开始，作为第一周的第一天;
  • %V : 当年包含的 ISO 8601 格式下的周数 (01 到 53), week 1 表示当年的第一周, 至少要有四天, 且以星期一作为周的第一天;
  • %W : 当年包含的周数，从第一个星期一开始，作为第一周的第一天;
  • %w : 以十进制数形式表示一周中的某天, Sunday[星期日] = 0;
  • %x : 首选的日期表示法, 不带时间;
  • %X : 首选的时间表示法, 不带日期;
  • %y : 不包含表示世纪的数字的年份表示 (范围从 00 到 99);
  • %Y : 包含表示世纪的数字的年份表示;
  • %Z 或 %z : 时区名称或简写;
  • %% : 输出一个 % 字符.

$time 参数是 UNIX 时间戳.

5. 时间戳转换

PHP 提供 mktime 函数, 可以将给定的时间转换为时间戳 : mktime($hour, $minute, $second, $month, $date, $year);.