NSDateComponents

NSDateComponents инкапсулирует компоненты даты растяжимым, объектно-ориентированным способом. Это используется для указания даты путем обеспечения временных компонентов, составляющих дату и время: час, минуты, секунды, день, месяц, год, и т.д. Это может также использоваться для указания продолжительности времени, например, 5 часов и 16 минут. NSDateComponents объект не требуется, чтобы определять все поля компонента. Когда новый экземпляр NSDateComponents создается компоненты даты установлены в NSUndefinedDateComponent.

Экземпляр NSDateComponents не ответственно за ответ на вопросы о дате вне информации, с которой он был инициализирован. Например, если Вы инициализируете один с 6 мая 2004, его рабочий день NSUndefinedDateComponent, не в четверг. Для получения корректного дня недели необходимо создать подходящий экземпляр NSCalendar, создайте NSDate объектное использование dateFromComponents: и затем используйте components:fromDate: получать рабочий день — как проиллюстрировано в следующем примере.

      NSDateComponents *comps = [[NSDateComponents alloc] init];
[comps setDay:6];
[comps setMonth:5];
[comps setYear:2004];
NSCalendar *gregorian = [[NSCalendar alloc]
    initWithCalendarIdentifier:NSGregorianCalendar];
NSDate *date = [gregorian dateFromComponents:comps];
[comps release];
NSDateComponents *weekdayComponents =
    [gregorian components:NSWeekdayCalendarUnit fromDate:date];
int weekday = [weekdayComponents weekday];


  

Для получения дополнительной информации посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Наследование

NSObject
NSDateComponents

NSObject
NSDateComponents

Соответствует

Оператор импорта

Swift

import Foundation

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.4 и позже.

Получение значения даты

дата дата Свойство

Дата получателя. (только для чтения)

Объявление

Swift

@NSCopying var date: NSDate? { get }

Objective C

@property(readonly, copy) NSDate *date

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.7 и позже.
календарь календарь Свойство

Календарь раньше интерпретировал компоненты получателя.

Объявление

Swift

@NSCopying var calendar: NSCalendar?

Objective C

@property(copy) NSCalendar *calendar

Обсуждение

Посмотрите календари, компоненты даты и единицы времени по календарю в руководстве по программированию даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.7 и позже.
часовой пояс часовой пояс Свойство

Часовой пояс раньше интерпретировал компоненты получателя.

Объявление

Swift

@NSCopying var timeZone: NSTimeZone?

Objective C

@property(copy) NSTimeZone *timeZone

Обсуждение

Посмотрите календари, компоненты даты и единицы времени по календарю в руководстве по программированию даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.7 и позже.

Доступ к компонентам даты

эра эра Свойство

Число модулей эры для получателя.

Объявление

Swift

var era: Int

Objective C

@property NSInteger era

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
год год Свойство

Число модулей года для получателя.

Объявление

Swift

var year: Int

Objective C

@property NSInteger year

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
месяц месяц Свойство

Число модулей месяца для получателя.

Объявление

Swift

var month: Int

Objective C

@property NSInteger month

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
день день Свойство

Число дневных модулей для получателя.

Объявление

Swift

var day: Int

Objective C

@property NSInteger day

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
час час Свойство

Число модулей часа для получателя.

Объявление

Swift

var hour: Int

Objective C

@property NSInteger hour

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
минута минута Свойство

Число мелких модулей для получателя.

Объявление

Swift

var minute: Int

Objective C

@property NSInteger minute

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
второй второй Свойство

Число вторых модулей для получателя.

Объявление

Swift

var second: Int

Objective C

@property NSInteger second

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
наносекунда наносекунда Свойство

Число модулей наносекунды для получателя.

Объявление

Swift

var nanosecond: Int

Objective C

@property NSInteger nanosecond

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.7 и позже.
рабочий день рабочий день Свойство

Число буднего модуля для получателя.

Объявление

Swift

var weekday: Int

Objective C

@property NSInteger weekday

Обсуждение

Будние модули являются числами 1 через n, где n является числом дней на неделе. Например, в Григорианском календаре, n равняется 7, и воскресенье представлено 1.

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
weekdayOrdinal weekdayOrdinal Свойство

Порядковое число будних модулей для получателя.

Объявление

Swift

var weekdayOrdinal: Int

Objective C

@property NSInteger weekdayOrdinal

Обсуждение

Рабочий день порядковые модули представляет позицию рабочего дня в следующей большей единице времени по календарю, такой как месяц. Например, 2 рабочий день порядковый модуль в течение второй пятницы месяца.

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
четверть четверть Свойство

Число четвертей для получателя.

Объявление

Swift

var quarter: Int

Objective C

@property NSInteger quarter

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.6 и позже.
weekOfMonth weekOfMonth Свойство

Недельное число месяца для получателя.

Объявление

Swift

var weekOfMonth: Int

Objective C

@property NSInteger weekOfMonth

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.7 и позже.
weekOfYear weekOfYear Свойство

Неделя года для получателя.

Объявление

Swift

var weekOfYear: Int

Objective C

@property NSInteger weekOfYear

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.7 и позже.
yearForWeekOfYear yearForWeekOfYear Свойство

Год в течение недели года.

Объявление

Swift

var yearForWeekOfYear: Int

Objective C

@property NSInteger yearForWeekOfYear

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.7 и позже.
leapMonth leapMonth Свойство

Булево значение, указывающее, является ли месяц месяцем прыжка.

Объявление

Swift

var leapMonth: Bool

Objective C

@property(getter=isLeapMonth) BOOL leapMonth

Обсуждение

YEStrue если месяц является месяцем прыжка, NOfalse иначе.

Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.8 и позже.
неделя - неделя (OS X v10.9)

Возвращает число недельных модулей для получателя.

Оператор осуждения

Использовать weekOfYear или weekOfMonth вместо этого, в зависимости от какого Вы предназначаете.

Объявление

Objective C

- (NSInteger)week

Возвращаемое значение

Число недельных модулей для получателя.

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.9.
setWeek: - setWeek: (OS X v10.9)

Определяет номер недельных модулей для получателя.

Оператор осуждения

Использовать weekOfYear или weekOfMonth вместо этого, в зависимости от какого Вы предназначаете.

Объявление

Objective C

- (void)setWeek:(NSInteger)v

Параметры

v

Число недельных модулей.

Обсуждение

Это значение интерпретируется в контексте календаря, с которым это используется — посмотрите Календари, Компоненты Даты и Единицы времени по календарю в Руководстве по программированию Даты и времени.

Оператор импорта

Objective C

@import Foundation;

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.9.

Константы

NSDateComponents неопределенный идентификатор компонента
Эта константа указывает что NSDateComponents компонент не определен.

Объявление

Swift

var NSUndefinedDateComponent: UInt { get }

Objective C

enum { NSUndefinedDateComponent = 0x7fffffff };

Константы
- NSUndefinedDateComponent
  
  NSUndefinedDateComponent
  
  Указывает, что компонент не определен.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.10.

NSDateComponents

Получение значения даты

Объявление

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Доступ к компонентам даты

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Объявление

Обсуждение

Оператор импорта

Доступность

Оператор осуждения

Объявление

Возвращаемое значение

Обсуждение

Оператор импорта

Доступность

Оператор осуждения