Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы UIKit ссылка класса UIDatePicker

Опции
Развертывание Target:

На этой странице
Язык:

UIDatePicker

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

Доступный в iOS 2.0 и позже.

UIDatePicker класс реализует объект, использующий многократные колеса вращения, чтобы позволить пользователям выбирать даты и время. примерами iPhone средства выбора даты является Таймер и Предупреждение (Поставленный Будильник) области приложения Часов. Можно также использовать средство выбора даты в качестве таймера обратного отсчета.

Когда должным образом сконфигурировано, a UIDatePicker когда пользователь заканчивает поворачивать одно из колес для изменения даты или время, объект отправляет сообщение действия; связанное событие управления UIControlEventValueChanged. A UIDatePicker возразите представляет таймер обратного отсчета, но не реализует его; приложение должно установить NSTimer возразите и обновите секунды, поскольку они считаются в обратном порядке.

UIDatePicker не наследовался от UIPickerView, но это управляет пользовательским объектом представления средства выбора как подпредставлением.

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

Управление датой и календарем
  • calendar Свойство

    Календарь для использования для средства выбора даты.

    Объявление

    Swift

    @NSCopying var calendar: NSCalendar!

    Objective C

    @property(nonatomic, copy) NSCalendar *calendar

    Обсуждение

    Значение по умолчанию этого свойства соответствует текущему календарю пользователя, как сконфигурировано в Настройках. Это эквивалентно значению, возвращенному путем вызова NSCalendar метод класса currentCalendar. Установка calendar к nil эквивалентно установке его к ее значению по умолчанию.

    Календари указывают подробные данные культурных систем, используемых для счета времени; они идентифицируют начало, длину и подразделения года.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    локаль
    часовой пояс

  • date Свойство

    Дата выведена на экран средством выбора даты.

    Объявление

    Swift

    var date: NSDate

    Objective C

    @property(nonatomic, retain) NSDate *date

    Обсуждение

    Значение по умолчанию является датой когда UIDatePicker объект создается. Дата проигнорирована в режиме UIDatePickerModeCountDownTimer; для того режима средство выбора даты запускается в 0:00. Установка этого свойства не анимирует средство выбора даты путем вращения колес к новой дате и времени; чтобы сделать это, необходимо использовать setDate:animated: метод.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    – setDate:animated:

  • locale Свойство

    Локаль используется средством выбора даты.

    Объявление

    Swift

    var locale: NSLocale?

    Objective C

    @property(nonatomic, retain) NSLocale *locale

    Обсуждение

    Значение по умолчанию является текущей локалью, как возвращено currentLocale свойство NSLocale, или локаль используется календарем средства выбора даты. Локали инкапсулируют информацию о фасетах языка или культуры, таких как способ, которым отформатированы даты.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    календарь
    часовой пояс

  • setDate (_: анимированный:) - setDate:animated:

    Назначает дату для отображения в средстве выбора даты, с опцией анимировать установку.

    Объявление

    Swift

    func setDate(_ date: NSDate, animated animated: Bool)

    Objective C

    - (void)setDate:(NSDate *)date animated:(BOOL)animated

    Параметры

    date

    NSDate объект, представляющий новую дату для отображения в средстве выбора даты.

    animated

    YEStrue анимировать установку новой даты, иначе NOfalse. Анимация поворачивает колеса, пока новая дата и время не показана под прямоугольником выделения.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    дата

  • timeZone Свойство

    Часовой пояс отразился в дате, выведенной на экран средством выбора даты.

    Объявление

    Swift

    var timeZone: NSTimeZone?

    Objective C

    @property(nonatomic, retain) NSTimeZone *timeZone

    Обсуждение

    Значение по умолчанию nil. который говорит средству выбора даты использовать зону текущего времени, как возвращено localTimeZone (NSTimeZone) или часовой пояс используется календарем средства выбора даты.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

    См. также

    календарь
    локаль

Конфигурирование режима средства выбора даты
  • datePickerMode Свойство

    Режим средства выбора даты.

    Объявление

    Swift

    var datePickerMode: UIDatePickerMode

    Objective C

    @property(nonatomic) UIDatePickerMode datePickerMode

    Обсуждение

    Значение этого свойства указывает режим средства выбора даты. Это определяет, позволяет ли средство выбора даты выбор даты, время, обе даты и времени, или время обратного отсчета. Режим по умолчанию UIDatePickerModeDateAndTime. Посмотрите Режим Средства выбора Даты для списка констант режима.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

Конфигурирование временных атрибутов
  • maximumDate Свойство

    Максимальная дата, которую может показать средство выбора даты.

    Объявление

    Swift

    var maximumDate: NSDate?

    Objective C

    @property(nonatomic, retain) NSDate *maximumDate

    Обсуждение

    Свойство NSDate объект или nil (значение по умолчанию), что не означает максимальной даты. Это свойство, вместе с minimumDate свойство, позволяет Вам указать допустимый диапазон дат. Если минимальное значение даты больше, чем максимальное значение даты, оба свойства проигнорированы. Минимальные и максимальные даты также проигнорированы в режиме таймера обратного отсчета (UIDatePickerModeCountDownTimer).

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

  • minimumDate Свойство

    Минимальная дата, которую может показать средство выбора даты.

    Объявление

    Swift

    var minimumDate: NSDate?

    Objective C

    @property(nonatomic, retain) NSDate *minimumDate

    Обсуждение

    Свойство NSDate объект или nil (значение по умолчанию), что не означает минимальной даты. Это свойство, вместе с maximumDate свойство, позволяет Вам указать допустимый диапазон дат. Если минимальное значение даты больше, чем максимальное значение даты, оба свойства проигнорированы. Минимальные и максимальные даты также проигнорированы в режиме таймера обратного отсчета (UIDatePickerModeCountDownTimer).

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

  • minuteInterval Свойство

    Интервал, в котором средство выбора даты должно вывести на экран минуты.

    Объявление

    Swift

    var minuteInterval: Int

    Objective C

    @property(nonatomic) NSInteger minuteInterval

    Обсуждение

    Можно использовать это свойство для установки интервала, выведенного на экран мелким колесом (например, 15 минут). Значение интервала должно быть равномерно разделено на 60; если это не, значение по умолчанию используется. Значения по умолчанию и минимальные значения равняются 1; максимальное значение равняется 30.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

  • countDownDuration Свойство

    Секунды, с которых таймер обратного отсчета считает в обратном порядке.

    Объявление

    Swift

    var countDownDuration: NSTimeInterval

    Objective C

    @property(nonatomic) NSTimeInterval countDownDuration

    Обсуждение

    NSTimeInterval значение этого свойства указывает секунды, с которых средство выбора даты в режиме таймера обратного отсчета считает в обратном порядке. Если режим средства выбора даты не UIDatePickerModeCountDownTimer, это значение проигнорировано. Значение по умолчанию 0.0, и максимальное значение 23:59 (86 399 секунд).

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.

Константы
  • Режим средства выбора даты

    Режим средства выбора даты.

    Объявление

    Swift

    enum UIDatePickerMode : Int { case Time case Date case DateAndTime case CountDownTimer }

    Objective C

    typedef enum { UIDatePickerModeTime, UIDatePickerModeDate, UIDatePickerModeDateAndTime, UIDatePickerModeCountDownTimer } UIDatePickerMode;

    Константы

    • Time

      UIDatePickerModeTime

      Средство выбора даты выводит на экран часы, минуты, и (дополнительно) обозначение AM/PM. Точные показанные элементы и их порядок зависят от набора локали. Примером этого режима является [6 | 53 | PM].

      Доступный в iOS 2.0 и позже.

    • Date

      UIDatePickerModeDate

      Средство выбора даты выводит на экран месяцы, дни месяца и лет. Точный порядок этих элементов зависит от установки локали. Примером этого режима является [ноябрь | 15 | 2007].

      Доступный в iOS 2.0 и позже.

    • DateAndTime

      UIDatePickerModeDateAndTime

      Средство выбора даты выводит на экран даты (как объединенный день недели, месяца и дня значений месяца) плюс часы, минуты, и (дополнительно) обозначение AM/PM. Точный порядок и формат этих элементов зависят от набора локали. Примером этого режима является [среда 15 ноября | 6 | 53 | PM].

      Доступный в iOS 2.0 и позже.

    • CountDownTimer

      UIDatePickerModeCountDownTimer

      Средство выбора даты выводит на экран значения часа и минуты, например [1 | 53]. Приложение должно установить таймер, чтобы выстрелить в надлежащий интервал и установить средство выбора даты, поскольку секунды отсчитывают вниз.

      Доступный в iOS 2.0 и позже.

    Обсуждение

    Режим определяет, выведены ли даты, времена или обе даты и времени на экран. Можно также использовать его для указания появления таймера обратного отсчета. Можно установить и получить значение режима через datePickerMode свойство.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 2.0 и позже.