calendar

Calendar for specified month

Syntax

calendar

calendar(y,m)

calendar(d)

c = calendar

c = calendar(___)

Description

calendar displays a calendar for the current month in a traditional format. The weeks run from Sunday to Saturday, with Sunday as the first column. The display format includes a header that shows the month, year, and abbreviated names for the days of the week.

calendar(y,m) displays a calendar for the specified month m in the year y.

calendar(d) displays a calendar for the month associated with d, where d is a datetime value or a text timestamp that specifies a year, month, and day.

c = calendar returns a calendar for the current month as a 6-by-7 numeric matrix. The matrix has no header.

c = calendar(___) returns a calendar for the specified month as a 6-by-7 numeric matrix.

Examples

Calendar for Current Month

Display a calendar for the current month. The display format includes a header with the month name, year, and days of the week.

calendar

                   Sep 2024
     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     0     0     0     0     0
     0     0     0     0     0     0     0

Return the calendar as a numeric matrix. The matrix has no header.

c = calendar

c = 6×7

     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     0     0     0     0     0
     0     0     0     0     0     0     0

Specify Month and Year

Display a calendar for December 1999.

calendar(1999,12)

                   Dec 1999
     S     M    Tu     W    Th     F     S
     0     0     0     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    31     0
     0     0     0     0     0     0     0

Specify datetime Value or Text Timestamp

Create a datetime value. Then display a calendar for the month and year specified by that datetime value.

d = datetime("now")

d = datetime
   05-Sep-2024 14:53:13

calendar(d)

                   Sep 2024
     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     0     0     0     0     0
     0     0     0     0     0     0     0

You can also specify a text timestamp as the input argument. Display a calendar for January 2022, the month and year specified by "2022-01-01".

d = "2022-01-01"

d = 
"2022-01-01"

calendar(d)

                   Jan 2022
     S     M    Tu     W    Th     F     S
     0     0     0     0     0     0     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    31     0     0     0     0     0

Input Arguments

y — Year number

nonnegative integer

Year number, specified as a nonnegative integer.

m — Month number

positive integer between 1 and 12

Month number, specified as a positive integer between 1 and 12. The month numbers correspond to the months listed in the table.

Month Number	Month Name
1	January
2	February
3	March
4	April
5	May
6	June
7	July
8	August
9	September
10	October
11	November
12	December

d — Month and year

datetime scalar | text timestamp

Month and year, specified as a datetime scalar or text timestamp whose format includes a year, month, and day. The hour, minute, and second components are ignored.

To support existing code, calendar also accepts serial date numbers as inputs, but they are not recommended. For more information, see Version History.

Data Types: datetime | string | char

Limitations

• MATLAB^® Online™ determines the current month from Coordinated Universal Time (UTC) rather than from local time.

Version History

Introduced before R2006a

R2022b: Serial date number inputs are not recommended

Using calendar with serial date numbers as inputs is not recommended. Use the datetime data type to represent points in time instead. The datetime data type provides flexible date and time formats, storage out to nanosecond precision, and properties to account for time zones and daylight saving time.

You can convert serial date numbers to datetime values by using the datetime function. Display a calendar using a datetime value.

d = datetime(738522,"ConvertFrom","datenum")

d = datetime
   01-Jan-2022

calendar(d)

                   Jan 2022
     S     M    Tu     W    Th     F     S
     0     0     0     0     0     0     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    31     0     0     0     0     0

There are no plans to remove support for serial date numbers.