date_sunrise

(PHP 5, PHP 7, PHP 8)

date_sunrise — 주어진 날짜와 위치의 일출 시간을 반환합니다.

경고 이 함수는 PHP 8.1.0부터 더 이상 사용되지 않습니다. 이 함수에 의존하는 것은 매우 권장되지 않습니다.


설명

date_sunrise(
    int $timestamp,
    int $returnFormat = SUNFUNCS_RET_STRING,
    ?float $latitude = null,
    ?float $longitude = null,
    ?float $zenith = null,
    ?float $utcOffset = null
): string|int|float|false
                

date_sunrise()는 지정된 날짜(timestamp로 지정됨) 및 위치의 일출 시간을 반환합니다.


매개변수

timestamp
일출 시간을 가져온 날짜의 timestamp입니다.
returnFormat

returnFormat 상수

상수 설명 예시
SUNFUNCS_RET_STRING 결과를 문자열로 반환 16:46
SUNFUNCS_RET_DOUBLE 결과를 float로 반환 16.78243132
SUNFUNCS_RET_TIMESTAMP 결과를 int(타임스탬프)로 반환 1095034606
latitude
기본값은 북쪽이고 남쪽에는 음수 값을 전달합니다. 참조: date.default_latitude
longitude
기본값은 동쪽이고 서쪽에는 음수 값을 전달합니다. 참조: date.default_longitude
zenith
zenith은 태양의 중심과 지표면에 수직인 선 사이의 각도입니다. 기본값은 date.sunrise_zenith입니다.

일반적인 zenith 각도

Angle 설명
90°50' 일출: 태양이 보이는 지점.
96° Civil twilight: conventionally used to signify the start of dawn.
102° Nautical twilight: the point at which the horizon starts being visible at sea.
108° Astronomical twilight: the point at which the sun starts being the source of any illumination.
utcOffset
시간으로 지정됩니다. returnFormatSUNFUNCS_RET_TIMESTAMP인 경우 utcOffset은 무시됩니다.

오류/예외

날짜/시간 함수에 대한 모든 호출은 시간대가 유효하지 않은 경우 E_WARNING을 생성합니다. date_default_timezone_set()도 참조하십시오.


반환 값

성공하면 지정된 returnFormat으로 일출 시간을 반환하고 실패하면 false를 반환합니다. 실패의 한 가지 잠재적인 이유는 태양이 전혀 뜨지 않기 때문이며, 이는 일년 중 일부 동안 북극권 내부에서 발생합니다.


변경 로그

버전 설명
8.1.0 이 함수는 date_sun_info()를 위해 더 이상 사용되지 않습니다.
8.0.0 latitude, longitude, zenithutcOffset은 이제 null을 허용합니다.

Examples

예제 #1 date_sunrise() 예제

                  
<?php

/* calculate the sunrise time for Lisbon, Portugal
Latitude: 38.4 North
Longitude: 9 West
Zenith ~= 90
offset: +1 GMT
*/

echo date("D M d Y"). ', sunrise time : ' .date_sunrise(time(), SUNFUNCS_RET_STRING, 38.4, -9, 90, 1);

?>
                  
                

위의 예는 다음과 유사한 결과를 출력합니다.

Mon Dec 20 2004, sunrise time : 08:54
                

예제 #2 No sunrise

                  
<?php
$solstice = strtotime('2017-12-21');
var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
?>
                  
                

위의 예는 다음을 출력합니다.

bool(false)
                

기타

  • date_sunset() - 주어진 날짜와 위치에 대한 일몰 시간을 반환합니다.
  • date_sun_info() - 일몰/일출 및 황혼 시작/종료에 대한 정보가 있는 배열을 반환합니다.