github.com/e154/smart-home@v0.17.2-0.20240311175135-e530a6e5cd45/doc/content/en/docs/plugins/sun.md (about)

     1  
     2  ---
     3  title: "Sun"
     4  linkTitle: "sun"
     5  date: 2021-10-20
     6  description: >
     7    
     8  ---
     9  
    10  {{< figure src="/smart-home/sun1.png" width="300" >}}
    11  
    12  &nbsp;
    13  
    14  &nbsp;
    15  
    16  The "sun" plugin allows you to retrieve information about the current position and time of the sun based on the specified coordinates (latitude and longitude). It provides various parameters related to the position of the sun throughout the day, as well as sunrise, sunset, twilight, and other moments. The plugin's state can indicate whether the sun is above or below the horizon.
    17  
    18  Parameters:
    19  
    20  1. `horizonState`: Horizon state
    21  2. `phase`: Sun phase
    22  3. `azimuth`: Sun azimuth
    23  4. `elevation`: Sun elevation above the horizon
    24  5. `sunrise`: Sunrise time
    25  6. `sunset`: Sunset time
    26  7. `sunriseEnd`: Sunrise end time
    27  8. `sunsetStart`: Sunset start time
    28  9. `dawn`: Dawn time
    29  10. `dusk`: Dusk time
    30  11. `nauticalDawn`: Nautical dawn time
    31  12. `nauticalDusk`: Nautical dusk time
    32  13. `nightEnd`: Night end time
    33  14. `night`: Night time
    34  15. `goldenHourEnd`: Golden hour end time
    35  16. `goldenHour`: Golden hour time
    36  17. `solarNoon`: Solar noon time
    37  18. `nadir`: Nadir (minimum sun elevation above the horizon)
    38  
    39  Settings:
    40  1. `lat`: Latitude (geographic latitude)
    41  2. `lon`: Longitude (geographic longitude)
    42  
    43  States:
    44  1. `aboveHorizon`: The sun is above the horizon
    45  2. `belowHorizon`: The sun is below the horizon