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

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

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

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

Функции

Базовые разные функции утилит времени основы


    
    CFAbsoluteTimeAddGregorianUnits (_: _: _:)
    CFAbsoluteTimeAddGregorianUnits

(OS X v10.10)

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

Объявление

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

Доступность

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

Осуждаемый в OS X v10.10.

CFAbsoluteTimeGetCurrent () CFAbsoluteTimeGetCurrent

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

Объявление

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

Доступность

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


    
    CFAbsoluteTimeGetDayOfWeek (_: _:)
    CFAbsoluteTimeGetDayOfWeek

(OS X v10.10)

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

Объявление

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

Доступность

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

Осуждаемый в OS X v10.10.


    
    CFAbsoluteTimeGetDayOfYear (_: _:)
    CFAbsoluteTimeGetDayOfYear

(OS X v10.10)

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

Объявление

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

Доступность

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

Осуждаемый в OS X v10.10.


    
    CFAbsoluteTimeGetDifferenceAsGregorianUnits (_: _: _: _:)
    CFAbsoluteTimeGetDifferenceAsGregorianUnits

(OS X v10.10)

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

Объявление

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

Доступность

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

Осуждаемый в OS X v10.10.


    
    CFAbsoluteTimeGetGregorianDate (_: _:)
    CFAbsoluteTimeGetGregorianDate

(OS X v10.10)

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

Объявление

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

Доступность

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

Осуждаемый в OS X v10.10.


    
    CFAbsoluteTimeGetWeekOfYear (_: _:)
    CFAbsoluteTimeGetWeekOfYear

(OS X v10.10)

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

Объявление

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

Доступность

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

Осуждаемый в OS X v10.10.


    
    CFGregorianDateGetAbsoluteTime (_: _:)
    CFGregorianDateGetAbsoluteTime

(OS X v10.10)

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

Объявление

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

Доступность

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

Осуждаемый в OS X v10.10.


    
    CFGregorianDateIsValid (_: _:)
    CFGregorianDateIsValid

(OS X v10.10)

Проверяет указанные поля структуры 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

Доступность

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

Осуждаемый в OS X v10.10.

Типы данных

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

CFAbsoluteTime CFAbsoluteTime

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

Объявление

Swift

typealias CFAbsoluteTime = CFTimeInterval

Objective C

typedef CFTimeInterval CFAbsoluteTime;

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

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

Объявление

Swift

struct CFGregorianDate { var year: Int32 var month: Int8 var day: Int8 var hour: Int8 var minute: Int8 var 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.

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.10.
CFGregorianUnits

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

Объявление

Swift

struct CFGregorianUnits { var years: Int32 var months: Int32 var days: Int32 var hours: Int32 var minutes: Int32 var 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). Каждое поле может принять значения до максимума, возможного для его типа данных. Отрицательные величины также допустимы.

Доступность

Доступный в OS X v10.4 и позже.
Осуждаемый в OS X v10.10.
CFTimeInterval CFTimeInterval

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

Объявление

Swift

typealias CFTimeInterval = Double

Objective C

typedef double CFTimeInterval;

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Константы

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

CFGregorianUnitFlags
Эти флаги опции используются в качестве маски для указания определенного набора полей в структурах 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
  
  Указывает поле года.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.10.
- UnitsMonths
  
  kCFGregorianUnitsMonths
  
  Указывает поле месяца.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.10.
- UnitsDays
  
  kCFGregorianUnitsDays
  
  Указывает дневное поле.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.10.
- UnitsHours
  
  kCFGregorianUnitsHours
  
  Указывает поле часов.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.10.
- UnitsMinutes
  
  kCFGregorianUnitsMinutes
  
  Указывает мелкое поле.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.10.
- UnitsSeconds
  
  kCFGregorianUnitsSeconds
  
  Указывает поле секунд.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.10.
- AllUnits
  
  kCFGregorianAllUnits
  
  Указывает все поля.
  
  Доступный в OS X v10.4 и позже.
  Осуждаемый в OS X v10.10.
Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

Доступный в OS X v10.0 и позже.
Предопределенные значения временного интервала
Временные интервалы между датой абсолютной ссылки и определенными другими датами.

Объявление

Swift

let kCFAbsoluteTimeIntervalSince1970: CFTimeInterval let kCFAbsoluteTimeIntervalSince1904: CFTimeInterval

Objective C

const CFTimeInterval kCFAbsoluteTimeIntervalSince1970; const CFTimeInterval kCFAbsoluteTimeIntervalSince1904;

Константы
- kCFAbsoluteTimeIntervalSince1970
  
  kCFAbsoluteTimeIntervalSince1970
  
  Временной интервал между 1 января 1970 и базисная дата 1 января 2001 0:00:00 GMT.
  
  Доступный в OS X v10.0 и позже.
- kCFAbsoluteTimeIntervalSince1904
  
  kCFAbsoluteTimeIntervalSince1904
  
  Временной интервал между 1 января 1904 и базисная дата 1 января 2001 0:00:00 GMT.
  
  Доступный в OS X v10.0 и позже.