Ссылка CFCalendar

Непрозрачный тип CFCalendar представляет систему календаря. Связанный API предоставляет информацию о календаре и поддерживает calendrical вычисления, такие как определение диапазона данного calendrical модуля и добавления модулей к данному абсолютному времени.

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

В календаре день, неделя, рабочий день, месяц и числа года обычно на основе 1, но могут быть специфичные для календаря исключения. Порядковые числа, где они происходят, на основе 1. Некоторым календарям, представленным этим API, вероятно, придется отобразить их понятия основной единицы в год/месяц/неделю/день / … номенклатура. Например, календарь, составленный из 4 четвертей через год вместо 12 месяцев, использует модуль «месяца» для представления четвертей. Определенные значения модуля определяются каждым календарем, и не обязательно “соответствующие с” или имеют “корреспонденцию”, значения для того модуля в другом календаре.

Несколько функций CFCalendar (CFCalendarComposeAbsoluteTime, CFCalendarDecomposeAbsoluteTime, CFCalendarAddComponents, и CFCalendarGetComponentDifference) возьмите строку описания, описывающую calendrical компоненты, предоставленные в varargs области параметра. Можно обеспечить столько компонентов, сколько Вы нуждаетесь (или выбираете к), в любом порядке, который Вы выбираете. Когда существует неполная информация для вычислений абсолютного времени, значения по умолчанию, подобные 0 и 1, обычно выбираются календарем, но это - специфичный для календаря выбор. Если Вы предоставляете противоречивую информацию, специфичное для календаря разрешение неоднозначности выполняется (который может включить игнорирование того или большего количества параметров). Символы строки описания указывают модули и порядок следующих параметров. Символы приняты от соответствующих символов формата, используемых CFDateFormatter, если это возможно, как показано в Таблице 1.

Информацией, связанной с форматированием дат и времени и связанной с именем информации календаря, управляет CFDateFormatter.

CFCalendar подвергается некоторым ограничениям. Нет никакого прыжка второй обработки — существование секунд прыжка проигнорировано как в другом CoreFoundation API. В целом историческая точность календарей не гарантируется. В настоящее время нет никакого API для определения Ваших собственных календарей.

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