1. 1
2. 2
3. 3
4. 4
5. 5
6. 6
7. 7
8. 8
9. 9
10. 10
11. 11
12. 12
13. 13
14. 14
15. 15
16. 16
17. 17
18. 18
19. 19
20. 20
21. 21
22. 22
23. 23
24. 24
25. 25
26. 26
27. 27
28. 28
29. 29
30. 30
31. 31
32. 32
33. 33
34. 34
35. 35
36. 36
37. 37
38. 38
39. 39
40. 40
41. 41
42. 42
43. 43
44. 44
45. 45
46. 46
47. 47
48. 48
49. 49
50. 50
51. 51
52. 52
53. 53
54. 54
55. 55
56. 56
57. 57
58. 58
59. 59
60. 60
61. 61
62. 62
63. 63
64. 64
65. 65
66. 66
67. 67
68. 68
69. 69
70. 70
71. 71
72. 72
73. 73
74. 74
75. 75
76. 76
77. 77
78. 78
79. 79
80. 80
81. 81
82. 82
83. 83
84. 84
85. 85
86. 86
87. 87
88. 88
89. 89
90. 90

// Copyright (C) 2025 Shota FUJI
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.
//
// SPDX-License-Identifier: GPL-3.0-only

= sunwait(1)
:docdate: 2025-07-20
:doctype: manpage
:mansource: sunwait

== Name

sunwait - Calculates sunrise or sunset times

== Synposis

*sunwait* [_options_] _<command>_ [_args_]

== Description

Sunwait calculates, displays, or waits for sunrise or sunset times at the given location.

See *sunwait-poll*(1), *sunwait-wait*(1), *sunwait-list*(1) and *sunwait-report*(1) for command specific document.

== Options

*--debug*::
	Prints debug logs. *wait* command exits in one minute if this option is set.

*--version*::
	Prints version number and exits.

*--help*::
	Prints help message to stdout and exits.

*--utc*::
	Prints and parses times in UTC timezone instead of local timzone.

*--lat* _<degree>_, *--latitude* _<degree>_::
_degree_ is a signed floating point number or a positive floating point number with N or S suffix.
Defaults to the latitude of Bingham, England.

*--lon* _<degree>_, *--longitude* _<degree>_::
_degree_ is a signed floating point number or a positive floating point number with E or W suffix.
Defaults to the longitude of Bingham, England.

*--twilight* _<type>_::
Sets a twilight type, which defines an angle of the Sun to consider twilight.
Valid values are:

* *daylight*      Top of the Sun just below (0 degrees) the horizon.
* *civil*         Civil twilight, top of the Sun 6 degrees below the horizon.
* *nautical*      Nautical twilight, top of the Sun 12 degrees below the horizon.
* *astronomical*  Astronomical twilight, top of the Sun 18 degrees below the horizon.
* _<degree>_        Custom angle as a floating point number. Can be negative.

*-o* _<duration>_, *--offset* _<duration>_::
Time offset to add to sunrise time and subtract from sunset time.
This offset value shifts sunrise and sunset time towards noon by the specified amount.
The value can be either of *MM* (minutes) or *HH:MM*, and can have hyphen to represent negative offset.

== Exit status

*0*    Command successfully ended.

*1*    Error, uncategorized or generic.

*10*   Out of memory.

*11*   Error during writing to stdout.

*12*   Error during writing to stderr.

*15*   Incorrect CLI usage, such as unknown option and invalid option value.

== See also

*sunwait-poll*(1), *sunwait-wait*(1), *sunwait-report*(1), *sunwait-list*(1)