php strftime函数的详细用法

定义和用法

strftime() 函数根据区域设置格式化本地时间／日期。

语法

strftime(format,timestamp)参数 描述
format 可选。规定如何返回结果。
timestamp 可选。
提示和注释
提示：与 gmstrftime() 的行为相同，不同的是返回时间是本地时间。

例子

输出 strftime() 和 gmstrftime() 的结果：

<?php教程
echo(strftime("%b %d %y %x", mktime(20,0,0,12,31,98)));
echo(gmstrftime("%b %d %y %x", mktime(20,0,0,12,31,98)));

//输出当前日期、时间和时区
echo(gmstrftime("it is %a on %b %d, %y, %x time zone: %z",time()));
?>

strftime()函数可以把yyyy-mm-dd hh:mm:ss格式的日期字符串转换成其它形式的字符串。
strftime()的语法是strftime(格式, 日期/时间, 修正符, 修正符, ...)

它可以用以下的符号对日期和时间进行格式化：

%a	当前区域星期几的简写	sun 到 sat
%a	当前区域星期几的全称	sunday 到 saturday
%d	月份中的第几天，十进制数字（范围从 01 到 31）	01 到 31
%e	月份中的第几天，十进制数字，一位的数字前会加上一个空格（范围从 ' 1' 到 '31'） 在 windows 上尚未按描述实现。更多信息见下方。	1 到 31
%j	年份中的第几天，带前导零的三位十进制数（范围从 001 到 366）	001 到 366
%u	符合 iso-8601 星期几的十进制数表达 [1,7]，1 表示星期一	1 (星期一) 到 7 (星期日)
%w	星期中的第几天，星期天为 0	0 (星期天) 到 6 (星期六)
周	---	---
%u	本年的第几周，从第一周的第一个星期天作为第一天开始	13 (for the 13th full week of the year)
%v	%v - 本年第几周的 iso-8601:1988 格式，范围从 01 到 53，第 1 周是本年第一个至少还有 4 天的星期，星期一作为每周的第一天。（用 %g 或者 %g 作为指定时间戳相应周数的年份组成。）	01 到 53 (where 53 accounts for an overlapping week)
%w	本年的第几周数，从第一周的第一个星期一作为第一天开始	46 (for the 46th week of the year beginning with a monday)
月	---	---
%b	当前区域月份的简写	jan 到 dec
%b	当前区域月份的全称	january 到 december
%h	当前区域月份的简写（%b 的别名）	jan 到 dec
%m	两位数的月份	01 (是一月份) 到 12 (是十二月份)
年	---	---
%c	两位数显示世纪（年份除以 100，截成整数）	19 是 20 世纪
%g	2 位数的年份，符合 iso-8601:1988 星期数（参见 %v）。和 %v 的格式和值一样，只除了如果 iso 星期数属于前一年或者后一年，则使用那一年。	比如：2009年1月6日那一周是 09。
%g	%g 的完整四位数版本	比如：2009年1月3日那一周是 2008.
%y	两位数显示年份	比如： 09 是 2009，79 是 1979
%y	四位数显示年份	比如： 2038
时间	---	---
%h	以 24 小时格式显示两位小时数	00 到 23
%i	以 12 小时格式显示两位小时数	01 到 12
%l（'l' 的小写）	以 12 小时格式显示小时数，单个数字前含空格	1 到 12
%m	两位的分钟数	00 到 59
%p	指定时间的大写 “am” 或 “pm”	比如： 00:31 是 am ，22:23 是pm
%p	指定时间的小写 “am” 或 “pm”	比如：00:31 是 am ，22:23 是pm
%r	和 "%i:%m:%s %p" 一样	比如： 21:34:17 是 09:34:17 pm
%r	和 "%h:%m" 一样	比如： 12:35 am 是 00:35，4:44 pm 是 16:44
%s	两位数字表示秒	00 到 59
%t	和 "%h:%m:%s" 一样	比如： 09:34:17 pm 是 21:34:17
%x	当前区域首选的时间表示法，不包括日期	例如： 03:59:16 或 15:59:16
%z	从 utc 的时区偏移 或 简写（由操作系统决定）	比如： 东部时间是 -0500 或 est
%z	%z 没有给出的 utc 的时区偏移 或 简写（由操作系统决定）	比如： -0500 或 est 是东部时间
时间和日期戳	---	---
%c	当前区域首选的日期时间表达	比如： 2009 年 2 月 5 日上午 12:45:10 是 tue feb 5 00:45:10 2009
%d	和 "%m/%d/%y" 一样	比如： 2009 年 2 月 5 日是 02/05/09
%f	same as "%y-%m-%d" (commonly used in database datestamps)	比如：2009 年 2 月 5 日是 2009-02-05
%s	unix纪元的时间戳（和  函数一样）	比如： 1979 年 9 月 10 日上午 8 点 40 分 00 秒是 305815200
%x	当前区域首选的时间表示法，不包括时间	比如： 2009 年 2 月 5 日是 02/05/09
其他	---	---
%n	换行符("\n")	---
%t	tab 字符("\t")	---
%%	文字上的百分字符("%")

这个参数的最大长度是 1023 个字符。

warning
尽管 iso 9889:1999（当前的 c 标准）明确指出一周从星期一开始，但是 sun solaris 的一周似乎从星期天开始并作为 1。所以 %u 的结果也许不会和手册里描述得一样。

warning
仅针对 windows：这个函数里 %e 修饰符修饰符还不能支持 windows。 为了得到这个值可以用 %#d 修饰符来代替。下例说明了如何写一个跨平台支持的函数。

warning
仅针对 mac os x：这个函数里 %p 修饰符还不能支持 mac os x。

timestamp
可选的 timestamp 参数是一个 integer 的 unix 时间戳，如未指定，参数值默认为当前本地时间。也就是说，其值默认为 time() 的返回值。

strftime()的用法举例如下：

select strftime('%y.%m.%d %h:%m:%s','now','localtime');
结果：2018.06.21 21:41:09
其实更好的用法是这样的,比如统,本月或本年的支出:
select strftime('%y-%m',日期) as 月份,sum(支出) as 月支出 from 流水帐 group by 月份;

example #1 strftime() locale examples

<?php
setlocale(lc_time, "c");
echo strftime("%a");
setlocale(lc_time, "fi_fi");
echo strftime(" in finnish is %a,");
setlocale(lc_time, "fr_fr");
echo strftime(" in french %a and");
setlocale(lc_time, "de_de");
echo strftime(" in german %a.\n");
?>

example #2 iso 8601:1988 week number example

<?php
/*   december 2002 / january 2003
isowk m  tu w  thu f  sa su
----- ----------------------------
51   16 17 18 19 20 21 22
52   23 24 25 26 27 28 29
1   30 31  1  2  3  4  5
2    6  7  8  9 10 11 12
3   13 14 15 16 17 18 19  */

// outputs: 12/28/2002 - %v,%g,%y = 52,2002,2002
echo "12/28/2002 - %v,%g,%y = " . strftime("%v,%g,%y", strtotime("12/28/2002")) . "\n";

// outputs: 12/30/2002 - %v,%g,%y = 1,2003,2002
echo "12/30/2002 - %v,%g,%y = " . strftime("%v,%g,%y", strtotime("12/30/2002")) . "\n";

// outputs: 1/3/2003 - %v,%g,%y = 1,2003,2003
echo "1/3/2003 - %v,%g,%y = " . strftime("%v,%g,%y",strtotime("1/3/2003")) . "\n";

// outputs: 1/10/2003 - %v,%g,%y = 2,2003,2003
echo "1/10/2003 - %v,%g,%y = " . strftime("%v,%g,%y",strtotime("1/10/2003")) . "\n";



/*   december 2004 / january 2005
isowk m  tu w  thu f  sa su
----- ----------------------------
51   13 14 15 16 17 18 19
52   20 21 22 23 24 25 26
53   27 28 29 30 31  1  2
1    3  4  5  6  7  8  9
2   10 11 12 13 14 15 16  */

// outputs: 12/23/2004 - %v,%g,%y = 52,2004,2004
echo "12/23/2004 - %v,%g,%y = " . strftime("%v,%g,%y",strtotime("12/23/2004")) . "\n";

// outputs: 12/31/2004 - %v,%g,%y = 53,2004,2004
echo "12/31/2004 - %v,%g,%y = " . strftime("%v,%g,%y",strtotime("12/31/2004")) . "\n";

// outputs: 1/2/2005 - %v,%g,%y = 53,2004,2005
echo "1/2/2005 - %v,%g,%y = " . strftime("%v,%g,%y",strtotime("1/2/2005")) . "\n";

// outputs: 1/3/2005 - %v,%g,%y = 1,2005,2005
echo "1/3/2005 - %v,%g,%y = " . strftime("%v,%g,%y",strtotime("1/3/2005")) . "\n";

?>

example #3 cross platform compatible example using the %e modifier

<?php

// jan 1: results in: '%e%1%' (%%, e, %%, %e, %%)
$format = '%%e%%%e%%';

// check for windows to find and replace the %e 
// modifier correctly
if (strtoupper(substr(php_os, 0, 3)) == 'win') {
  $format = preg_replace('#(?<!%)((?:%%)*)%e#', '\1%#d', $format);
}

echo strftime($format);
?>

example #4 display all known and unknown formats.

<?php
// describe the formats.
$strftimeformats = array(
  'a' => 'a full textual representation of the day',
  'b' => 'full month name, based on the locale',
  'c' => 'two digit representation of the century (year divided by 100, truncated to an integer)',
  'd' => 'same as "%m/%d/%y"',
  'e' => '',
  'f' => 'same as "%y-%m-%d"',
  'g' => 'the full four-digit version of %g',
  'h' => 'two digit representation of the hour in 24-hour format',
  'i' => 'two digit representation of the hour in 12-hour format',
  'j' => '',
  'k' => '',
  'l' => '',
  'm' => 'two digit representation of the minute',
  'n' => '',
  'o' => '',
  'p' => 'lower-case "am" or "pm" based on the given time',
  'q' => '',
  'r' => 'same as "%h:%m"',
  's' => 'two digit representation of the second',
  't' => 'same as "%h:%m:%s"',
  'u' => 'week number of the given year, starting with the first sunday as the first week',
  'v' => 'iso-8601:1988 week number of the given year, starting with the first week of the year with at least 4 weekdays, with monday being the start of the week',
  'w' => 'a numeric representation of the week of the year, starting with the first monday as the first week',
  'x' => 'preferred time representation based on locale, without the date',
  'y' => 'four digit representation for the year',
  'z' => 'the time zone offset/abbreviation option not given by %z (depends on operating system)',
  'a' => 'an abbreviated textual representation of the day',
  'b' => 'abbreviated month name, based on the locale',
  'c' => 'preferred date and time stamp based on local',
  'd' => 'two-digit day of the month (with leading zeros)',
  'e' => 'day of the month, with a space preceding single digits',
  'f' => '',
  'g' => 'two digit representation of the year going by iso-8601:1988 standards (see %v)',
  'h' => 'abbreviated month name, based on the locale (an alias of %b)',
  'i' => '',
  'j' => 'day of the year, 3 digits with leading zeros',
  'k' => 'hour in 24-hour format, with a space preceding single digits',
  'l' => 'hour in 12-hour format, with a space preceding single digits',
  'm' => 'two digit representation of the month',
  'n' => 'a newline character ("\n")',
  'o' => '',
  'p' => 'upper-case "am" or "pm" based on the given time',
  'q' => '',
  'r' => 'same as "%i:%m:%s %p"',
  's' => 'unix epoch time timestamp',
  't' => 'a tab character ("\t")',
  'u' => 'iso-8601 numeric representation of the day of the week',
  'v' => '',
  'w' => 'numeric representation of the day of the week',
  'x' => 'preferred date representation based on locale, without the time',
  'y' => 'two digit representation of the year',
  'z' => 'either the time zone offset from utc or the abbreviation (depends on operating system)',
  '%' => 'a literal percentage character ("%")',
);

// results.
$strftimevalues = array();

// evaluate the formats whilst suppressing any errors.
foreach($strftimeformats as $format => $description){
  if (false !== ($value = @strftime("%{$format}"))){
    $strftimevalues[$format] = $value;
  }
}

// find the longest value.
$maxvaluelength = 2 + max(array_map('strlen', $strftimevalues));

// report known formats.
foreach($strftimevalues as $format => $value){
  echo "known format  : '{$format}' = ", str_pad("'{$value}'", $maxvaluelength), " ( {$strftimeformats[$format]} )\n";
}

// report unknown formats.
foreach(array_diff_key($strftimeformats, $strftimevalues) as $format => $description){
  echo "unknown format : '{$format}'  ", str_pad(' ', $maxvaluelength), ($description ? " ( {$description} )" : ''), "\n";
}
?>

下面是其他网友的补充

php strftime()的使用

string strftime ( string format[,inttimestamp = time() ] )

返回用给定的格式字串对给出的 timestamp 进行格式输出后的字符串。如果没有给出时间戳则用当前的本地时间。

example1:

<?php
echo '本年中的第·' . strftime('%w', strtotime('+2 week midnight -0 second')) . '·周';
?>

本年中的第·31·周

example2:

<?php
echo "現在時間是：" . strftime('%d.%b %y %h:%m:%s', time());
?>

現在時間是：20.july 2015 17:01:26

example3:

<?php
echo '日期時間格式化為:' . strftime('%d.%b %y %h:%m:%s', strtotime('2018-10-15'));
?>

日期時間格式化為:15.october 2018 00:00:00