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

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

Разработчик

Ссылка платформы WatchKit ссылка класса WKInterfaceDate

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

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

WKInterfaceDate

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


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


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


Swift

import WatchKit

Objective C

@import WatchKit;

Доступность


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

A WKInterfaceDate объект является пользовательской меткой, выводящей на экран текущую дату или время. Используйте этот объект, когда Вы захотите вывести на экран дату или информацию времени без дальнейшего взаимодействия от Вашего расширения WatchKit. Во время выполнения используйте объект даты сконфигурировать появление выводимой на экран информации о дате и времени.

Не разделяйте на подклассы или создавайте экземпляры этого класса сами. Вместо этого определите выходы в своем классе контроллера интерфейса и подключите их к соответствующим объектам в Вашем файле раскадровки. Например, для обращения к объекту даты в интерфейсе определите свойство с помощью следующего синтаксиса в классе контроллера интерфейса:

Swift

  • @IBOutlet weak var myDate: WKInterfaceDate!

Objective C

  • @property (weak, nonatomic) IBOutlet WKInterfaceDate* myDate;

Во время инициализации Вашего контроллера интерфейса WatchKit создает любые необходимые объекты даты и присваивает их их связанным выходам. После того, как те объекты установлены, можно использовать их для внесения изменений в экранную информацию о дате и времени.

Соедините интерфейсом с параметрами конфигурации разработчика

XCode позволяет Вам сконфигурировать информацию о своем объекте интерфейса даты в Вашем файле раскадровки. Таблица 1 перечисляет атрибуты, которые можно сконфигурировать и их значение.

Табличные 1WatchKit атрибуты даты

Атрибут

Описание

Формат

Селектор для выбора между стандартными и пользовательскими форматами. Для стандартных форматов Вы используете атрибуты Даты и времени для конфигурирования информации, которую Вы хотите вывести на экран. Изменение значения этого атрибута к Пользовательскому позволяет Вам сконфигурировать дату точно способ, которым Вы хотите на основе параметров формата, описанных в Руководстве по Форматированию данных.

Дата

Информация о дате для отображения. Опции даты соответствуют значениям NSDateFormatterStyle ввести.

Время

Информация времени для отображения. Опции времени соответствуют значениям NSDateFormatterStyle ввести.

Предварительный просмотр

Предварительный просмотр того, на что будет похожа дата и время.

Объект даты является пользовательской меткой, текст которой Вы не можете установить непосредственно. Однако можно настроить появление объекта даты, как Вы настроили бы метку с помощью инспектора Атрибутов в XCode. Для получения информации об атрибутах метки можно сконфигурировать, видеть Ссылку класса WKInterfaceLabel.

  • Выбирает цвет текста даты и времени.

    Объявление

    Swift

    func setTextColor(_ color: UIColor?)

    Objective C

    - (void)setTextColor:(UIColor *)color

    Параметры

    color

    Пользовательский цвет, который будет применен к строке времени. Указание nil удаляет пользовательский цвет и возвращает текст цвету, указанному в файле раскадровки. Цвет текста по умолчанию является белым.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • Устанавливает часовой пояс для использования при отображении информации времени.

    Объявление

    Swift

    func setTimeZone(_ timeZone: NSTimeZone?)

    Objective C

    - (void)setTimeZone:(NSTimeZone *)timeZone

    Параметры

    timeZone

    Часовой пояс, который будет использоваться. Указание nil удаляет информацию о часовом поясе и заставляет Часы Apple использовать зону текущего времени на основе настроек пользователя.

    Обсуждение

    Используйте этот метод для конфигурирования часового пояса к тому, отличающемуся от зоны текущего времени пользователя. Например, приложение мировых часов могло бы использовать этот метод для конфигурирования информации об отображении времени.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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

  • Устанавливает календарь для использования при форматировании информации о дате.

    Объявление

    Swift

    func setCalendar(_ calendar: NSCalendar?)

    Objective C

    - (void)setCalendar:(NSCalendar *)calendar

    Параметры

    calendar

    Календарь, который будет использоваться. Указание ноля удаляет информацию календаря и заставляет Часы Apple использовать календарь по умолчанию на основе настроек пользователя.

    Обсуждение

    Используйте этот метод для конфигурирования календаря к тому, отличающемуся от текущего календаря пользователя. Вы могли бы изменить календарь для форматирования дат по-другому на основе потребностей приложения. Например, приложение финансовой отчетности могло бы использовать календарь, повреждающий год в финансовые кварталы, а не месяцы.

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

    Objective C

    @import WatchKit;

    Swift

    import WatchKit

    Доступность

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