← Back to branch summary

~ubuntu-branches/ubuntu/quantal/lunar/quantal

« back to all changes in this revision

Viewing changes to lunar.1

  • Committer: Bazaar Package Importer
  • Author(s): Anthony Fok
  • Date: 2002-10-19 02:00:36 UTC
  • Revision ID: james.westby@ubuntu.com-20021019020036-3fuqqe7lmv3blwcc
Tags: upstream-2.2
Import upstream version 2.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
lunar.1
 
1
.TH lunar 1 "28 October 2001"
 
2
.SH NAME
 
3
lunar (version 2.2) \- a calendar conversion utility
 
4
.SH SYNTAX
 
5
.B lunar
 
6
[
 
7
.B\-h
 
8
] [
 
9
.B\-b
 
10
] [
 
11
.B\-i
 
12
] [
 
13
.B\-l
 
14
]
 
15
.I year month day
 
16
[
 
17
.I hour
 
18
]
 
19
.SH DESCRIPTION
 
20
The
 
21
.PN lunar
 
22
program performs date conversion between the Gregorian Solar Calendar (SC)
 
23
and the Chinese Lunar Calendar (LC).
 
24
Given a date in either calendar, the program also
 
25
outputs the corresponding "shengxiao" (animal of the year)
 
26
and "ganzhi" characters.
 
27
The date range currently covered is from about 1900 A.D. to 2049 A.D.
 
28
.PP
 
29
For the sake of convenience, we choose the convention such that the solar 
 
30
and lunar year numbers of the first day of a lunar year are the same.
 
31
For example, SC 1991.2.15 is LC 1991.1.1,
 
32
while SC 1991.2.14 is LC 1990.12.30.
 
33
Moreover, we choose the convention such that the solar and lunar hour numbers
 
34
(in 24-hour clock) of a date are the same, although a lunar day starts
 
35
at 23:00 of a solar day. This means that SC 1991.2.15.23 is LC 1991.1.2.23,
 
36
while SC 1991.2.16.0 is LC 1991.1.2.0,
 
37
and SC 1991.2.16.1 is LC 1991.1.2.1.
 
38
.PP
 
39
The standard time of the Lunar Calendar is
 
40
Beijing (Hong Kong) Standard Time, not GMT.
 
41
Be sure to adjust appropriately for other time zones
 
42
and "Day-light Saving Time".
 
43
.PP
 
44
In the Lunar Calendar,
 
45
a normal year has 12 months, and a leap year (run-nian) has 13 months,
 
46
where the extra month is called a "leap month" (run-yue).
 
47
For example, the leap month that follows immediately the 6-th lunar month
 
48
is called the 6-th leap month.
 
49
A (leap) month is either a short or long one, which has 29 or 30 days
 
50
respectively.
 
51
.PP
 
52
There are 10 gan's and 12 zhi's.
 
53
The ganzhi labeling of the year, month, day and hour of a date
 
54
is a member of the Cartesian product GxGxGxG, where G = {1,2,...,60}.
 
55
For example, "jia-zi" is 1, "yi-chou" is 2, and so on.
 
56
The ganzhi of the j-th leap month is the same as that of the j-th month.
 
57
 
 
58
The possible options are
 
59
.IP b
 
60
output ganzhi in special "bitmap" characters.
 
61
.IP h
 
62
output hanzi or Chinese characters encoded in (highest-bit-set) GB code.
 
63
.IP i
 
64
convert a lunar date to solar date.
 
65
The default is to convert a solar date to a lunar date.
 
66
.IP l
 
67
indicate the month is a lunar leap month.
 
68
This option is meaningful only when the "-i" option is used.
 
69
.SH COPYRIGHT
 
70
Copyright (C) 1988, 1989, 1991, 1992, 2001 Fung F. Lee and Ricky Yeung 
 
71
.sp
 
72
This program is free software; you can redistribute it and/or
 
73
modify it under the terms of the GNU General Public License
 
74
as published by the Free Software Foundation; either version 2
 
75
of the License, or any later version.
 
76
 
 
77
This program is distributed in the hope that it will be useful,
 
78
but WITHOUT ANY WARRANTY; without even the implied warranty of
 
79
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
80
GNU General Public License for more details.
 
81
 
 
82
You should have received a copy of the GNU General Public License
 
83
along with this program; if not, write to the Free Software Foundation,
 
84
Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 
85
 
 
86
The last version of this program was released on July 23, 1992 as
 
87
version 2.1a.  This program was first released under the terms of 
 
88
GNU GPL on October 28, 2001 as version 2.2. Both versions are identical
 
89
except for the license text.
 
90
 
 
91
 
 
92
.SH AUTHORS
 
93
Fung F. Lee and Ricky Yeung
 
94
.SH ACKNOWLEDGEMENT
 
95
The special "bitmap" file "lunar.bitmap" was contributed by Weimin Liu.
 
96
 
 
97
Special thanks to Hwei Chen Ti who extended the tables from 2001 to 2049.
 
98
.SH BUGS
 
99
Bug reports and comments should be sent to lee@umunhum.stanford.edu.
 
100
.SH DISCLAIMER
 
101
This software has no connection with our employers.
 
102