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

// 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-list(1)
:docdate: 2025-07-21
:doctype: manpage
:mansource: sunwait

== Name

sunwait-list - Lists sunset and sunrise time

== Synposis

*sunwait* *list* [_DAYS_] [*--from* _<YYYY-MM-DD>_] ++[++[-e | --event _<event>_]...]

== Description

This command prints a list of clock time when sunset and/or sunrise happens to stdout.

== Options

*--from* _<YYYY-MM-DD>_::
Calendar date list starts at.
Defaults to today.


_DAYS_::
Prints report for _DAYS_ days from *--from*, inclusive.
Defaults to *1* (only today).

*-e* _<event>_, *--event* _<event>_::
Prints sunrise or sunset only when set.
If this option is not set, *sunwait* prints clock time of both, which is equivalent of,

+
[,shell]
----
sunwait list -e sunrise -e sunset
----

+
which means "list sunrise time and sunset time".
Valid values are:

* *sunrise*   Prints sunrise time, when the Sun rose and the twilight starts.
* *sunset*    Prints sunset time, when the Sun set past the twilight.

== Examples

List civil sunrise and sunset times for today and next 6 days in Moscow, Russia.

[,shell]
----
sunwait list 7 --twilight civil --lat 55.752163N --lon 37.617524E
----

== See also

*sunwait*(1)