PHP | localtime()函数

简介

localtime() 函数是 PHP 中用于获取当地时间的函数。它将时间戳转换为当地时间并返回一个表示时间的数组。

语法

localtime($timestamp, $isAssociativeArray = false)

参数

• $timestamp：必需，表示要转换为当地时间的时间戳。
• $isAssociativeArray：可选，布尔值，默认为 false。如果设置为 true，则返回一个关联数组，其中包含表示每个时间单位的键（如 tm_sec、tm_min 等）以及它们的值。如果设置为 false，则返回一个索引数组，其中包含相同的值，但没有相应的键。

返回值

如果 $isAssociativeArray 为 false，则 localtime() 函数返回一个由以下元素组成的索引数组：

• [0]：表示当前年份（从 1900 年开始计算）。
• [1]：表示当前月份（0 到 11）。
• [2]：表示当前月份中的第几天（1 到 31）。
• [3]：表示当前小时数（0 到 23）。
• [4]：表示当前分钟数（0 到 59）。
• [5]：表示当前秒数（0 到 59）。

如果 $isAssociativeArray 为 true，则 localtime() 函数返回一个由以下元素组成的关联数组：

• tm_sec：表示当前秒数（0 到 59）。
• tm_min：表示当前分钟数（0 到 59）。
• tm_hour：表示当前小时数（0 到 23）。
• tm_mday：表示当前月份中的第几天（1 到 31）。
• tm_mon：表示当前月份（0 到 11）。
• tm_year：表示当前年份（从 1900 年开始计算）。
• tm_wday：表示当前星期几（0 表示星期日，1 表示星期一，以此类推）。
• tm_yday：表示当前年份中的第几天（0 到 365）。
• tm_isdst：表示当前时区的夏令时状态（0 表示非夏令时，1 表示夏令时，-1 表示状态未知）。

示例

$timestamp = time();

// 返回索引数组
$localtime = localtime($timestamp);
print_r($localtime);
// 输出：Array ( [0] => 119 [1] => 1 [2] => 1 [3] => 16 [4] => 2 [5] => 59 )

// 返回关联数组
$localtime = localtime($timestamp, true);
print_r($localtime);
// 输出：Array ( [tm_sec] => 59 [tm_min] => 2 [tm_hour] => 16 [tm_mday] => 1 [tm_mon] => 1 [tm_year] => 119 [tm_wday] => 2 [tm_yday] => 31 [tm_isdst] => -1 )

注意事项

• $timestamp 参数必须为时间戳，否则将出现错误。
• $isAssociativeArray 参数默认为 false，如果需要返回关联数组，请将其设置为 true。
• 在某些情况下，由于夏令时等因素，localtime() 函数可能无法正确确定某些日期和时间的值。

结语

localtime() 函数可用于获得当地时间，并以数组的形式返回各个时间单位的值。您可以使用此函数来构建日期和时间字符串或进行其他日期和时间相关的操作。要了解更多 PHP 日期和时间函数，请访问 PHP 官方文档。