Instance Method

componentsInTimeZone:fromDate:

Returns all the date components of a date, as if in a given time zone (instead of the receiving calendar’s time zone).

Declaration

- (NSDateComponents *)componentsInTimeZone:(NSTimeZone *)timezone fromDate:(NSDate *)date;

Parameters

timezone

The time zone to use when returning the components. This value overrides the time zone of the receiving NSCalendar.

date

The date for which to perform the calculation.

Return Value

An NSDateComponents object containing all the components from the given date, calculated using the given time zone.

Discussion

If you want "date information in a given time zone" for the purpose to displaying it, you should use NSDateFormatter to format the date.

See Also

Extracting Components

- date:matchesComponents:

Returns whether a given date matches all of the given date components.

- component:fromDate:

Returns the specified date component from a given date.

- components:fromDate:

Returns the date components representing a given date.

- components:fromDate:toDate:options:

Returns the difference between two supplied dates as date components.

- components:fromDateComponents:toDateComponents:options:

Returns the difference between start and end dates given as date components.

- getEra:year:month:day:fromDate:

Returns by reference the era, year, week of year, and weekday component values for a given date.

- getEra:yearForWeekOfYear:weekOfYear:weekday:fromDate:

Returns by reference the era, year, week of year, and weekday component values for a given date.

- getHour:minute:second:nanosecond:fromDate:

Returns by reference the hour, minute, second, and nanosecond component values for a given date.