cal(1)

cal(1)

NAME

cal - print calendar

SYNOPSIS

cal [ [ month ] year ]

DESCRIPTION

cal prints a calendar for the speci®ed year. If a month is also speci®ed, a calendar just for that month is printed. If neither is speci®ed, a calendar for the present month is printed. year can be between 1 and 9999. month is a decimal number between 1 and 12. The calendar produced is a Gregorian calendar.

EXTERNAL INFLUENCES

Environment Variables

LANG determines the locale to use for the locale categories when both LC_ALL and the corresponding environment variable (beginning with LC_) do not specify a locale. If LANG is not set or is set to the empty string, a default of "C" (see lang(5)) is used.

LC_CTYPE determines the locale for interpretation of sequences of bytes of text data as characters (e.g., single- verses multibyte characters in arguments and input ®les).

LC_TIME determines the format and contents of the calendar.

TZ determines the timezone used to calculate the value of the current month.

If any internationalization variable contains an invalid setting, cal behaves as if all internationalization variables are set to "C". See environ(5).

International Code Set Support

Single- and multi-byte character code sets are supported.

EXAMPLES

The command:

cal 9 1850

prints the calendar for September, 1850 on the screen as follows:

 

September

1850

 

 

 

S

M

Tu

W

Th

F

S

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

 

 

 

 

 

However, for XPG4 the output looks like below:

 

 

 

Sep 1850

 

 

Sun

Mon

Tue

Wed

Thu

Fri

Sat

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

 

 

 

 

 

WARNINGS

The year is always considered to start in January even though this is historically naive.

Beware that cal 83 refers to the early Christian era, not the 20th century.

STANDARDS CONFORMANCE

cal: SVID2, SVID3, XPG2, XPG3, XPG4

c

HP-UX Release 11i: December 2000

− 1 −

Section 157