---
title: NSCalendarDate
framework: foundation
role: symbol
role_heading: Class
path: foundation/nscalendardate
---

# NSCalendarDate

A specialized date object with embedded calendar information.

## Declaration

```occ
@interface NSCalendarDate : NSDate
```

## Topics

### Instance Variables

- [refCount](foundation/nscalendardate/refcount.md)

### Instance Methods

- [calendarFormat](foundation/nscalendardate/calendarformat.md)
- [dateByAddingYears:months:days:hours:minutes:seconds:](foundation/nscalendardate/datebyaddingyears:months:days:hours:minutes:seconds:.md)
- [dayOfCommonEra](foundation/nscalendardate/dayofcommonera.md)
- [dayOfMonth](foundation/nscalendardate/dayofmonth.md)
- [dayOfWeek](foundation/nscalendardate/dayofweek.md)
- [dayOfYear](foundation/nscalendardate/dayofyear.md)
- [descriptionWithCalendarFormat:](foundation/nscalendardate/descriptionwithcalendarformat:.md)
- [descriptionWithCalendarFormat:locale:](foundation/nscalendardate/descriptionwithcalendarformat:locale:.md)
- [descriptionWithLocale:](foundation/nscalendardate/descriptionwithlocale:.md)
- [hourOfDay](foundation/nscalendardate/hourofday.md)
- [initWithString:](foundation/nscalendardate/initwithstring:.md)
- [initWithString:calendarFormat:](foundation/nscalendardate/initwithstring:calendarformat:.md)
- [initWithString:calendarFormat:locale:](foundation/nscalendardate/initwithstring:calendarformat:locale:.md)
- [initWithYear:month:day:hour:minute:second:timeZone:](foundation/nscalendardate/initwithyear:month:day:hour:minute:second:timezone:.md)
- [minuteOfHour](foundation/nscalendardate/minuteofhour.md)
- [monthOfYear](foundation/nscalendardate/monthofyear.md)
- [secondOfMinute](foundation/nscalendardate/secondofminute.md)
- [setCalendarFormat:](foundation/nscalendardate/setcalendarformat:.md)
- [setTimeZone:](foundation/nscalendardate/settimezone:.md)
- [timeZone](foundation/nscalendardate/timezone.md)
- [yearOfCommonEra](foundation/nscalendardate/yearofcommonera.md)
- [years:months:days:hours:minutes:seconds:sinceDate:](foundation/nscalendardate/years:months:days:hours:minutes:seconds:sincedate:.md)

### Type Methods

- [calendarDate](foundation/nscalendardate/calendardate.md)
- [dateWithString:calendarFormat:](foundation/nscalendardate/datewithstring:calendarformat:.md)
- [dateWithString:calendarFormat:locale:](foundation/nscalendardate/datewithstring:calendarformat:locale:.md)
- [dateWithYear:month:day:hour:minute:second:timeZone:](foundation/nscalendardate/datewithyear:month:day:hour:minute:second:timezone:.md)
- [distantFuture](foundation/nscalendardate/distantfuture.md)
- [distantPast](foundation/nscalendardate/distantpast.md)

## Relationships

### Inherits From

- [NSDate](foundation/nsdate.md)