(PHP 4, PHP 5, PHP 7, PHP 8)
strftime — 根據(jù)區(qū)域設(shè)置格式化本地時間／日期
$format, int $timestamp = time()): string
返回用給定的格式字串對給出的 timestamp
進行格式輸出后的字符串。如果沒有給出時間戳則用當(dāng)前的本地時間。月份和星期幾以及其它和語言有關(guān)的字符串寫法和用
setlocale() 設(shè)定的當(dāng)前的區(qū)域有關(guān)。
可能不是所有的轉(zhuǎn)換標(biāo)記都被 C 庫文件支持，這種情況下 PHP
的 strftime()
也不支持。此外，不是所有的平臺都支持負的時間戳，因此日期的范圍可能限定在不早于
Unix 紀(jì)元。這意味著例如
%e, %T，%R 和 %D（可能更多）以及早于
Jan 1, 1970 的時間在 Windows，一些 Linux
發(fā)行版本，以及其它幾個操作系統(tǒng)中無效。對于 Windows
系統(tǒng)，所支持的轉(zhuǎn)換標(biāo)記可在
? MSDN 網(wǎng)站找到。
format
格式 |
描述 | 返回值示例 |
|---|---|---|
| 日 | --- | --- |
%a |
當(dāng)前區(qū)域星期幾的簡寫 | Sun 到 Sat |
%A |
當(dāng)前區(qū)域星期幾的全稱 | Sunday 到 Saturday |
%d |
月份中的第幾天，十進制數(shù)字（范圍從 01 到 31） | 01 到 31 |
%e |
月份中的第幾天，十進制數(shù)字，一位的數(shù)字前會加上一個空格（范圍從 ' 1' 到 '31'） 在 Windows 上尚未按描述實現(xiàn)。更多信息見下方。 | 1 到 31 |
%j |
年份中的第幾天，帶前導(dǎo)零的三位十進制數(shù)（范圍從 001 到 366） | 001 到 366 |
%u |
符合 ISO-8601 星期幾的十進制數(shù)表達 [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 作為指定時間戳相應(yīng)周數(shù)的年份組成。） | 01 到 53 (where 53
accounts for an overlapping week) |
%W |
本年的第幾周數(shù)，從第一周的第一個星期一作為第一天開始 | 46 (for the 46th week of the year beginning
with a Monday) |
| 月 | --- | --- |
%b |
當(dāng)前區(qū)域月份的簡寫 | Jan 到 Dec |
%B |
當(dāng)前區(qū)域月份的全稱 | January 到 December |
%h |
當(dāng)前區(qū)域月份的簡寫（%b 的別名） | Jan 到 Dec |
%m |
兩位數(shù)的月份 | 01 (是一月份) 到 12 (是十二月份) |
| 年 | --- | --- |
%C |
兩位數(shù)顯示世紀(jì)（年份除以 100，截成整數(shù)） | 19 是 20 世紀(jì) |
%g |
2 位數(shù)的年份，符合 ISO-8601:1988 星期數(shù)（參見 %V）。和 %V 的格式和值一樣，只除了如果 ISO 星期數(shù)屬于前一年或者后一年，則使用那一年。 | 比如：2009年1月6日那一周是 09。 |
%G |
%g 的完整四位數(shù)版本 | 比如：2009年1月3日那一周是 2008. |
%y |
兩位數(shù)顯示年份 | 比如： 09 是 2009，79 是 1979 |
%Y |
四位數(shù)顯示年份 | 比如： 2038 |
| 時間 | --- | --- |
%H |
以 24 小時格式顯示兩位小時數(shù) | 00 到 23 |
%I |
以 12 小時格式顯示兩位小時數(shù) | 01 到 12 |
%l（'L' 的小寫） |
以 12 小時格式顯示小時數(shù)，單個數(shù)字前含空格 | 1 到 12 |
%M |
兩位的分鐘數(shù) | 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 |
兩位數(shù)字表示秒 | 00 到 59 |
%T |
和 "%H:%M:%S" 一樣 | 比如： 09:34:17 PM 是 21:34:17 |
%X |
當(dāng)前區(qū)域首選的時間表示法，不包括日期 | 例如： 03:59:16 或 15:59:16 |
%z |
從 UTC 的時區(qū)偏移 或 簡寫（由操作系統(tǒng)決定） | 比如： 東部時間是 -0500 或 EST |
%Z |
%z 沒有給出的 UTC 的時區(qū)偏移 或 簡寫（由操作系統(tǒng)決定） | 比如： -0500 或 EST 是東部時間 |
| 時間和日期戳 | --- | --- |
%c |
當(dāng)前區(qū)域首選的日期時間表達 | 比如： 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紀(jì)元的時間戳（和 time() 函數(shù)一樣） | 比如： 1979 年 9 月 10 日上午 8 點 40 分 00 秒是 305815200 |
%x |
當(dāng)前區(qū)域首選的時間表示法，不包括時間 | 比如： 2009 年 2 月 5 日是 02/05/09 |
| 其他 | --- | --- |
%n |
換行符("\n") | --- |
%t |
Tab 字符("\t") | --- |
%% |
文字上的百分字符("%") | --- |
這個參數(shù)的最大長度是 1023 個字符。
盡管 ISO 9889:1999（當(dāng)前的 C 標(biāo)準(zhǔn)）明確指出一周從星期一開始，但是 Sun Solaris 的一周似乎從星期天開始并作為 1。所以 %u 的結(jié)果也許不會和手冊里描述得一樣。
僅針對 Windows：這個函數(shù)里 %e
修飾符修飾符還不能支持 Windows。
為了得到這個值可以用 %#d 修飾符來代替。下例說明了如何寫一個跨平臺支持的函數(shù)。
僅針對 Mac OS X：這個函數(shù)里 %P 修飾符還不能支持 Mac OS X。
timestamp
可選的 timestamp 參數(shù)是一個 int 的 Unix
時間戳，如未指定或是 null，參數(shù)值默認為當(dāng)前本地時間。也就是說，其值默認為
time() 的返回值。
根據(jù)指定的 timestamp 或未給出 timestamp 是使用當(dāng)前本地時間，
返回 format 格式化的字符。
月份、星期名和其他與語言相關(guān)的字符串遵守 setlocale() 設(shè)置的當(dāng)前區(qū)域設(shè)置。
在每次調(diào)用日期/時間函數(shù)時，如果時區(qū)無效則會引發(fā) E_NOTICE 錯誤。參見
date_default_timezone_set()。
由于輸出依賴于 C 庫，所以一些轉(zhuǎn)換標(biāo)記并不被支持。
在 Windows 上，使用未知的轉(zhuǎn)換標(biāo)記將導(dǎo)致
5 E_WARNING 信息，并返回 false。
在其他的操作系統(tǒng)上，你可能不能得到任何 E_WARNING 信息，
并且可能輸出未經(jīng)轉(zhuǎn)換的轉(zhuǎn)換標(biāo)記。
| 版本 | 說明 |
|---|---|
| 5.1.0 |
現(xiàn)在發(fā)布 |
如果你的系統(tǒng)里安裝了各自的語言環(huán)境則下例能夠正常運行。
示例 #1 strftime() 區(qū)域的例子
<?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");
?>
示例 #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 */
// 輸出： 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";
// 輸出： 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";
// 輸出： 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";
// 輸出： 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 */
// 輸出： 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";
// 輸出： 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";
// 輸出： 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";
// 輸出： 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";
?>
示例 #3 %e 修改器跨平臺兼容的例子
<?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#', '</refsect1>%#d', $format);
}
echo strftime($format);
?>
示例 #4 顯示所有已知和未知的格式
<?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' => '',
'l' => 'Hour in 12-hour format, with a space preceeding 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";
}
?>
以上例程的輸出類似于：
Known format : 'A' = 'Friday' ( A full textual representation of the day )
Known format : 'B' = 'December' ( Full month name, based on the locale )
Known format : 'H' = '11' ( Two digit representation of the hour in 24-hour format )
Known format : 'I' = '11' ( Two digit representation of the hour in 12-hour format )
Known format : 'M' = '24' ( Two digit representation of the minute )
Known format : 'S' = '44' ( Two digit representation of the second )
Known format : 'U' = '48' ( Week number of the given year, starting with the first Sunday as the first week )
Known format : 'W' = '48' ( A numeric representation of the week of the year, starting with the first Monday as the first week )
Known format : 'X' = '11:24:44' ( Preferred time representation based on locale, without the date )
Known format : 'Y' = '2010' ( Four digit representation for the year )
Known format : 'Z' = 'GMT Standard Time' ( The time zone offset/abbreviation option NOT given by %z (depends on operating system) )
Known format : 'a' = 'Fri' ( An abbreviated textual representation of the day )
Known format : 'b' = 'Dec' ( Abbreviated month name, based on the locale )
Known format : 'c' = '12/03/10 11:24:44' ( Preferred date and time stamp based on local )
Known format : 'd' = '03' ( Two-digit day of the month (with leading zeros) )
Known format : 'j' = '337' ( Day of the year, 3 digits with leading zeros )
Known format : 'm' = '12' ( Two digit representation of the month )
Known format : 'p' = 'AM' ( UPPER-CASE "AM" or "PM" based on the given time )
Known format : 'w' = '5' ( Numeric representation of the day of the week )
Known format : 'x' = '12/03/10' ( Preferred date representation based on locale, without the time )
Known format : 'y' = '10' ( Two digit representation of the year )
Known format : 'z' = 'GMT Standard Time' ( Either the time zone offset from UTC or the abbreviation (depends on operating system) )
Known format : '%' = '%' ( A literal percentage character ("%") )
Unknown format : 'C' ( Two digit representation of the century (year divided by 100, truncated to an integer) )
Unknown format : 'D' ( Same as "%m/%d/%y" )
Unknown format : 'E'
Unknown format : 'F' ( Same as "%Y-%m-%d" )
Unknown format : 'G' ( The full four-digit version of %g )
Unknown format : 'J'
Unknown format : 'K'
Unknown format : 'L'
Unknown format : 'N'
Unknown format : 'O'
Unknown format : 'P' ( lower-case "am" or "pm" based on the given time )
Unknown format : 'Q'
Unknown format : 'R' ( Same as "%H:%M" )
Unknown format : 'T' ( Same as "%H:%M:%S" )
Unknown format : '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 )
Unknown format : 'e' ( Day of the month, with a space preceding single digits )
Unknown format : 'f'
Unknown format : 'g' ( Two digit representation of the year going by ISO-8601:1988 standards (see %V) )
Unknown format : 'h' ( Abbreviated month name, based on the locale (an alias of %b) )
Unknown format : 'i'
Unknown format : 'k'
Unknown format : 'l' ( Hour in 12-hour format, with a space preceeding single digits )
Unknown format : 'n' ( A newline character ("\n") )
Unknown format : 'o'
Unknown format : 'q'
Unknown format : 'r' ( Same as "%I:%M:%S %p" )
Unknown format : 's' ( Unix Epoch Time timestamp )
Unknown format : 't' ( A Tab character ("\t") )
Unknown format : 'u' ( ISO-8601 numeric representation of the day of the week )
Unknown format : 'v'
注意: %G 和 %V，如果數(shù)字編號系統(tǒng)未能充分理解，基于 ISO 8601:1988 的星期數(shù)可能得出未預(yù)期的結(jié)果。見上面的 %V 和以下的例子。