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

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

Разработчик

Ссылочная ссылка утилит времени платформы CoreFoundation

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

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

Ссылка утилит времени

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


Не применимый

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


Не применимый

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


Swift

import CoreFoundation

Objective C

@import CoreFoundation;

Базовая Основа измеряет время в модулях секунд. Базовый тип данных CFTimeInterval, который измеряет различие в секундах между двумя разами. Фиксированные времена или даты, определяются CFAbsoluteTime тип данных, измеряющий временной интервал между определенной датой и датой абсолютной ссылки Яна 1 2 001 0:00:00 GMT.

CFGregorianDate структура представляет абсолютные времена с точки зрения Григорианского календаря. Функции такой как CFAbsoluteTimeGetGregorianDate используйте объект CFTimeZone получить местное время в зоне определенного времени.

Непрозрачный тип CFDate обертывает абсолютное время в CFType-базовый-объект, позволяя Вам поместить объекты времени в в наборы и списки свойств и быть обработанным другими объектно-ориентированными частями Базовой Основы.

Функции

  • Добавляет временной интервал, выраженный как Грегорианские модули, к данному абсолютному времени.

    Объявление

    Swift

    func CFAbsoluteTimeAddGregorianUnits(_ at: CFAbsoluteTime, _ tz: CFTimeZone!, _ units: CFGregorianUnits) -> CFAbsoluteTime

    Objective C

    CFAbsoluteTime CFAbsoluteTimeAddGregorianUnits ( CFAbsoluteTime at, CFTimeZoneRef tz, CFGregorianUnits units );

    Параметры

    at

    Абсолютное время, к которому добавляется интервал.

    tz

    Часовой пояс для использования для исправления времени. Передача NULL для GMT.

    units

    Временной интервал для добавления к at.

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

    Абсолютная временная стоимость равняется сумме at и units.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    Осуждаемый в iOS 8.0.

  • Возвращает существующую систему абсолютное время.

    Объявление

    Swift

    func CFAbsoluteTimeGetCurrent() -> CFAbsoluteTime

    Objective C

    CFAbsoluteTime CFAbsoluteTimeGetCurrent ( void );

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

    Текущее абсолютное время.

    Обсуждение

    Абсолютное время измеряется в секундах относительно даты абсолютной ссылки Яна 1 2 001 0:00:00 GMT. Положительное значение представляет дату после того, как базисная дата, отрицательная величина будет представлять дату перед ним. Например, абсолютное время -32940326 эквивалентно до 16-го декабря 1999 в 17:54:34. Повторные вызовы к этой функции не гарантируют монотонно увеличивающиеся результаты. Системное время может уменьшиться вследствие синхронизации со ссылками внешнего времени или вследствие явного пользовательского изменения часов.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

    SInt32 CFAbsoluteTimeGetDayOfWeek ( CFAbsoluteTime at, CFTimeZoneRef tz );

    Параметры

    at

    Абсолютное время для преобразования.

    tz

    Часовой пояс для использования для исправления времени. Передача NULL для GMT.

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

    Целое число (1-7) представление дня недели, указанной at. На ISO 8601 понедельник представлен 1, Во вторник 2, и т.д.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    Осуждаемый в iOS 8.0.

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

    Объявление

    Swift

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

    Objective C

    SInt32 CFAbsoluteTimeGetDayOfYear ( CFAbsoluteTime at, CFTimeZoneRef tz );

    Параметры

    at

    Абсолютное время для преобразования.

    tz

    Часовой пояс для использования для исправления времени. Передача NULL для GMT.

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

    Целое число (1-366) представление дня года, указанного at.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    Осуждаемый в iOS 8.0.

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

    Объявление

    Swift

    func CFAbsoluteTimeGetDifferenceAsGregorianUnits(_ at1: CFAbsoluteTime, _ at2: CFAbsoluteTime, _ tz: CFTimeZone!, _ unitFlags: CFOptionFlags) -> CFGregorianUnits

    Objective C

    CFGregorianUnits CFAbsoluteTimeGetDifferenceAsGregorianUnits ( CFAbsoluteTime at1, CFAbsoluteTime at2, CFTimeZoneRef tz, CFOptionFlags unitFlags );

    Параметры

    at1

    Абсолютное время.

    at2

    Абсолютное время.

    tz

    Часовой пояс для использования для исправления времени. Передача NULL для GMT.

    unitFlags

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

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

    Различие между указанными абсолютными временами (как at1 - at2— если at1 ранее, чем at2, результат отрицателен), выраженный в модулях, указанных unitFlags.

    Обсуждение

    Временное различие выражено максимально точно, дано указанные модули. Например, если бы Вы попросили число месяцев, и часы между 14:30 8 апреля 2005 и 17:45 9 сентября 2005, результатом составили бы 5 месяцев и 27 часов.

    Следующий пример распечатывает число часов и минут между текущим временем (теперь) и базисной датой (1 января 2001 0:00:00 GMT).

    • CFAbsoluteTime now = CFAbsoluteTimeGetCurrent ();
    • CFGregorianUnits units = CFAbsoluteTimeGetDifferenceAsGregorianUnits
    • (now, 0, NULL, (kCFGregorianUnitsHours | kCFGregorianUnitsMinutes));
    • CFStringRef output = CFStringCreateWithFormat
    • (NULL, 0, CFSTR("hours: %d; minutes: %d"), units.hours, units.minutes);
    • CFShow(output);

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    Осуждаемый в iOS 8.0.

  • Преобразовывает абсолютную временную стоимость в Грегорианскую дату.

    Объявление

    Swift

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

    Objective C

    CFGregorianDate CFAbsoluteTimeGetGregorianDate ( CFAbsoluteTime at, CFTimeZoneRef tz );

    Параметры

    at

    Абсолютная временная стоимость для преобразования.

    tz

    Часовой пояс для использования для исправления времени. Передача NULL для GMT.

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

    Грегорианская дата, эквивалентная для at.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    Осуждаемый в iOS 8.0.

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

    Объявление

    Swift

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

    Objective C

    SInt32 CFAbsoluteTimeGetWeekOfYear ( CFAbsoluteTime at, CFTimeZoneRef tz );

    Параметры

    at

    Абсолютное время для преобразования.

    tz

    Часовой пояс для использования для исправления времени. Передача NULL для GMT.

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

    Целое число (1-53) представление недели года, указанного at. Нумерация следует определению ISO 8601 недели.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    Осуждаемый в iOS 8.0.

  • Преобразовывает Грегорианское значение даты в абсолютную временную стоимость.

    Объявление

    Swift

    func CFGregorianDateGetAbsoluteTime(_ gdate: CFGregorianDate, _ tz: CFTimeZone!) -> CFAbsoluteTime

    Objective C

    CFAbsoluteTime CFGregorianDateGetAbsoluteTime ( CFGregorianDate gdate, CFTimeZoneRef tz );

    Параметры

    gdate

    Грегорианская дата для преобразования.

    tz

    Часовой пояс для использования для исправления времени. Передача NULL для GMT.

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

    Абсолютное время, эквивалентное из gdate.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    Осуждаемый в iOS 8.0.

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

    Объявление

    Swift

    func CFGregorianDateIsValid(_ gdate: CFGregorianDate, _ unitFlags: CFOptionFlags) -> Boolean

    Objective C

    Boolean CFGregorianDateIsValid ( CFGregorianDate gdate, CFOptionFlags unitFlags );

    Параметры

    gdate

    Структура CFGregorianDate, чьи поля для проверки.

    unitFlags

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

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

    true если указанные поля допустимы, иначе false.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

    Осуждаемый в iOS 8.0.

Типы данных

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

  • Введите используемый для представления отдельного момента своевременно относительно даты абсолютной ссылки 1 Яна 2 001 0:00:00 GMT.

    Объявление

    Swift

    typealias CFAbsoluteTime = CFTimeInterval

    Objective C

    typedef CFTimeInterval CFAbsoluteTime;

    Обсуждение

    Абсолютное время измеряется числом секунд между базисной датой и указанной датой. Отрицательные величины указывают даты/времена перед базисной датой. Положительные значения указывают даты/времена после базисной даты.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Структура раньше представляла момент времени с помощью Григорианского календаря.

    Объявление

    Swift

    struct CFGregorianDate { var year: Int32 var month: Int8 var day: Int8 var hour: Int8 var minute: Int8 var second: Double init() init(year year: Int32, month month: Int8, day day: Int8, hour hour: Int8, minute minute: Int8, second second: Double) }

    Objective C

    struct CFGregorianDate { SInt32 year; SInt8 month; SInt8 day; SInt8 hour; SInt8 minute; double second; }; typedef struct CFGregorianDate CFGregorianDate;

    Обсуждение

    CFGregorianDate реализован с помощью самого маленького типа данных, подходящего для диапазона возможных значений. Например, в Грегорианском году существует только 12 месяцев, таким образом, нет никакой потребности использовать целый тип, больше, чем 8 битов. Для представления временного интервала в Грегорианских модулях используйте a CFGregorianUnits.

    Модули месяца и дня на основе 1: индекс на январь равняется 1, и индекс в течение первого дня месяца равняется 1.

    Доступность

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

    Осуждаемый в iOS 8.0.

  • Структура раньше представляла временной интервал в Грегорианских модулях.

    Объявление

    Swift

    struct CFGregorianUnits { var years: Int32 var months: Int32 var days: Int32 var hours: Int32 var minutes: Int32 var seconds: Double init() init(years years: Int32, months months: Int32, days days: Int32, hours hours: Int32, minutes minutes: Int32, seconds seconds: Double) }

    Objective C

    struct CFGregorianUnits { SInt32 years; SInt32 months; SInt32 days; SInt32 hours; SInt32 minutes; double seconds; }; typedef struct CFGregorianUnits CFGregorianUnits;

    Обсуждение

    CFGregorianUnits используется для представления произвольных временных интервалов (для представления момента времени с помощью Грегорианских модулей, используйте a CFGregorianDate). Каждое поле может принять значения до максимума, возможного для его типа данных. Отрицательные величины также допустимы.

    Доступность

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

    Осуждаемый в iOS 8.0.

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

    Объявление

    Swift

    typealias CFTimeInterval = Double

    Objective C

    typedef double CFTimeInterval;

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

Константы

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

  • Эти флаги опции используются в качестве маски для указания определенного набора полей в структурах CFGregorianDate или CFGregorianUnits.

    Объявление

    Swift

    struct CFGregorianUnitFlags : RawOptionSetType { init(_ rawValue: CFOptionFlags) init(rawValue rawValue: CFOptionFlags) static var UnitsYears: CFGregorianUnitFlags { get } static var UnitsMonths: CFGregorianUnitFlags { get } static var UnitsDays: CFGregorianUnitFlags { get } static var UnitsHours: CFGregorianUnitFlags { get } static var UnitsMinutes: CFGregorianUnitFlags { get } static var UnitsSeconds: CFGregorianUnitFlags { get } static var AllUnits: CFGregorianUnitFlags { get } }

    Objective C

    enum CFGregorianUnitFlags { kCFGregorianUnitsYears = (1 << 0), kCFGregorianUnitsMonths = (1 << 1), kCFGregorianUnitsDays = (1 << 2), kCFGregorianUnitsHours = (1 << 3), kCFGregorianUnitsMinutes = (1 << 4), kCFGregorianUnitsSeconds = (1 << 5), kCFGregorianAllUnits = 0x00FFFFFF }; typedef enum CFGregorianUnitFlags CFGregorianUnitFlags;

    Константы

    • UnitsYears

      kCFGregorianUnitsYears

      Указывает поле года.

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

      Осуждаемый в iOS 8.0.

    • UnitsMonths

      kCFGregorianUnitsMonths

      Указывает поле месяца.

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

      Осуждаемый в iOS 8.0.

    • UnitsDays

      kCFGregorianUnitsDays

      Указывает дневное поле.

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

      Осуждаемый в iOS 8.0.

    • UnitsHours

      kCFGregorianUnitsHours

      Указывает поле часов.

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

      Осуждаемый в iOS 8.0.

    • UnitsMinutes

      kCFGregorianUnitsMinutes

      Указывает мелкое поле.

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

      Осуждаемый в iOS 8.0.

    • UnitsSeconds

      kCFGregorianUnitsSeconds

      Указывает поле секунд.

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

      Осуждаемый в iOS 8.0.

    • AllUnits

      kCFGregorianAllUnits

      Указывает все поля.

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

      Осуждаемый в iOS 8.0.

    Обсуждение

    Эти флаги используются с функциями такой как CFGregorianDateIsValid и CFAbsoluteTimeGetDifferenceAsGregorianUnits которые воздействуют на структуру CFGregorianDate или CFGregorianUnits. Для получения дополнительной информации посмотрите обсуждение тех функций.

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

    Objective C

    @import CoreFoundation;

    Swift

    import CoreFoundation

    Доступность

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

  • Временные интервалы между датой абсолютной ссылки и определенными другими датами.

    Объявление

    Swift

    let kCFAbsoluteTimeIntervalSince1970: CFTimeInterval let kCFAbsoluteTimeIntervalSince1904: CFTimeInterval

    Objective C

    const CFTimeInterval kCFAbsoluteTimeIntervalSince1970; const CFTimeInterval kCFAbsoluteTimeIntervalSince1904;

    Константы

    • kCFAbsoluteTimeIntervalSince1970

      Временной интервал между 1 января 1970 и базисная дата 1 января 2001 0:00:00 GMT.

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

    • kCFAbsoluteTimeIntervalSince1904

      Временной интервал между 1 января 1904 и базисная дата 1 января 2001 0:00:00 GMT.

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