---
title: birthday
framework: contacts
role: symbol
role_heading: Instance Property
path: contacts/cncontact/birthday
---

# birthday

A date component for the Gregorian birthday of the contact.

## Declaration

```swift
var birthday: DateComponents? { get }
```

## Discussion

Discussion Birthdays are represented by this property, whose values are the relevant properties of an NSDateComponents object. Day and month components are required for this property, and year is optional. The calendar component can be nil or gregorian. All other date components are invalid and including them results in an NSError object that includes the key paths of the invalid components and the error code CNError.Code.validationConfigurationError.

## See Also

### Getting Birthday Information

- [nonGregorianBirthday](contacts/cncontact/nongregorianbirthday.md)
- [dates](contacts/cncontact/dates.md)
