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

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

Разработчик

Ссылка платформы основы ссылка класса NSTimeZone

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

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

NSTimeZone

NSTimeZone абстрактный класс, определяющий поведение объектов часового пояса. Объекты часового пояса представляют геополитические области. Следовательно, эти объекты имеют имена для этих областей. Объекты часового пояса также представляют временное смещение, или плюс или минус, со Среднего времени по Гринвичу (GMT) и сокращения (такого как PST для Тихоокеанского времени).

NSTimeZone обеспечивает несколько методов класса получить объекты часового пояса: timeZoneWithName:, timeZoneWithName:data:, timeZoneWithAbbreviation:, и timeZoneForSecondsFromGMT:. Класс также разрешает Вам устанавливать часовой пояс по умолчанию в своем приложении (setDefaultTimeZone:). Можно получить доступ к этому часовому поясу по умолчанию в любое время с defaultTimeZone метод класса, и с localTimeZone метод класса, можно получить относительный объект часового пояса, декодирующий себя для становления часовым поясом по умолчанию для любой локали, в которой это оказывается.

Обратите внимание на то, что, строго, записями базы данных часового пояса, такими как «America/Los_Angeles» является IDs не имена. Примером имени часового пояса является “Тихоокеанское Летнее время”. Несмотря на то, что многие NSTimeZone имена методов включают слово «имя», они обращаются к IDs.

Какао не обеспечивает API для изменения часового пояса компьютера, или других приложений.

NSTimeZone “бесплатный соединенный мостом” с его Базовым дубликатом Основы, CFTimeZoneRef. Посмотрите Бесплатное Образование моста для получения дополнительной информации о бесплатном образовании моста.

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


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


Swift

import Foundation

Objective C

@import Foundation;

Доступность


Доступный в OS X v10.0 и позже.
  • Возвращает объект часового пояса, идентифицированный данным сокращением.

    Объявление

    Swift

    convenience init?(abbreviation abbreviation: String)

    Objective C

    + (instancetype)timeZoneWithAbbreviation:(NSString *)abbreviation

    Параметры

    abbreviation

    Сокращение какое-то время зона.

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

    Объект часового пояса, идентифицированный abbreviation определенный путем разрешения сокращения к имени с помощью словаря сокращения и затем возвращая часовой пояс для того имени. Возвраты nil если там не идет ни в какое сравнение с abbreviation.

    Обсуждение

    В целом Вы отговорены использовать сокращения за исключением уникальных экземпляров, таких как «UTC» или «GMT». Сокращения Часового пояса не стандартизированы и таким образом, данное сокращение может иметь многозначности — например, «EST» относится к Восточному Времени и в США и в Австралии

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает объект часового пояса, идентифицированный данным ID.

    Объявление

    Objective C

    + (instancetype)timeZoneWithName:(NSString *)tzName

    Параметры

    tzName

    ID для часового пояса.

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

    Часовой пояс в информационном каталоге с соответствием имени tzName. Возвраты nil если там не идет ни в какое сравнение с именем.

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

    Objective C

    @import Foundation;

    Доступность

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

  • Возвращает часовой пояс с данным ID, данные которого были инициализированы с помощью определенных данных,

    Объявление

    Objective C

    + (instancetype)timeZoneWithName:(NSString *)tzName data:(NSData *)data

    Параметры

    tzName

    ID для часового пояса.

    data

    Данные от файлов часового пояса расположились в /usr/share/zoneinfo.

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

    Часовой пояс с ID tzName чьи данные были инициализированы с помощью содержания data.

    Обсуждение

    Вы не должны вызывать этот метод непосредственно — использование timeZoneWithName: для получения часового пояса возражают для имени.

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

    Objective C

    @import Foundation;

    Доступность

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

    См. также

    + timeZoneWithName:

  • Возвращает смещение объекта часового пояса со Среднего времени по Гринвичу данным числом секунд.

    Объявление

    Swift

    convenience init(forSecondsFromGMT seconds: Int)

    Objective C

    + (instancetype)timeZoneForSecondsFromGMT:(NSInteger)seconds

    Параметры

    seconds

    Число секунд, к которым новый часовой пояс смещается от GMT.

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

    Смещение объекта часового пояса со Среднего времени по Гринвичу seconds.

    Обсуждение

    Именем нового часового пояса является GMT +/– смещение в часах и минутах. Часовые пояса, создаваемые с этим методом никогда, не имеют переход на летнее время, и смещение является постоянным независимо от того дата.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает часовой пояс, инициализированный с данным ID.

    Объявление

    Swift

    init?(name tzName: String)

    Objective C

    - (instancetype)initWithName:(NSString *)tzName

    Параметры

    tzName

    ID для часового пояса. Обеспечение nil поскольку этот параметр повышает исключение недействительного аргумента.

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

    Объект часового пояса инициализируется с ID tzName.

    Обсуждение

    Если tzName известный ID, это вызовы метода initWithName:data: с надлежащим объектом данных.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Инициализирует часовой пояс с данным ID и данными часового пояса.

    Объявление

    Swift

    init?(name tzName: String, data data: NSData?)

    Objective C

    - (instancetype)initWithName:(NSString *)tzName data:(NSData *)data

    Параметры

    tzName

    ID для часового пояса. Обеспечение nil поскольку этот параметр повышает исключение недействительного аргумента.

    data

    Данные от файлов часового пояса расположились в /usr/share/zoneinfo.

    Обсуждение

    Вы не должны вызывать этот метод непосредственно — использование initWithName: получить объект часового пояса.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает версию данных часового пояса.

    Объявление

    Swift

    class func timeZoneDataVersion() -> String

    Objective C

    + (NSString *)timeZoneDataVersion

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

    Строка, содержащая версию данных часового пояса.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает объект, передающий все сообщения к часовому поясу по умолчанию для текущего приложения.

    Объявление

    Swift

    class func localTimeZone() -> NSTimeZone

    Objective C

    + (NSTimeZone *)localTimeZone

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

    Объект, передающий все сообщения к часовому поясу по умолчанию для текущего приложения.

    Обсуждение

    Зона местного времени представляет текущее состояние часового пояса по умолчанию в любом случае. Если Вы получаете часовой пояс по умолчанию (использование defaultTimeZone) и содержите на возвращенный объект, он не изменяется если последующий вызов setDefaultTimeZone: изменяет часовой пояс по умолчанию — у Вас все еще есть определенный часовой пояс, который Вы первоначально получили. Зона местного времени добавляет уровень абстракции, она действует, как будто это был текущий часовой пояс по умолчанию каждый раз, когда Вы вызываете метод на нее.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает часовой пояс по умолчанию для текущего приложения.

    Объявление

    Swift

    class func defaultTimeZone() -> NSTimeZone

    Objective C

    + (NSTimeZone *)defaultTimeZone

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

    Часовой пояс по умолчанию для текущего приложения. Если никакой часовой пояс по умолчанию не был установлен, этот метод вызывает systemTimeZone и возвращает зону системного времени.

    Обсуждение

    Часовой пояс по умолчанию является тем, с которым работает приложение, который можно изменить (таким образом, можно сделать выполнение приложения, как будто это было в различном часовом поясе).

    Если Вы получаете часовой пояс по умолчанию и содержите на возвращенный объект, он не изменяется если последующий вызов setDefaultTimeZone: изменяет часовой пояс по умолчанию — у Вас все еще есть определенный часовой пояс, который Вы первоначально получили. Контрастируйте это поведение с объектом, возвращенным localTimeZone.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Устанавливает часовой пояс по умолчанию для текущего приложения к данному часовому поясу.

    Объявление

    Swift

    class func setDefaultTimeZone(_ aTimeZone: NSTimeZone)

    Objective C

    + (void)setDefaultTimeZone:(NSTimeZone *)aTimeZone

    Параметры

    aTimeZone

    Новый часовой пояс по умолчанию для текущего приложения.

    Обсуждение

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Сбрасывает объект зоны системного времени, кэшируемый приложением, если таковые имеются.

    Объявление

    Swift

    class func resetSystemTimeZone()

    Objective C

    + (void)resetSystemTimeZone

    Обсуждение

    Если приложение кэшировало зону системного времени, этот метод очищает тот кэшируемый объект. Если Вы впоследствии вызываете systemTimeZone, NSTimeZone попытается повторно определить зону системного времени, и новый объект будет создаваться и кэшироваться (см. systemTimeZone).

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + systemTimeZone

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

    Объявление

    Swift

    class func systemTimeZone() -> NSTimeZone

    Objective C

    + (NSTimeZone *)systemTimeZone

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

    Часовой пояс в настоящее время используется системой. Если зона текущего времени не может быть определена, возвращает часовой пояс GMT.

    Специальные замечания

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

    См. также

    + resetSystemTimeZone

  • Возвращает словарь, содержащий отображения сокращений часового пояса к именам часового пояса.

    Объявление

    Swift

    class func abbreviationDictionary() -> [NSObject : AnyObject]

    Objective C

    + (NSDictionary *)abbreviationDictionary

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

    Словарь, содержащий отображения сокращений часового пояса к именам часового пояса.

    Обсуждение

    Обратите внимание на то, что больше чем один часовой пояс может иметь то же сокращение — например, США/Тихий океан и Канада/Тихий океан оба используют сокращение «PST». В этих случаях, abbreviationDictionary выбирает единственное имя для отображения сокращения на.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает массив строк, перечисляющих IDs все время зон, известных системе.

    Объявление

    Swift

    class func knownTimeZoneNames() -> [AnyObject]

    Objective C

    + (NSArray *)knownTimeZoneNames

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

    Массив строк, перечисляющих IDs все время зон, известных системе.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Устанавливает словарь сокращения в указанный словарь.

    Объявление

    Swift

    class func setAbbreviationDictionary(_ dict: [NSObject : AnyObject])

    Objective C

    + (void)setAbbreviationDictionary:(NSDictionary *)dict

    Параметры

    dict

    Словарь, содержащий пары ключ/значение для поиска часового пояса, называет данным их сокращения. Ключи должны быть NSString объекты, содержащие сокращения; значения должны быть NSString объекты, содержащие их соответствующие геополитические имена области.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Сокращение для получателя, такого как «EDT» (Восточное поясное время). (только для чтения)

    Объявление

    Swift

    var abbreviation: String? { get }

    Objective C

    @property(readonly, copy) NSString *abbreviation

    Обсуждение

    Вызывает abbreviationForDate: с текущей датой как параметр.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает сокращение для получателя в данной дате.

    Объявление

    Swift

    func abbreviationForDate(_ aDate: NSDate) -> String?

    Objective C

    - (NSString *)abbreviationForDate:(NSDate *)aDate

    Параметры

    aDate

    Дата, для которой можно получить сокращение для получателя.

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

    Сокращение для получателя в aDate.

    Обсуждение

    Обратите внимание на то, что сокращение может отличаться в различных датах. Например, в течение летнего времени часовой пояс США / Восточный часовой пояс имеют сокращение «EDT». В других случаях его сокращением является «EST».

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • имя имя Свойство

    Геополитический ID области, идентифицирующий получатель. (только для чтения)

    Объявление

    Swift

    var name: String { get }

    Objective C

    @property(readonly, copy) NSString *name

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • secondsFromGMT secondsFromGMT Свойство

    Текущее различие в секундах между получателем и Среднее время по Гринвичу. (только для чтения)

    Объявление

    Swift

    var secondsFromGMT: Int { get }

    Objective C

    @property(readonly) NSInteger secondsFromGMT

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает различие в секундах между получателем и Среднее время по Гринвичу в данной дате.

    Объявление

    Swift

    func secondsFromGMTForDate(_ aDate: NSDate) -> Int

    Objective C

    - (NSInteger)secondsFromGMTForDate:(NSDate *)aDate

    Параметры

    aDate

    Дата, против которой можно протестировать получатель.

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

    Различие в секундах между получателем и Среднее время по Гринвичу в aDate.

    Обсуждение

    Если часовой пояс изменяет свое смещение от GMT в различных точках в году — например, изменение часовых поясов США с летним временем, различие может отличаться от текущего различия.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • данные данные Свойство

    Данные, хранящие информацию, используемую получателем. (только для чтения)

    Объявление

    Swift

    @NSCopying var data: NSData { get }

    Objective C

    @property(readonly, copy) NSData *data

    Обсуждение

    Эти данные должны быть обработаны как непрозрачный объект.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает булево значение, указывающее, имеет ли получатель то же имя и данные как зона требуемого времени.

    Объявление

    Swift

    func isEqualToTimeZone(_ aTimeZone: NSTimeZone) -> Bool

    Objective C

    - (BOOL)isEqualToTimeZone:(NSTimeZone *)aTimeZone

    Параметры

    aTimeZone

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

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

    YEStrue если aTimeZone и получатель имеет то же имя и данные, иначе NOfalse.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Описание получателя, включая имя, сокращение, смещенное от GMT, и является ли летнее время в настоящее время в действительности. (только для чтения)

    Объявление

    Swift

    var description: String { get }

    Objective C

    @property(readonly, copy) NSString *description

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Возвращает имя получателя, локализованного для данной локали.

    Объявление

    Swift

    func localizedName(_ style: NSTimeZoneNameStyle, locale locale: NSLocale?) -> String?

    Objective C

    - (NSString *)localizedName:(NSTimeZoneNameStyle)style locale:(NSLocale *)locale

    Параметры

    style

    Стиль форматирования для возвращаемой строки.

    locale

    Локаль, для которой можно отформатировать имя.

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

    Имя получателя, локализованного для locale использование style.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • Укажите стили для представления имен часового пояса.

    Объявление

    Swift

    enum NSTimeZoneNameStyle : Int { case Standard case ShortStandard case DaylightSaving case ShortDaylightSaving case Generic case ShortGeneric }

    Objective C

    typedef enum : NSInteger { NSTimeZoneNameStyleStandard, NSTimeZoneNameStyleShortStandard, NSTimeZoneNameStyleDaylightSaving, NSTimeZoneNameStyleShortDaylightSaving, NSTimeZoneNameStyleGeneric, NSTimeZoneNameStyleShortGeneric } NSTimeZoneNameStyle;

    Константы

    • Standard

      NSTimeZoneNameStyleStandard

      Указывает стиль стандартного имени. Например, “Центральное Стандартное Время” для центрального поясного времени.

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

    • ShortStandard

      NSTimeZoneNameStyleShortStandard

      Указывает стиль краткого названия. Например, «CST» для центрального поясного времени.

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

    • DaylightSaving

      NSTimeZoneNameStyleDaylightSaving

      Указывает стиль имени перехода на летнее время. Например, “Центральное Летнее время” для центрального поясного времени.

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

    • ShortDaylightSaving

      NSTimeZoneNameStyleShortDaylightSaving

      Указывает короткий стиль имени перехода на летнее время. Например, «CDT» для центрального поясного времени.

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

    • Generic

      NSTimeZoneNameStyleGeneric

      Указывает стиль родового названия. Например, «центральное поясное время» для центрального поясного времени.

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

    • ShortGeneric

      NSTimeZoneNameStyleShortGeneric

      Указывает универсальное имя часового пояса. Например, «CT» для центрального поясного времени.

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

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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