date_sunset()

1. 定义

该函数返回指定日期和地点的日落时间。

2. 语法

date_sunset ( int $timestamp [, int $format = SUNFUNCS_RET_STRING [, float $latitude = ini_get("date.default_latitude") [, float $longitude = ini_get("date.default_longitude") [, float $zenith = ini_get("date.sunset_zenith") [, float $gmt_offset = 0 ]]]]] ) : mixed

3. 参数说明

参数 可选性 数据类型 描述
$timestamp 必需 整型 指定日期的时间戳
$format 可选 整型 返回值的类型,默认为SUNFUNCS_RET_STRING
$latitude 可选 浮点型 指定地点的纬度,默认方向为北纬,指定南纬需加上负号。默认纬度为php.ini中的配置值
$longitude 可选 浮点型 指定地点的经度,默认方向为东经,指定西经需加上负号。默认经度为php.ini中的配置值
$zenith 可选 浮点型 指定地点的极点,默认为php.ini中的配置值
$gmt_offset 可选 浮点型 指定的格林威治偏差值(时差),默认为0

其中,$format有三个可选项:

  • SUNFUNCS_RET_STRING:默认值,以字符串形式返回结果
  • SUNFUNCS_RET_DOUBLE:以浮点数形式返回结果
  • SUNFUNCS_RET_TIMESTAMP:以整型时间戳形式返回结果

4. 示例

<?php

// date_sunset()
// 返回指定日期和地点的日落时间

$res = date_sunset(time(), SUNFUNCS_RET_STRING, 30.274, 120.155);
var_dump($res);// 输出:string(5) "18:29"

$res = date_sunset(time(), SUNFUNCS_RET_STRING, 120.155, 30.274);
var_dump($res);// 输出:string(5) "22:41"

5. 延展阅读