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

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

Разработчик

Ссылка платформы CoreFoundation ссылка CFTimeZone

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

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

Ссылка CFTimeZone

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

CFTimeZone обеспечивает несколько функций для создания объектов часового пояса: CFTimeZoneCreateWithName и CFTimeZoneCreateWithTimeIntervalFromGMT. CFTimeZone также разрешает Вам устанавливать часовой пояс по умолчанию в своем приложении с помощью CFTimeZoneSetDefault функция. Можно получить доступ к этому часовому поясу по умолчанию в любое время с CFTimeZoneCopyDefault функция.

CFTimeZone “бесплатный соединенный мостом” с его дубликатом Основы Какао, NSTimeZone. Это означает, что Базовый тип Основы является взаимозаменяемым в вызовах функции или вызовах метода с соединенным мостом объектом Основы. Поэтому в методе, где Вы видите NSTimeZone * параметр, можно передать в a CFTimeZoneRef, и в функции, где Вы видите a CFTimeZoneRef параметр, можно передать в экземпляре NSTimeZone. Этот факт также применяется к конкретным подклассам NSTimeZone. Посмотрите Бесплатные Соединенные мостом Типы для получения дополнительной информации о бесплатном образовании моста.

Функции

Создание часового пояса
  • CFTimeZoneCreateWithName (_: _: _:) CFTimeZoneCreateWithName

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

    Объявление

    Swift

    func CFTimeZoneCreateWithName(_ allocator: CFAllocator!, _ name: CFString!, _ tryAbbrev: Boolean) -> CFTimeZone!

    Objective C

    CFTimeZoneRef CFTimeZoneCreateWithName ( CFAllocatorRef allocator, CFStringRef name, Boolean tryAbbrev );

    Параметры

    allocator

    Объект-распределитель для использования для выделения памяти для нового часового пояса. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    name

    Имя или сокращение часового пояса для получения. Имя может быть в любом из форматов, понятых под системой, например «EST», «Etc/GMT-2», «America/Argentina/Buenos_Aires», «Европа/Монако», «США/Тихий океан» или «posixrules». Для полного списка имен системы Вы видите вывод CFTimeZoneCopyKnownNames.

    tryAbbrev

    Если false, принимает name не сокращение и ищет каталог информации о часовом поясе соответствующее имя. Если true, попытки решить name использование словаря сокращения сначала прежде, чем искать информационный словарь.

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

    Соответствие часового пояса name, или NULL если не было найдено никакое соответствие. Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneCreateWithTimeIntervalFromGMT (_: _:) CFTimeZoneCreateWithTimeIntervalFromGMT

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

    Объявление

    Swift

    func CFTimeZoneCreateWithTimeIntervalFromGMT(_ allocator: CFAllocator!, _ ti: CFTimeInterval) -> CFTimeZone!

    Objective C

    CFTimeZoneRef CFTimeZoneCreateWithTimeIntervalFromGMT ( CFAllocatorRef allocator, CFTimeInterval ti );

    Параметры

    allocator

    Объект-распределитель для использования для выделения памяти для нового часового пояса. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    ti

    Смещение, от GMT, нового часового пояса.

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

    Новый часовой пояс, смещение которого от GMT дано интервалом ti. Именем нового часового пояса является GMT +/-смещение в часах и минутах. Часовые пояса, создаваемые с этой функцией никогда, не имеют переход на летнее время, и смещение является постоянным независимо от того что дата. Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneCreate (_: _: _:) CFTimeZoneCreate

    Создает часовой пояс с именем и данными.

    Объявление

    Swift

    func CFTimeZoneCreate(_ allocator: CFAllocator!, _ name: CFString!, _ data: CFData!) -> CFTimeZone!

    Objective C

    CFTimeZoneRef CFTimeZoneCreate ( CFAllocatorRef allocator, CFStringRef name, CFDataRef data );

    Параметры

    allocator

    Объект-распределитель для использования для выделения памяти для нового часового пояса. Передача NULL или kCFAllocatorDefault использовать текущее средство выделения по умолчанию.

    name

    Имя часового пояса для создания.

    data

    Данные для использования для инициализации часового пояса. Содержание данных должно совпасть с, который нашел в файлах часового пояса расположенный в /usr/share/zoneinfo.

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

    Соответствие часового пояса name и data. Владение соблюдает Создать Правило.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Система и часовые пояса по умолчанию и информация
  • CFTimeZoneCopyAbbreviationDictionary () CFTimeZoneCopyAbbreviationDictionary

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

    Объявление

    Swift

    func CFTimeZoneCopyAbbreviationDictionary() -> CFDictionary!

    Objective C

    CFDictionaryRef CFTimeZoneCopyAbbreviationDictionary ( void );

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

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

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneCopyAbbreviation (_: _:) CFTimeZoneCopyAbbreviation

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

    Объявление

    Swift

    func CFTimeZoneCopyAbbreviation(_ tz: CFTimeZone!, _ at: CFAbsoluteTime) -> CFString!

    Objective C

    CFStringRef CFTimeZoneCopyAbbreviation ( CFTimeZoneRef tz, CFAbsoluteTime at );

    Параметры

    tz

    Часовой пояс для использования.

    at

    Абсолютное время, в которое можно получить сокращение.

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

    Строка, содержащая сокращение часового пояса at. Владение соблюдает Создать Правило.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneCopyDefault () CFTimeZoneCopyDefault

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

    Объявление

    Swift

    func CFTimeZoneCopyDefault() -> CFTimeZone!

    Objective C

    CFTimeZoneRef CFTimeZoneCopyDefault ( void );

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

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

    Обсуждение

    Если никакой часовой пояс по умолчанию не установлен, эта функция просто возвращает результат CFTimeZoneCopySystem функция.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneCopySystem () CFTimeZoneCopySystem

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

    Объявление

    Swift

    func CFTimeZoneCopySystem() -> CFTimeZone!

    Objective C

    CFTimeZoneRef CFTimeZoneCopySystem ( void );

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneSetDefault (_:) CFTimeZoneSetDefault

    Устанавливает часовой пояс по умолчанию для Вашего приложения данный часовой пояс.

    Объявление

    Swift

    func CFTimeZoneSetDefault(_ tz: CFTimeZone!)

    Objective C

    void CFTimeZoneSetDefault ( CFTimeZoneRef tz );

    Параметры

    tz

    Часовой пояс для использования в качестве значения по умолчанию.

    Обсуждение

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneCopyKnownNames () CFTimeZoneCopyKnownNames

    Возвращает массив строк, содержащих имена все время зон, известных системе.

    Объявление

    Swift

    func CFTimeZoneCopyKnownNames() -> CFArray!

    Objective C

    CFArrayRef CFTimeZoneCopyKnownNames ( void );

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

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneResetSystem () CFTimeZoneResetSystem

    Очищает ранее решительную зону системного времени, если таковые имеются.

    Объявление

    Swift

    func CFTimeZoneResetSystem()

    Objective C

    void CFTimeZoneResetSystem ( void );

    Обсуждение

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

    Последующие вызовы к CFTimeZoneCopySystem попытается повторно определить зону системного времени.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    См. также

    CFTimeZoneCopySystem
    CFTimeZoneCopyDefault
    CFTimeZoneSetDefault

  • CFTimeZoneSetAbbreviationDictionary (_:) CFTimeZoneSetAbbreviationDictionary

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

    Объявление

    Swift

    func CFTimeZoneSetAbbreviationDictionary(_ dict: CFDictionary!)

    Objective C

    void CFTimeZoneSetAbbreviationDictionary ( CFDictionaryRef dict );

    Параметры

    dict

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

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Получение информации о часовых поясах
  • CFTimeZoneGetName (_:) CFTimeZoneGetName

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

    Объявление

    Swift

    func CFTimeZoneGetName(_ tz: CFTimeZone!) -> CFString!

    Objective C

    CFStringRef CFTimeZoneGetName ( CFTimeZoneRef tz );

    Параметры

    tz

    Часовой пояс для анализа.

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

    Строка, содержащая идентифицирующее геополитическое имя области tz. Владение соблюдает Получить Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneCopyLocalizedName (_: _: _:) CFTimeZoneCopyLocalizedName

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

    Объявление

    Swift

    func CFTimeZoneCopyLocalizedName(_ tz: CFTimeZone!, _ style: CFTimeZoneNameStyle, _ locale: CFLocale!) -> CFString!

    Objective C

    CFStringRef CFTimeZoneCopyLocalizedName ( CFTimeZoneRef tz, CFTimeZoneNameStyle style, CFLocaleRef locale );

    Параметры

    tz

    Часовой пояс для анализа.

    style

    Стиль для возвращенного имени.

    locale

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

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

    Имя tz локализованный для locale. Владение соблюдает Создать Правило.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneGetSecondsFromGMT (_: _:) CFTimeZoneGetSecondsFromGMT

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

    Объявление

    Swift

    func CFTimeZoneGetSecondsFromGMT(_ tz: CFTimeZone!, _ at: CFAbsoluteTime) -> CFTimeInterval

    Objective C

    CFTimeInterval CFTimeZoneGetSecondsFromGMT ( CFTimeZoneRef tz, CFAbsoluteTime at );

    Параметры

    tz

    Часовой пояс для анализа.

    at

    Дата, в которой должен быть вычислен интервал.

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

    Различие в секундах между tz и GMT в указанной дате, at.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneGetData (_:) CFTimeZoneGetData

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

    Объявление

    Swift

    func CFTimeZoneGetData(_ tz: CFTimeZone!) -> CFData!

    Objective C

    CFDataRef CFTimeZoneGetData ( CFTimeZoneRef tz );

    Параметры

    tz

    Часовой пояс для анализа.

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

    Данные раньше хранили tz. Владение соблюдает Получить Правило. Может быть NULL если часовой пояс не имеет никаких данных или использует данные Олсона для его информации.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Получение информации летнего времени
  • CFTimeZoneIsDaylightSavingTime (_: _:) CFTimeZoneIsDaylightSavingTime

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

    Объявление

    Swift

    func CFTimeZoneIsDaylightSavingTime(_ tz: CFTimeZone!, _ at: CFAbsoluteTime) -> Boolean

    Objective C

    Boolean CFTimeZoneIsDaylightSavingTime ( CFTimeZoneRef tz, CFAbsoluteTime at );

    Параметры

    tz

    Часовой пояс для анализа.

    at

    Дата в tz протестировать на переход на летнее время.

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

    true если tz находится в летнее время в at, иначе false.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneGetDaylightSavingTimeOffset (_: _:) CFTimeZoneGetDaylightSavingTimeOffset

    Возвращает смещение летнего времени какое-то время зона в установленный срок.

    Объявление

    Swift

    func CFTimeZoneGetDaylightSavingTimeOffset(_ tz: CFTimeZone!, _ at: CFAbsoluteTime) -> CFTimeInterval

    Objective C

    CFTimeInterval CFTimeZoneGetDaylightSavingTimeOffset ( CFTimeZoneRef tz, CFAbsoluteTime at );

    Параметры

    tz

    Часовой пояс для анализа.

    at

    Время в tz протестировать на смещение летнего времени.

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

    Смещение летнего времени для tz в at.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneGetNextDaylightSavingTimeTransition (_: _:) CFTimeZoneGetNextDaylightSavingTimeTransition

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

    Объявление

    Swift

    func CFTimeZoneGetNextDaylightSavingTimeTransition(_ tz: CFTimeZone!, _ at: CFAbsoluteTime) -> CFAbsoluteTime

    Objective C

    CFAbsoluteTime CFTimeZoneGetNextDaylightSavingTimeTransition ( CFTimeZoneRef tz, CFAbsoluteTime at );

    Параметры

    tz

    Часовой пояс для анализа.

    at

    Время в tz.

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

    Время в tz из следующего раза переход после at.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Получение идентификатора типа CFTimeZone
  • CFTimeZoneGetTypeID () CFTimeZoneGetTypeID

    Возвращает идентификатор типа для CFTimeZone непрозрачный тип.

    Объявление

    Swift

    func CFTimeZoneGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CFTimeZoneGetTypeID ( void );

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

    Идентификатор типа для CFTimeZone непрозрачный тип.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Типы данных

Прочие условия

  • CFTimeZoneNameStyle CFTimeZoneNameStyle

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

    Объявление

    Swift

    enum CFTimeZoneNameStyle : CFIndex { case Standard case ShortStandard case DaylightSaving case ShortDaylightSaving case Generic case ShortGeneric }

    Objective C

    typedef CFIndex CFTimeZoneNameStyle;

    Обсуждение

    Для значений посмотрите Стили Имени Часового пояса.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • CFTimeZoneRef CFTimeZoneRef

    Ссылка на объект CFTimeZone.

    Объявление

    Swift

    typealias CFTimeZoneRef = CFTimeZone

    Objective C

    typedef const struct __CFTimeZone *CFTimeZoneRef;

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Константы

  • Имя уведомления

    Когда часовой пояс изменяется, имя уведомления отправило.

    Объявление

    Swift

    let kCFTimeZoneSystemTimeZoneDidChangeNotification: CFString!

    Objective C

    const CFStringRef kCFTimeZoneSystemTimeZoneDidChangeNotification;

    Константы

    • kCFTimeZoneSystemTimeZoneDidChangeNotification

      kCFTimeZoneSystemTimeZoneDidChangeNotification

      Когда зона системного времени изменяется, имя уведомления отправило.

      Объект уведомления является предыдущим объектом зоны системного времени. Это уведомление не переносит пользовательской информации.

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

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

  • Стили имени часового пояса

    Константы для указания стилей для имен часового пояса.

    Объявление

    Swift

    enum CFTimeZoneNameStyle : CFIndex { case Standard case ShortStandard case DaylightSaving case ShortDaylightSaving case Generic case ShortGeneric }

    Objective C

    typedef enum : CFIndex { kCFTimeZoneNameStyleStandard, kCFTimeZoneNameStyleShortStandard, kCFTimeZoneNameStyleDaylightSaving, kCFTimeZoneNameStyleShortDaylightSaving, kCFTimeZoneNameStyleGeneric, kCFTimeZoneNameStyleShortGeneric } CFTimeZoneNameStyle;

    Константы

    • Standard

      kCFTimeZoneNameStyleStandard

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

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

    • ShortStandard

      kCFTimeZoneNameStyleShortStandard

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

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

    • DaylightSaving

      kCFTimeZoneNameStyleDaylightSaving

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

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

    • ShortDaylightSaving

      kCFTimeZoneNameStyleShortDaylightSaving

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

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

    • Generic

      kCFTimeZoneNameStyleGeneric

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

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

    • ShortGeneric

      kCFTimeZoneNameStyleShortGeneric

      Указывает короткий стиль родового названия, не различающий переход на летнее время и стандартное время; например, «CT» для зоны центрального поясного времени.

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

    Обсуждение

    Эти константы используются с функцией CFTimeZoneCopyLocalizedName.