Instance Property


A date component for the Gregorian birthday of the contact.


iOS, Mac Catalyst, watchOS
@property(copy, nonatomic) NSDateComponents *birthday;
@property(copy, atomic) NSDateComponents *birthday;


A Gregorian birthday can be displayed using this property, whose values are the relevant properties of an NSDateComponents object. Day and month are required for this property, and year is optional. Calendar can be nil or Gregorian. All other date components are invalid.

See Also

Setting Birthday Information


An array containing labeled Gregorian dates.


A date component for the non-Gregorian birthday of the contact.

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