Ссылка утилит времени
Наследование
Не применимый
Соответствует
Не применимый
Оператор импорта
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) -> CFAbsoluteTimeObjective 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!) -> Int32Objective 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!) -> Int32Objective 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.
-
CFAbsoluteTimeGetDifferenceAsGregorianUnits (_: _: _: _:) CFAbsoluteTimeGetDifferenceAsGregorianUnits
(iOS 8.0)Вычисляет разницу во времени между двумя указанными абсолютными разами и возвращает результат как интервал в Грегорианских модулях.
Объявление
Swift
func CFAbsoluteTimeGetDifferenceAsGregorianUnits(_
at1
: CFAbsoluteTime, _at2
: CFAbsoluteTime, _tz
: CFTimeZone!, _unitFlags
: CFOptionFlags) -> CFGregorianUnitsObjective 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!) -> CFGregorianDateObjective 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!) -> Int32Objective 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!) -> CFAbsoluteTimeObjective 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) -> BooleanObjective 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, monthmonth
: Int8, dayday
: Int8, hourhour
: Int8, minuteminute
: Int8, secondsecond
: 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, monthsmonths
: Int32, daysdays
: Int32, hourshours
: Int32, minutesminutes
: Int32, secondsseconds
: 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.
-
Введите используемый для представления прошедшего времени в секундах.
Оператор импорта
Objective C
@import CoreFoundation;
Swift
import CoreFoundation
Доступность
Доступный в iOS 2.0 и позже.
-
Эти флаги опции используются в качестве маски для указания определенного набора полей в структурах CFGregorianDate или CFGregorianUnits.
Объявление
Swift
struct CFGregorianUnitFlags : RawOptionSetType { init(_
rawValue
: CFOptionFlags) init(rawValuerawValue
: 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;
Константы