Wednesday, November 18, 2020

PHP | date_sunrise() Function

PHP date_sunrise() Function


Hello dear readers! welcome back to another edition of our tutorial on PHP. In this tutorial guide, we are going to be discussing about the PHP date_sunrise() Function.

The PHP date_sunrise() function accepts a timestamp representing the given day and returns the sunrise time on that particular day.

Syntax

Following below is the syntax to use this function -

date_sunrise($timestamp, [$format, $latitude, $longitude, $zenith, $gmtoffset])


Parameter Details

Sr.NoParameter & Description
1

timestamp (Mandatory)

This specifies a timestamp.

2

format (Optional)

This specifies the format in which you need the resultant value in. You can pass three constants as the value of this parameter namely; SUNFUNCS_RET_STRING (string), SUNFUNCS_RET_DOUBLE (float) and, SUNFUNCS_RET_TIMESTAMP integer.

3

latitude (Optional)

This specifies latitude of a location by default, this specifies the North direction. To specify a latitude value in south you need to pass it as a negative value.

4

longitude (Optional)

This specifies longitude of a location by default, this specifies the East direction. To specify a latitude value in West you need to pass it as a negative value.

5

zenith (Optional)

This specifies zenith value. This specifies the angle between the line perpendicular to the earth's surface and the centre of the sun.


Return Value

This PHP function returns the time of the sunrise in a desired format. Incase of failure, it returns FALSE.

PHP Version

This function was first introduced as part of core PHP v 5.0 and, it works with all the later versions.

Example1

Following example illustrates the usage of the PHP date_sunrise() function -

<?php
   $sun_info = date_sunrise("02-17-2012");
   print_r($sun_info);
?>

Output

When the above code is executed, it will produce the following result -

04:39

Example2

Now let us invoke this function by passing the latitude and longitude values. If you intend passing the latitude and longitude values, it is compulsory to pass the value of the required format too -

<?php
   $sun_info = date_sunrise("02-03-2020",SUNFUNCS_RET_STRING, 23.4, -25);
   print_r("Sunrise Time: ".$sun_info);
?>

Output

When the above code is executed, it will produce the following result -

Sunrise Time: 08:21

Example3

The following example verifies the case of no sunrise -

<?php
   $sun_info = date_sunrise("25-12-2016",SUNFUNCS_RET_STRING, 69, 41);
   print("Sunrise Time: ".$sun_info);
   print("\n");
   var_dump($sun_info);
?>

Output

When the above code is executed, it will produce the following result -

Sunrise Time:
bool(false)

Example4

Try the following example -

<?php
   echo("Date: " . date("D M d Y"));
   echo("\n");
   echo("Sunrise time: ");
   echo(date_sunrise(time(),SUNFUNCS_RET_STRING,38.4,-9,90,1));
?>

Output

When the above code is executed, it will produce the following result -

Date: Thu May 07 2020
Sunrise time: 06:34


Alright guys! This is where we are rounding up for this tutorial post. In our next tutorial guide, we are going to be discussing about the PHP date_sunset() Function.

Do feel free to ask your questions where necessary and i will attend to them as soon as possible. If this tutorial was helpful to you, you can use the share button to share this tutorial.

Follow us on our various social media platforms to stay updated with our latest tutorials. You can also subscribe to our newsletter in order to get our tutorials delivered directly to your emails.

Thanks for reading and bye for now.
Share:

0 comments:

Post a Comment

Hello dear readers! Please kindly try your best to make sure your comments comply with our comment policy guidelines. You can visit our comment policy page to view these guidelines which are clearly stated. Thank you.