函数文档

wp_exif_date2ts()

💡 云策文档标注

概述

wp_exif_date2ts() 函数用于将 Exif 格式的日期字符串转换为 Unix 时间戳。它接受一个 Exif 格式的日期字符串作为参数,并返回对应的 Unix 时间戳或失败时返回 false。

关键要点

  • 参数:$str,必需,一个 Exif 格式的日期字符串(格式为 Y:m:d H:i:s)。
  • 返回值:成功时返回 Unix 时间戳(int),失败时返回 false。
  • 函数内部通过 explode() 分割字符串,并使用 strtotime() 进行转换。
  • 该函数自 WordPress 2.5.0 版本引入。

代码示例

function wp_exif_date2ts( $str ) {
	list( $date, $time ) = explode( ' ', trim( $str ) );
	list( $y, $m, $d )   = explode( ':', $date );

	return strtotime( "{$y}-{$m}-{$d} {$time}" );
}

注意事项

  • 输入字符串必须严格遵循 Exif 格式 Y:m:d H:i:s,否则可能导致转换失败。
  • 函数依赖于 strtotime(),其行为可能受服务器时区设置影响。
  • 在 wp_read_image_metadata() 中被调用,用于处理图像元数据中的日期信息。

📄 原文内容

Converts the exif date format to a unix timestamp.

Parameters

$strstringrequired
A date string expected to be in Exif format (Y:m:d H:i:s).

Return

int|false The unix timestamp, or false on failure.

Source

function wp_exif_date2ts( $str ) {
	list( $date, $time ) = explode( ' ', trim( $str ) );
	list( $y, $m, $d )   = explode( ':', $date );

	return strtotime( "{$y}-{$m}-{$d} {$time}" );
}

Changelog

Version Description
2.5.0 Introduced.