PHP | función date_sunset()

El date_sunset() es una función incorporada en PHP que se utiliza para encontrar la hora del atardecer para un día y una ubicación específicos.

Sintaxis:

date_sunset ( $timestamp, $format, $latitude, $longitude, $zenith, $gmtoffset )

Parámetros: esta función acepta cuatro parámetros, como se mencionó anteriormente y se describe a continuación.

• $timestamp: es un parámetro obligatorio que especifica la marca de tiempo del día del que se toma la hora del atardecer.
• $formato: es un parámetro opcional que especifica el formato para devolver el resultado. El formato de devolución se proporciona a continuación:
  • SUNFUNCS_RET_STRING: Devuelve una string. por ejemplo, 16:46 (por defecto)
  • SUNFUNCS_RET_DOUBLE: Devuelve un flotante. por ejemplo, 16.12345
  • SUNFUNCS_RET_TIMESTAMP: Devuelve el resultado como un número entero (marca de tiempo). por ejemplo 987123569
• $latitud: es un parámetro opcional que especifica la latitud de la ubicación. De forma predeterminada, se establece como Norte. Para especificar un valor para Sur, pase un valor negativo.
• $longitude: es un parámetro opcional que especifica la longitud de la ubicación. De forma predeterminada, se establece como Este. Para modificar un valor para Oeste, pase un valor negativo.
• $cenit: Es un parámetro Opcional. El cenit es el ángulo entre el centro del sol y una línea perpendicular a la superficie terrestre, por defecto es date.sunset_zenith .
• $gmtoffset: es un parámetro opcional y se usa para especificar la diferencia entre GMT y la hora local en horas.

Valor devuelto: Devuelve la hora de la puesta del sol, en el formato especificado, en caso de éxito. FALSO en caso de falla.

Excepciones: esta función genera un error E_NOTICE si la función de fecha/hora no es válida y E_STRICT o E_WARNING si se usa la configuración del sistema o la variable de entorno TZ.

Los siguientes programas ilustran la función date_sunset() en PHP.

Programa 1:

<?php
// PHP program to show sunset time 
// of New delhi india for current day
  
// Longitude and latitude of Delhi India
// 28.6139° N, 77.2090° E
// GMT(Greenwich Mean Time) +5.30
// Zenith ~= 90
  
echo date("D M d Y");
echo("\nSunset time: ");
echo(date_sunset(time(), SUNFUNCS_RET_STRING,
                 28.6139, 77.2090, 90, 5.30));
?>

Wed Jun 27 2018
Sunset time: 19:07

Programa 2:

<?php
// PHP program to show sunset time 
// of GFG Noida for a Current day
  
// Longitude and latitude of GeeksforGeeks
// Noida 28°30'04.0"N 77°24'36.0"E
// GMT(Greenwich Mean Time) +5.30
// Zenith ~= 90
  
echo date("D M d Y");
echo("\nSunset time: ");
echo(date_sunset(time(), SUNFUNCS_RET_STRING,
              28.501120, 77.409989, 90, 5.30));
?>

Wed Jun 27 2018
Sunset time: 19:06

Artículos relacionados:

• PHP | función date_sunrise()
• PHP | función date_modify()

Referencia: http://php.net/manual/en/function.date-sunset.php