Type Method


Creates a new calendar specified by a given identifier.


+ (NSCalendar *)calendarWithIdentifier:(NSCalendarIdentifier)calendarIdentifierConstant;



The identifier for the new calendar. For valid identifiers, see Calendar Identifiers.

Return Value

The initialized calendar, or nil if the identifier is unknown (if, for example, it is either an unrecognized string or the calendar is not supported by the current version of the operating system).


The returned calendar defaults to the current locale and default time zone.

See Also

Creating and Initializing Calendars

- initWithCalendarIdentifier:

Initializes a calendar according to a given identifier.


The supported calendar types.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software