<!--
{
  "availability" : [
    "iOS: 2.0.0 -",
    "iPadOS: 2.0.0 -",
    "macCatalyst: 13.0.0 -",
    "macOS: 10.0.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Foundation",
  "identifier" : "/documentation/Foundation/NSCalendar/Unit",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Foundation"
    ],
    "preciseIdentifier" : "c:@E@NSCalendarUnit"
  },
  "title" : "NSCalendar.Unit"
}
-->

# NSCalendar.Unit

Calendrical units such as year, month, day and hour.

```
struct Unit
```

## Overview

Calendar units may be used as a bit mask to specify a combination of units. Values in this enumeration are equal to the corresponding constants in `CFCalendarUnit`.

## Topics

### Initializers

[`init(rawValue:)`](/documentation/Foundation/NSCalendar/Unit/init(rawValue:))

Creates a new calendar unit from the raw value.

### Specifying Years and Months

[`NSCalendarUnitEra`](/documentation/Foundation/NSCalendar/Unit/era)

Identifier for the era unit.

[`NSCalendarUnitYear`](/documentation/Foundation/NSCalendar/Unit/year)

Identifier for the year unit.

[`NSCalendarUnitYearForWeekOfYear`](/documentation/Foundation/NSCalendar/Unit/yearForWeekOfYear)

Identifier for the week-counting year unit.

[`NSCalendarUnitQuarter`](/documentation/Foundation/NSCalendar/Unit/quarter)

Identifier for the quarter of the calendar.

[`NSCalendarUnitMonth`](/documentation/Foundation/NSCalendar/Unit/month)

Identifier for the month unit.

[`NSCalendarUnitIsLeapMonth`](/documentation/Foundation/NSCalendar/Unit/isLeapMonth)

Identifier for the time zone of a date components object.

### Specifying Weeks and Days

[`NSCalendarUnitWeekOfYear`](/documentation/Foundation/NSCalendar/Unit/weekOfYear)

Identifier for the week of the year calendar unit.

[`NSCalendarUnitWeekOfMonth`](/documentation/Foundation/NSCalendar/Unit/weekOfMonth)

Identifier for the week of the month calendar unit.

[`NSCalendarUnitWeekday`](/documentation/Foundation/NSCalendar/Unit/weekday)

Identifier for the weekday unit.

[`NSCalendarUnitWeekdayOrdinal`](/documentation/Foundation/NSCalendar/Unit/weekdayOrdinal)

Identifier for the ordinal weekday unit.

[`NSCalendarUnitDay`](/documentation/Foundation/NSCalendar/Unit/day)

Identifier for the day unit.

[`NSCalendarUnitDayOfYear`](/documentation/Foundation/NSCalendar/Unit/dayOfYear)

Identifier for the nanosecond unit.

[`NSCalendarUnitIsRepeatedDay`](/documentation/Foundation/NSCalendar/Unit/isRepeatedDay)

Identifier for the time zone of a date components object.

### Specifying Hours, Minutes, and Seconds

[`NSCalendarUnitHour`](/documentation/Foundation/NSCalendar/Unit/hour)

Identifier for the hour unit.

[`NSCalendarUnitMinute`](/documentation/Foundation/NSCalendar/Unit/minute)

Identifier for the minute unit.

[`NSCalendarUnitSecond`](/documentation/Foundation/NSCalendar/Unit/second)

Identifier for the second unit.

[`NSCalendarUnitNanosecond`](/documentation/Foundation/NSCalendar/Unit/nanosecond)

Identifier for the nanosecond unit.

### Specifying Calendars and Time Zones

[`NSCalendarUnitCalendar`](/documentation/Foundation/NSCalendar/Unit/calendar)

Identifier for the calendar of a date components object.

[`NSCalendarUnitTimeZone`](/documentation/Foundation/NSCalendar/Unit/timeZone)

Identifier for the time zone of a date components object.

### Deprecated

[`NSEraCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSEraCalendarUnit)

Specifies the era unit.

[`NSYearCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSYearCalendarUnit)

Specifies the year unit.

[`NSMonthCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSMonthCalendarUnit)

Specifies the month unit.

[`NSDayCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSDayCalendarUnit)

Specifies the day unit.

[`NSHourCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSHourCalendarUnit)

Specifies the hour unit.

[`NSMinuteCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSMinuteCalendarUnit)

Specifies the minute unit.

[`NSSecondCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSSecondCalendarUnit)

Specifies the second unit.

[`NSWeekCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSWeekCalendarUnit)

Specifies the week unit.

[`NSWeekdayCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSWeekdayCalendarUnit)

Specifies the weekday unit.

[`NSWeekdayOrdinalCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSWeekdayOrdinalCalendarUnit)

Specifies the ordinal weekday unit.

[`NSQuarterCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSQuarterCalendarUnit)

Specifies the quarter unit.

[`NSWeekOfMonthCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSWeekOfMonthCalendarUnit)

Specifies the original week of a month calendar unit.

[`NSWeekOfYearCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSWeekOfYearCalendarUnit)

Specifies the original week of the year calendar unit.

[`NSYearForWeekOfYearCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSYearForWeekOfYearCalendarUnit)

Specifies the year when the calendar is being interpreted as a week-based calendar.

[`NSCalendarCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSCalendarCalendarUnit)

Specifies the calendar of the calendar.

[`NSTimeZoneCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSTimeZoneCalendarUnit)

Specifies the time zone of the calendar as an `NSTimeZone`.

[`NSEraCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSEraCalendarUnit)

Specifies the era unit.

[`NSYearCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSYearCalendarUnit)

Specifies the year unit.

[`NSMonthCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSMonthCalendarUnit)

Specifies the month unit.

[`NSDayCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSDayCalendarUnit)

Specifies the day unit.

[`NSHourCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSHourCalendarUnit)

Specifies the hour unit.

[`NSMinuteCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSMinuteCalendarUnit)

Specifies the minute unit.

[`NSSecondCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSSecondCalendarUnit)

Specifies the second unit.

[`NSWeekCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSWeekCalendarUnit)

Specifies the week unit.

[`NSWeekdayCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSWeekdayCalendarUnit)

Specifies the weekday unit.

[`NSWeekdayOrdinalCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSWeekdayOrdinalCalendarUnit)

Specifies the ordinal weekday unit.

[`NSQuarterCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSQuarterCalendarUnit)

Specifies the quarter unit.

[`NSWeekOfMonthCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSWeekOfMonthCalendarUnit)

Specifies the original week of a month calendar unit.

[`NSWeekOfYearCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSWeekOfYearCalendarUnit)

Specifies the original week of the year calendar unit.

[`NSYearForWeekOfYearCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSYearForWeekOfYearCalendarUnit)

Specifies the year when the calendar is being interpreted as a week-based calendar.

[`NSCalendarCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSCalendarCalendarUnit)

Specifies the calendar of the calendar.

[`NSTimeZoneCalendarUnit`](/documentation/Foundation/NSCalendar/Unit/NSTimeZoneCalendarUnit)

Specifies the time zone of the calendar as an `NSTimeZone`.

## Relationships

### Conforms To

[`RawRepresentable`](/documentation/Swift/RawRepresentable)

[`ExpressibleByArrayLiteral`](/documentation/Swift/ExpressibleByArrayLiteral)

[`Sendable`](/documentation/Swift/Sendable)

[`OptionSet`](/documentation/Swift/OptionSet)

[`SetAlgebra`](/documentation/Swift/SetAlgebra)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`BitwiseCopyable`](/documentation/Swift/BitwiseCopyable)

[`Equatable`](/documentation/Swift/Equatable)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)