maybe I am wrong, but I think
SUNFUNCS_RET_TIMESTAMP return GMT(0) time
SUNFUNCS_RET_STRING Return local time
SUNFUNCS_RET_DOUBLE Return local time
PHP - Manual: date_sun_info
2024-11-15
date_sun_info
(PHP 5 >= 5.1.2, PHP 7, PHP 8)
date_sun_info — Returns an array with information about sunset/sunrise and twilight begin/end
说明
date_sun_info(int
$timestamp, float $latitude, float $longitude): array参数
-
timestamp -
Unix timestamp.
-
latitude -
Latitude in degrees.
-
longitude -
Longitude in degrees.
返回值
Returns array on success 或者在失败时返回 false.
The structure of the array is detailed in the following list:
-
sunrise - The timestamp of the sunrise (zenith angle = 90°35').
-
sunset - The timestamp of the sunset (zenith angle = 90°35').
-
transit - The timestamp when the sun is at its zenith, i.e. has reached its topmost point.
-
civil_twilight_begin -
The start of the civil dawn (zenith angle = 96°). It ends at
sunrise. -
civil_twilight_end -
The end of the civil dusk (zenith angle = 96°). It starts at
sunset. -
nautical_twilight_begin -
The start of the nautical dawn (zenith angle = 102°). It ends at
civil_twilight_begin. -
nautical_twilight_end -
The end of the nautical dusk (zenith angle = 102°). It starts at
civil_twilight_end. -
astronomical_twilight_begin -
The start of the astronomical dawn (zenith angle = 108°). It ends at
nautical_twilight_begin. -
astronomical_twilight_end -
The end of the astronomical dusk (zenith angle = 108°). It starts at
nautical_twilight_end.
The values of the array elements are either UNIX timestamps, false if the
sun is below the respective zenith for the whole day, or true if the sun is
above the respective zenith for the whole day.
更新日志
| 版本 | 说明 |
|---|---|
| 7.2.0 | The calculation was fixed with regards to local midnight instead of local noon, which changes the results slightly. |
范例
示例 #1 A date_sun_info() example
<?php
$sun_info = date_sun_info(strtotime("2006-12-12"), 31.7667, 35.2333);
foreach ($sun_info as $key => $val) {
echo "$key: " . date("H:i:s", $val) . "\n";
}
?>
以上例程会输出：
sunrise: 05:52:11 sunset: 15:41:21 transit: 10:46:46 civil_twilight_begin: 05:24:08 civil_twilight_end: 16:09:24 nautical_twilight_begin: 04:52:25 nautical_twilight_end: 16:41:06 astronomical_twilight_begin: 04:21:32 astronomical_twilight_end: 17:12:00
示例 #2 Polar night
<?php
var_dump(date_sun_info(strtotime("2017-12-21"), 90, 0));
?>
以上例程会输出：
array(9) {
["sunrise"]=>
bool(false)
["sunset"]=>
bool(false)
["transit"]=>
int(1513857490)
["civil_twilight_begin"]=>
bool(false)
["civil_twilight_end"]=>
bool(false)
["nautical_twilight_begin"]=>
bool(false)
["nautical_twilight_end"]=>
bool(false)
["astronomical_twilight_begin"]=>
bool(false)
["astronomical_twilight_end"]=>
bool(false)
}
示例 #3 Midnight sun
<?php
var_dump(date_sun_info(strtotime("2017-06-21"), 90, 0));
?>
以上例程会输出：
array(9) {
["sunrise"]=>
bool(true)
["sunset"]=>
bool(true)
["transit"]=>
int(1498046510)
["civil_twilight_begin"]=>
bool(true)
["civil_twilight_end"]=>
bool(true)
["nautical_twilight_begin"]=>
bool(true)
["nautical_twilight_end"]=>
bool(true)
["astronomical_twilight_begin"]=>
bool(true)
["astronomical_twilight_end"]=>
bool(true)
}
add a note
User Contributed Notes 4 notes
nospam at nomail dot com ¶
4 years ago
mother at localsnow dot com ¶
11 years ago
We needed the length of the day, both sunrise to sunset and twilight to twilight for particular latitudes. Sun_info() is just the thing. We mistakenly thought 'transit' was this value, which it is not. Transit is the time of day the sun is at its zenith. To get length of day, one must perform math on the results of sun_info().
When doing math with time values, don't expect date() to do the conversion to hours:minutes:seconds. date() thinks the passed value is a time since the epoch. You will need to do your own conversion to hours:minutes:seconds, using something like the following:
<?php
function hms($val) {
// convert seconds to hours:minutes:seconds
$v=$val;
$h=intval($v/3600);
$v-=($h*3600); // subtract hours
$m=intval($v/60);
$v-=($m*60); // subtract minutes
$s=$v % 60; // seconds remaining
if ($h<10) {$h="0".$h;}
if ($m<10) {$m="0".$m;}
if ($s<10) {$s="0".$s;}
return $h.":".$m.":".$s;
}
?>
Regarding date_sunrise() and date_sunset(), these both return values without seconds and without correction for Daylight time. Whereas sun_info() handles seconds as well as Daylight time. It even handles dates prior to the epoch correctly as negative timestamps, at least as of php 5.2.12
For example,
sun_info(strtotime('July 4, 1776'),47.3506,-122.6417)
produces something like the following when using date_default_timezone_set('America/Los_Angeles') and
date("H:i:s", $val)
sunrise: 04:20:26 [-6106016374]
sunset: 20:09:03 [-6105959457]
transit: 12:14:45 [-6105987915]
civil_twilight_begin: 03:40:54 [-6106018746]
civil_twilight_end: 20:48:35 [-6105957085]
nautical_twilight_begin: 02:46:58 [-6106021982]
nautical_twilight_end: 21:42:31 [-6105953849]
astronomical_twilight_begin: 01:28:06 [-6106026714]
astronomical_twilight_end: 23:01:23 [-6105949117]
* * *
info at mobger dot de ¶
1 year ago
The relation between timestamp and geoposition is not good defined.
My try of a definition is:
date_sun_info —
Returns an array with information about sunset/sunrise and twilight begin/end as Unix-Timestamp for the the geoposition, which must have the same (local) date as the timestamp in the parameter-block for the function `date_sun_info`.
<?php
<?php
$tStamp = strtotime('2020-12-04');
$latitude = 50;
echo("\n");
foreach([-181,-180,0,180,360] as $longitude ) {
foreach([-86401,-86400,-86399, -1,0,1,86399, 86400,86401] as $variTimeStamp) {
$sunInfoList = date_sun_info(($tStamp-$variTimeStamp),$latitude, $longitude);
$sunrise = new DateTime('@'.$sunInfoList['sunrise']);
echo($sunInfoList['sunrise']. ' => '.$sunrise->format('H:i:s d.m.Y').' || [ '.$variTimeStamp.' // ' . $longitude.'° ]');
echo("\n");
}
echo("\n");
}
?>
You may recognize the equivalence of `[ 0 // 360° ]` and `[ 86400 // 0° ]` in the results.
The result is:
<?php
/**
1607197612 => 19:46:52 05.12.2020 || [ -86401 // -181° ]
1607197612 => 19:46:52 05.12.2020 || [ -86400 // -181° ]
1607111141 => 19:45:41 04.12.2020 || [ -86399 // -181° ]
1607111141 => 19:45:41 04.12.2020 || [ -1 // -181° ]
1607111141 => 19:45:41 04.12.2020 || [ 0 // -181° ]
1607024668 => 19:44:28 03.12.2020 || [ 1 // -181° ]
1607024668 => 19:44:28 03.12.2020 || [ 86399 // -181° ]
1607024668 => 19:44:28 03.12.2020 || [ 86400 // -181° ]
1606938194 => 19:43:14 02.12.2020 || [ 86401 // -181° ]
1607197372 => 19:42:52 05.12.2020 || [ -86401 // -180° ]
1607197372 => 19:42:52 05.12.2020 || [ -86400 // -180° ]
1607110901 => 19:41:41 04.12.2020 || [ -86399 // -180° ]
1607110901 => 19:41:41 04.12.2020 || [ -1 // -180° ]
1607110901 => 19:41:41 04.12.2020 || [ 0 // -180° ]
1607024428 => 19:40:28 03.12.2020 || [ 1 // -180° ]
1607024428 => 19:40:28 03.12.2020 || [ 86399 // -180° ]
1607024428 => 19:40:28 03.12.2020 || [ 86400 // -180° ]
1606937953 => 19:39:13 02.12.2020 || [ 86401 // -180° ]
1607154137 => 07:42:17 05.12.2020 || [ -86401 // 0° ]
1607154137 => 07:42:17 05.12.2020 || [ -86400 // 0° ]
1607067665 => 07:41:05 04.12.2020 || [ -86399 // 0° ]
1607067665 => 07:41:05 04.12.2020 || [ -1 // 0° ]
1607067665 => 07:41:05 04.12.2020 || [ 0 // 0° ]
1606981191 => 07:39:51 03.12.2020 || [ 1 // 0° ]
1606981191 => 07:39:51 03.12.2020 || [ 86399 // 0° ]
1606981191 => 07:39:51 03.12.2020 || [ 86400 // 0° ]
1606894715 => 07:38:35 02.12.2020 || [ 86401 // 0° ]
1607197301 => 19:41:41 05.12.2020 || [ -86401 // 180° ]
1607197301 => 19:41:41 05.12.2020 || [ -86400 // 180° ]
1607110828 => 19:40:28 04.12.2020 || [ -86399 // 180° ]
1607110828 => 19:40:28 04.12.2020 || [ -1 // 180° ]
1607110828 => 19:40:28 04.12.2020 || [ 0 // 180° ]
1607024353 => 19:39:13 03.12.2020 || [ 1 // 180° ]
1607024353 => 19:39:13 03.12.2020 || [ 86399 // 180° ]
1607024353 => 19:39:13 03.12.2020 || [ 86400 // 180° ]
1606937877 => 19:37:57 02.12.2020 || [ 86401 // 180° ]
1607154065 => 07:41:05 05.12.2020 || [ -86401 // 360° ]
1607154065 => 07:41:05 05.12.2020 || [ -86400 // 360° ]
1607067591 => 07:39:51 04.12.2020 || [ -86399 // 360° ]
1607067591 => 07:39:51 04.12.2020 || [ -1 // 360° ]
1607067591 => 07:39:51 04.12.2020 || [ 0 // 360° ]
1606981115 => 07:38:35 03.12.2020 || [ 1 // 360° ]
1606981115 => 07:38:35 03.12.2020 || [ 86399 // 360° ]
1606981115 => 07:38:35 03.12.2020 || [ 86400 // 360° ]
1606894638 => 07:37:18 02.12.2020 || [ 86401 // 360° ]
*/
?>
ELY M. ¶
11 years ago
I have been working on my own php script to get current down or up for sun and moon. I had to add function for any places that have 24 hour sun.
here is my code for places with 24 hour sun.
<?php
if ($sunrise == 0 && $sunset == 0) {
$sunrise24 = "";
$sunset24 = "";
//run suninfo
$sunup = date_sun_info(strtotime($year."-".$month."-".$day), $lat, $lon);
}
//check if sun is up all day.
if ($sunup[sunrise] == 1 && $sunup[sunrise] == 1) {
imagecopy($sky, $sun, 60, 20, 0, 0, $sun_width, $sun_height);
imagefill($sky, 0, 0, $bluesky);
}
?>
官方地址：https://www.php.net/manual/en/function.date-sun-info.php
IT
PHP
编程语言
Linux
开发编程
科技
Elasticsearch
HTML/CSS/XML
网络
JAVA
NoSQL
数据库
面试
C/C++
Golang
Git
算法
操作系统
正则表达式
Redis
互联网
MySql
JavaScript
运维
软件
国际
架构设计
Mac OS
TCP/IP
Excel
Vim
Windows
Socket
Oracle
VR
MongoDB
Python
运营
MemCache
商业
硬件
电子
娱乐
设计
nginx
摄影
游戏
WordPress
HTTP
团建
数码电器
广告
--
php7 安装fileinfo扩展
preg_split — 通过一个正则表达式分隔字符串
php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题
[PHP] inet_pton/inet_ntop IP地址转换函数
array_multisort() 多字段排序
PHPMailer设置utf8 PHPMailer字符集CharSet
ADORecordSet对象
adodb手册
PHP 8.1
[鸟哥]PHP_INT_MIN 和 -9223372036854775808
opcache预加载
Composer的Packagist资源
mysql面试题
[鸟哥]PHP FFI详解 - 一种全新的PHP扩展方式
PHP7添加redis扩展
PHP mkdir()写出来的权限与mode值不符合
adodb连接mysql多个数据库的问题
常用的php ADODB使用方法集锦
Packagist / Composer 中国全量镜像
PHP获取指定函数定义在哪个文件中及行号