Instance Method

dateWithCalendarFormat:timeZone:

Converts the receiver to a calendar date with a given format string and time zone.

Declaration

- (NSCalendarDate *)dateWithCalendarFormat:(NSString *)format timeZone:(NSTimeZone *)aTimeZone;

Parameters

formatString

The format for the returned string (see Date and Number Formatters in OS X v10.0 to 10.3 for a discussion of how to create the format string). Pass nil to use the default format string, “%Y-%m-%d %H:%M:%S %z” (this conforms to the international format YYYY-MM-DD HH:MM:SS ±HHMM.)

timeZone

The time zone for the new calendar date. Pass nil to use the default time zone—specific to the current locale.

Return Value

A new NSCalendarDate object bound to formatString and the time zone timeZone.

See Also

Legacy Operations

+ dateWithNaturalLanguageString:

Creates and returns a date object set to the date and time specified by a given string.

Deprecated
+ dateWithNaturalLanguageString:locale:

Creates and returns a date object set to the date and time specified by a given string.

Deprecated
+ dateWithString:

Creates and returns a date object with a date and time value specified by a given string in the international string representation format (YYYY-MM-DD HH:MM:SS ±HHMM).

Deprecated
- initWithString:

Returns a date object initialized with a date and time value specified by a given string in the international string representation format.

Deprecated
- addTimeInterval:

Returns a new date object that is set to a given number of seconds relative to the receiver.

Deprecated
- descriptionWithCalendarFormat:timeZone:locale:

Returns a string representation of the date formatted as specified by given conversion specifiers.

Deprecated