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

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

== Name

sunwait-report - Prints detailed report of sunrise and sunset times for the date

== Synposis

*sunwait* *report* [*y* _<years-since-2000>_] [*m* _<month>_] [*d* _<day-of-month>_]

== Description

This command prints detailed report on sunrise, sunset and other sun-related times for the date.
It by default targets current date, but you can override year, month, and/or day of month individually.

== Options

*y* _<years-since-2000>_::
Years since 2000. 0 to 99.
Defaults to the current year - 2000.

*m* _<month>_::
Month. 1 to 12.
Defaults to the current month.

*d* _<day-of-month>_::
Day of the month. 1 to 31.
Defaults to the current date's day of the month.

== Environment

*TZ*::
Generated report contains current timezone get by *localtime*(3) function, which refers to *TZ*.
If this variable is set, its value takes precedence over the system configured timezone.
See *tzset*(3) for timezone choosing algorithm.

== Examples

Produce a report of the different sunrises and sunsets on 2022/03/15 for Christmas Island, Australia.

[,shell]
----
sunwait report y 20 m 3 d 15 --lat 10.49S --lon 105.55E
----

== See also

*sunwait*(1)