Main Content

uicalendar

Graphical calendar

有限公司llapse all in page

Syntax

uicalendar(Name,Value)

Description

example

uicalendar(Name,Value)supports a customizable graphical calendar that interfaces with one or moreuicontrol.uicalendarpopulates one or moreuicontrolwith user-selected dates.

Note

As an alternative touicalendar, you can useuidatepicker.

Examples

有限公司llapse all

Create anuicontrol:

textH1 = uicontrol('style','edit','position', [10 10 100 20])
textH1 = UIControl with properties: Style: 'edit' String: '' BackgroundColor: [0.9400 0.9400 0.9400] Callback: '' Value: 0 Position: [10 10 100 20] Units: 'pixels'

Call UICalendar:

uicalendar('DestinationUI', {textH1,'string'})

Select a date and clickOK.

Alternatively, you can use datetime arrays forInitDateandHoliday.

uicalendar('InitDate',datetime('15-Mar-2015','Locale','en_US'),'Holiday',datetime('16-Mar-2015','Locale','en_US'))

Select a date and clickOK. For more information on usinguicalendarwith an application, seeExample of Using UICalendar with an Application.

Input Arguments

有限公司llapse all

Name-Value Arguments

Specify optional pairs of arguments asName1=Value1,...,NameN=ValueN, whereNameis the argument name andValueis the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and encloseNamein quotes.

Example:uicalendar('InitDate',datetime('15-Mar-2015','Locale','en_US'),'Holiday',datetime('16-Mar-2015','Locale','en_US'))

Flag to indicate nonbusiness days, specified using numeric values of0or1. The values are:

  • 0— (Default) Standard calendar without nonbusiness day indicators.

  • 1— Marks NYSE nonbusiness days in red.

Data Types:logical

Flag to indicate whether business and nonbusiness days, specified using numeric values of0or1. The values are:

  • 0 — Only allow selection of business days. Nonbusiness days are determined from the following parameters:

    • 'BusDays'

    • 'Holiday'

    • 'Weekend'

  • 1— (Default) Allows selections of business and nonbusiness days.

Data Types:logical

Color of date squares, specified using[date R G B], where[R G B]is the color.

Data Types:double

Color of numeric date number in the date square, specified using[date R G B], where[R G B]is the color.

Data Types:double

Destination object's handles, specified with valuesHor{H, {Prop}}. The values are:

  • H— Scalar or vector of the destination object's handles. The default UI property that is populated with the dates is a character vector.

  • {H, {Prop}}— Cell array of handles and the destination object's UI properties.Hmust be a scalar or vector andPropmust be a single property character vector or a cell array of property character vectors.

Data Types:char|cell

Holiday dates in calendar, specified using a scalar or vector of serial date numbers or datetime arrays. The corresponding date character vector of the holiday appears Red.

Data Types:double|datetime

Initial start date when calendar is initialized, specified with date values using a serial date number, datetime array, or date character vector. The values are:

  • Datenum— Numeric or datetime array date value specifying the initial start date when the calendar is initialized. The default date isTODAY.

  • Datestr— Date character vector value specifying the initial start date when the calendar is initialized.Datestrmust include a Year, Month, and Day (for example, 01-Jan-2006).

Data Types:double|char|datetime

Format of initial start date (InitDate), specified using a character vector. Seedatestrfor date format values.

Data Types:double|datetime

Format of output date, specified using a character vector. Seedatestrfor date format values.

Data Types:double|datetime

Style for output date, specified using a value of0,1,2, or3. The values are:

  • 0— (Default) Returns a single date character vector or a cell array (row) of date character vectors. For example,{'01-Jan-2001, 02-Jan-2001, ...'}.

  • 1— Returns a single date character vector or a cell (column) array of date character vectors. For example,{'01-Jan-2001; 02-Jan-2001; ...'}.

  • 2— Returns a character vector representation of a row vector of datenums. For example,'[732758, 732759, 732760, 732761]'.

  • 3— Returns a character vector representation of a column vector of datenums. For example,'[732758; 732759; 732760; 732761]'.

Data Types:double

Flag for date selection, specified with using a value of0or1. The values are:

  • 0— Allows multiple date selections.

  • 1— (Default) Allows only a single date selection.

Data Types:logical

定义周末,指定使用的价值1through7. Weekend days are marked in red.DayOfWeekcan be a vector containing the following numeric values:

  • 1— Sunday

  • 2— Monday

  • 3— Tuesday

  • 4— Wednesday

  • 5— Thursday

  • 6— Friday

  • 7— Saturday

Also this value can be a vector of length7有限公司ntaining0's and1's. The value1表示周末的一天。它的第一个元素vector corresponds to Sunday. For example, when Saturday and Sunday are weekend days thenWEEKEND=[1 0 0 0 0 0 1].

Data Types:double

Window figure properties, specified with using a character vector with a value ofNormalorModal. The values are:

  • Normal— (Default) Standard figure properties.

  • Modal— Modal figures remain stacked above all normal figures and the MATLAB®Command Window.

Data Types:char

Version History

Introduced before R2006a

See Also

||

Topics