NSDateFormatter

Экземпляры NSDateFormatter создайте строковые представления NSDate объекты, и преобразовывают текстовые представления дат и времени в NSDate объекты. Можно выразить представление дат и времени гибко с помощью предварительно установленных стилей форматирования или пользовательских строк формата.

Потокобезопасность

На iOS 7 и позже NSDateFormatter ориентировано на многопотоковое исполнение.

На OS X v10.9 и позже NSDateFormatter ориентировано на многопотоковое исполнение, пока Вы используете современное поведение в 64-разрядном приложении.

На более ранних версиях операционной системы, или при использовании устаревшего поведения средства форматирования или работающий в 32-разрядном на OS X, NSDateFormatter не ориентировано на многопотоковое исполнение, и Вы поэтому не должны видоизменять средство форматирования даты одновременно от многократных потоков.

Форматы даты для видимых пользователем строк должны быть сконфигурированы с помощью стилей, сконфигурированных пользователем — использование dateStyle, timeStyle, и надлежащие константы стиля (определенный в NSDateFormatterStyle) выбрать между ними.

      NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
dateFormatter.timeStyle = NSDateFormatterNoStyle;
dateFormatter.dateStyle:NSDateFormatterMediumStyle;
 
NSDate *date = [NSDate dateWithTimeIntervalSinceReferenceDate:118800];
 
NSLocale *usLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US"];
[dateFormatter setLocale:usLocale];
 
NSLog(@"Date for locale %@: %@",
      [[dateFormatter locale] localeIdentifier], [dateFormatter stringFromDate:date]);
// Output:
// Date for locale en_US: Jan 2, 2001
 
NSLocale *frLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"fr_FR"];
[dateFormatter setLocale:frLocale];
NSLog(@"Date for locale %@: %@",
      [[dateFormatter locale] localeIdentifier], [dateFormatter stringFromDate:date]);
// Output:
// Date for locale fr_FR: 2 janv. 2001


  

Если по некоторым причинам необходимо определить формат, не указанный пользователем на системном уровне, можно установить отдельные атрибуты, такие как локаль, часовой пояс, календарь, строка формата и различные текстовые строки как имена месяца.

Обратите внимание на то, что, несмотря на то, что устанавливая строку формата (dateFormat) в принципе указывает точный формат, на практике он может, тем не менее, также быть переопределен предпочтениями пользователя — дополнительную информацию см. в Руководстве по Форматированию данных.

Способы поведения средства форматирования и версии ОС

OS X v10.4 представил современное поведение для NSDateFormatter. Посмотрите Руководство по Форматированию данных для полного описания старых и новых способов поведения.

В OS X v10.5 и позже, NSDateFormatter значения по умолчанию к современному поведению. Если необходимо, можно установить использование поведения класса по умолчанию setDefaultFormatterBehavior:, или можно установить поведение для использования экземпляра formatterBehavior.

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

NSObject
NSFormatter
NSDateFormatter

NSObject
NSFormatter
NSDateFormatter

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

AnyObject
CVarArgType
Сопоставимый
Hashable
NSCoding
NSCopying
NSObjectProtocol
Печатаемый
NSCoding
NSCopying
NSObject

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Инициализация средства форматирования даты


    
    initWithDateFormat:allowNaturalLanguage:
    - initWithDateFormat:allowNaturalLanguage:

(OS X v10.9)

Инициализирует и возвращается NSDateFormatter экземпляр, использующий OS X v10.0 форматирование поведения и данной строки формата даты в ее преобразованиях.

Объявление

Objective C

- (id)initWithDateFormat:(NSString *)format allowNaturalLanguage:(BOOL)flag

Параметры

`format`	Формат для получателя. Посмотрите Руководство по Форматированию данных для списка спецификаторов преобразования, разрешенных в строках формата даты.
`flag`	Флаг, указывающий, должен ли получатель обработать даты, вводимые как выражения в жаргон (например, «завтра») —`YEStrue` средние значения, что это должно.

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

Инициализированный NSDateFormatter использующий экземпляр format в его преобразованиях и это использует OS X v10.0 форматирование поведения.

Обсуждение

NSDateFormatter обработка естественного языка попыток только после того, как этому не удается интерпретировать вводимую строку согласно format. Обработка естественного языка поддерживает только ограниченный набор разговорных фраз, прежде всего на английском языке. Это может дать неожиданные результаты, и его использованию строго обескураживают.

Следующий пример создает средство форматирования даты со строкой формата (например), «15 марта 1994» и затем связывает средство форматирования с ячейками формы (contactsForm):

      NSDateFormatter *dateFormat = [[NSDateFormatter alloc]
    initWithDateFormat:@"%b %d %Y" allowNaturalLanguage:NO];
[[contactsForm cells] makeObjectsPerformSelector:@selector(setFormatter:)
     withObject:dateFormat];

Специальные замечания

Вы не можете использовать этот метод для инициализации средства форматирования с OS X v10.4 форматирование поведения, необходимо использовать init.

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

Objective C

@import Foundation;

Доступность

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

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

См. также

doesRelativeDateFormatting

Преобразование объектов

dateFromString (_:) - dateFromString:

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

Объявление

Swift

func dateFromString(_ string: String) -> NSDate?

Objective C

- (NSDate *)dateFromString:(NSString *)string

Параметры

string

Строка для парсинга.

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

Представление даты string интерпретируемое использование текущих настроек получателя. Если dateFromString: не может проанализировать строку, возвраты nil.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– getObjectValue:forString:range:error:
– stringFromDate:
stringFromDate (_:) - stringFromDate:

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

Объявление

Swift

func stringFromDate(_ date: NSDate) -> String

Objective C

- (NSString *)stringFromDate:(NSDate *)date

Параметры

date

Дата для форматирования.

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

Строковое представление date отформатированное использование текущих настроек получателя.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– dateFromString:
+ localizedStringFromDate:dateStyle:timeStyle:


    
    localizedStringFromDate (_: dateStyle:timeStyle:)
    + localizedStringFromDate:dateStyle:timeStyle:

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

Объявление

Swift

class func localizedStringFromDate(_ date: NSDate, dateStyle dateStyle: NSDateFormatterStyle, timeStyle timeStyle: NSDateFormatterStyle) -> String

Objective C

+ (NSString *)localizedStringFromDate:(NSDate *)date dateStyle:(NSDateFormatterStyle)dateStyle timeStyle:(NSDateFormatterStyle)timeStyle

Параметры

`date`	Дата.
`dateStyle`	Стиль форматирования для даты. Для возможных значений посмотрите `NSDateFormatterStyle`.
`timeStyle`	Стиль форматирования в течение времени. Для возможных значений посмотрите `NSDateFormatterStyle`.

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

Представление локализованной строки date использование указанных стилей даты и времени

Обсуждение

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

      NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
formatter.formatterBehavior = NSDateFormatterBehavior10_4;
[formatter.dateStyle = dateStyle;
[formatter.timeStyle = timeStyle;
NSString *result = [formatter stringForObjectValue:date];


  

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– stringFromDate:


    
    getObjectValue (_: forString:range:error:)
    - getObjectValue:forString:range:error:

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

Объявление

Swift

func getObjectValue(_ obj: AutoreleasingUnsafeMutablePointer<AnyObject?>, forString string: String, range rangep: UnsafeMutablePointer<NSRange>, error error: NSErrorPointer) -> Bool

Objective C

- (BOOL)getObjectValue:(out id *)obj forString:(NSString *)string range:(inout NSRange *)rangep error:(out NSError **)error

Параметры

`obj`	Если получатель в состоянии проанализировать `string`, по возврату содержит представление даты `string`.
`string`	Строка для парсинга.
`rangep`	Если получатель в состоянии проанализировать `string`, по возврату содержит диапазон `string` используемый для создания даты.
`error`	Если получатель неспособен создать дату путем парсинга `string`, по возврату содержит объект NSError, описывающий проблему.

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

YEStrue если получатель может создать дату путем парсинга string, иначе NOfalse.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– dateFromString:
stringForObjectValue:

generatesCalendarDates generatesCalendarDates Свойство

Вы не должны использовать это свойство.

Объявление

Swift

var generatesCalendarDates: Bool

Objective C

@property BOOL generatesCalendarDates

Обсуждение

YEStrue если получатель генерирует календарные даты, иначе NOfalse.

NSCalendarDate больше не поддерживается; Вы не должны использовать этот метод.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Управление форматами и стилями

dateFormat dateFormat Свойство

Строка формата даты используется получателем.

Объявление

Swift

var dateFormat: String!

Objective C

@property(copy) NSString *dateFormat

Обсуждение

Посмотрите Руководство по Форматированию данных для списка спецификаторов преобразования, разрешенных в строках формата даты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Стиль даты получателя.

Объявление

Swift

var dateStyle: NSDateFormatterStyle

Objective C

@property NSDateFormatterStyle dateStyle

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Стиль времени получателя.

Объявление

Swift

var timeStyle: NSDateFormatterStyle

Objective C

@property NSDateFormatterStyle timeStyle

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    dateFormatFromTemplate (_: options:locale:)
    + dateFormatFromTemplate:options:locale:

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

Объявление

Swift

class func dateFormatFromTemplate(_ template: String, options opts: Int, locale locale: NSLocale?) -> String?

Objective C

+ (NSString *)dateFormatFromTemplate:(NSString *)template options:(NSUInteger)opts locale:(NSLocale *)locale

Параметры

`template`	Строка, содержащая образцы формата даты (такие как «MM» или «h»). Для полного изложения см. Руководство по программированию Даты и времени.
`opts`	Никакие опции в настоящее время не определяются — передача `0`.
`locale`	Локаль, для которой требуется шаблон.

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

Локализованная строка формата даты, представляющая поданные компоненты формата даты template, расположенный соответственно для локали, указанной locale.

Возвращаемая строка может не содержать точно те поданные компоненты template, но может — например —, применили специфичные для локали корректировки.

Обсуждение

Различные локали имеют различные соглашения для упорядочивания компонентов даты. Вы используете этот метод для получения надлежащей строки формата для данного набора компонентов для указанной локали (обычно, Вы используете текущую локаль — посмотрите currentLocale).

Следующий пример показывает различие между форматами даты для британского варианта английского языка и американского варианта английского языка:

      NSLocale *usLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_US"];
NSLocale *gbLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"en_GB"];
 
NSString *dateFormat;
NSString *dateComponents = @"yMMMMd";
 
dateFormat = [NSDateFormatter dateFormatFromTemplate:dateComponents options:0 locale:usLocale];
NSLog(@"Date format for %@: %@",
    [usLocale displayNameForKey:NSLocaleIdentifier value:[usLocale localeIdentifier]], dateFormat);
 
dateFormat = [NSDateFormatter dateFormatFromTemplate:dateComponents options:0 locale:gbLocale];
NSLog(@"Date format for %@: %@",
    [gbLocale displayNameForKey:NSLocaleIdentifier value:[gbLocale localeIdentifier]], dateFormat);
 
// Output:
// Date format for English (United States): MMMM d, y
// Date format for English (United Kingdom): d MMMM y


  

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Управление атрибутами

календарь календарь Свойство

Календарь для получателя.

Объявление

Swift

@NSCopying var calendar: NSCalendar!

Objective C

@property(copy) NSCalendar *calendar

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Дата по умолчанию получателя.

Объявление

Swift

@NSCopying var defaultDate: NSDate?

Objective C

@property(copy) NSDate *defaultDate

Обсуждение

Дата по умолчанию по умолчанию nil.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
локаль локаль Свойство

Локаль для получателя.

Объявление

Swift

@NSCopying var locale: NSLocale?

Objective C

@property(copy) NSLocale *locale

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Часовой пояс для получателя.

Объявление

Swift

@NSCopying var timeZone: NSTimeZone!

Objective C

@property(copy) NSTimeZone *timeZone

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Самая ранняя дата, которая может быть обозначена двухразрядным спецификатором года.

Объявление

Swift

@NSCopying var twoDigitStartDate: NSDate!

Objective C

@property(copy) NSDate *twoDigitStartDate

Обсуждение

Если двухразрядная дата начала установлена до 6 января 1976, то “1 января, 76” интерпретируется как Новый год в 2076, тогда как “14 февраля, 76” интерпретируется как День святого Валентина в 1976.

Дата по умолчанию 31 декабря 1949.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Дата начала Григорианского календаря для получателя.

Объявление

Swift

@NSCopying var gregorianStartDate: NSDate!

Objective C

@property(copy) NSDate *gregorianStartDate

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Управление версией поведения

formatterBehavior formatterBehavior Свойство

Поведение средства форматирования для получателя.

Объявление

Swift

var formatterBehavior: NSDateFormatterBehavior

Objective C

@property NSDateFormatterBehavior formatterBehavior

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

+ defaultFormatterBehavior.
defaultFormatterBehavior () + defaultFormatterBehavior

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

Объявление

Swift

class func defaultFormatterBehavior() -> NSDateFormatterBehavior

Objective C

+ (NSDateFormatterBehavior)defaultFormatterBehavior

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

Поведение форматирования значения по умолчанию для экземпляров класса. Для возможных значений посмотрите NSDateFormatterBehavior.

Обсуждение

Для iOS и для приложений OS X, соединенных против OS X v10.5 и позже, значение по умолчанию NSDateFormatterBehavior10_4.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

+ setDefaultFormatterBehavior:.
– formatterBehavior


    
    setDefaultFormatterBehavior (_:)
    + setDefaultFormatterBehavior:

Устанавливает поведение форматирования значения по умолчанию для экземпляров класса.

Объявление

Swift

class func setDefaultFormatterBehavior(_ behavior: NSDateFormatterBehavior)

Objective C

+ (void)setDefaultFormatterBehavior:(NSDateFormatterBehavior)behavior

Параметры


      behavior

Поведение форматирования значения по умолчанию для экземпляров класса. Для возможных значений посмотрите NSDateFormatterBehavior.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

+ defaultFormatterBehavior
– formatterBehavior

Управление поддержкой естественного языка

allowsNaturalLanguage - allowsNaturalLanguage (OS X v10.9)

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

Объявление

Objective C

- (BOOL)allowsNaturalLanguage

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

YEStrue если получатель пытается обработать даты, вводимые как народная строка («сегодня», “на следующей неделе”, «обеденное время», и т.д.), иначе NOfalse.

Обсуждение

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

Специальные замечания

Этот метод для использования с использованием средств форматирования NSDateFormatterBehavior10_0 поведение.

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

Objective C

@import Foundation;

Доступность

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

См. также

doesRelativeDateFormatting
снисходительный снисходительный Свойство

Булево значение, указывающее, использует ли получатель эвристику при парсинге строки.

Объявление

Swift

var lenient: Bool

Objective C

@property(getter=isLenient) BOOL lenient

Обсуждение

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

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.10 и позже.
doesRelativeDateFormatting doesRelativeDateFormatting Свойство
Булево значение, указывающее, использует ли получатель фразы такой как «сегодня» и «завтра» для компонента даты.

Объявление

Swift

var doesRelativeDateFormatting: Bool

Objective C

@property BOOL doesRelativeDateFormatting
Обсуждение

YEStrue если получатель использует относительное форматирование даты, иначе NOfalse.

Если средство форматирования даты использует относительное форматирование даты, где возможный это заменяет компонент даты своего вывода с фразой — таким как «сегодня» или «завтра» — который указывает относительную дату. Доступные фразы зависят от локали для средства форматирования даты; тогда как для дат в будущем английский язык может только позволить «завтра», французский язык может позволить “на следующий день послезавтра”, как проиллюстрировано в следующем примере.
NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];

dateFormatter.timeStyle = NSDateFormatterNoStyle;

dateFormatter.dateStyle = NSDateFormatterMediumStyle;

NSLocale *frLocale = [[NSLocale alloc] initWithLocaleIdentifier:@"fr_FR"];

dateFormatter.locale = frLocale;

dateFormatter.doesRelativeDateFormatting = YES;

NSDate *date = [NSDate dateWithTimeIntervalSinceNow:60*60*24*3];

NSString *dateString = [dateFormatter stringFromDate:date];

NSLog(@"dateString: %@", dateString);

// Output

// dateString: après-après-demain
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Управление AM и символами PM

AMSymbol AMSymbol Свойство

Символ AM для получателя.

Объявление

Swift

var AMSymbol: String!

Objective C

@property(copy) NSString *AMSymbol

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– PMSymbol
PMSymbol PMSymbol Свойство

Символ Премьер-министра для получателя.

Объявление

Swift

var PMSymbol: String!

Objective C

@property(copy) NSString *PMSymbol

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

См. также

– AMSymbol

Управление будними символами

weekdaySymbols weekdaySymbols Свойство

Массив будних символов для получателя.

Объявление

Swift

var weekdaySymbols: [AnyObject]!

Objective C

@property(copy) NSArray *weekdaySymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Массив коротких будних символов для получателя.

Объявление

Swift

var shortWeekdaySymbols: [AnyObject]!

Objective C

@property(copy) NSArray *shortWeekdaySymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Массив очень коротких будних символов для получателя.

Объявление

Swift

var veryShortWeekdaySymbols: [AnyObject]!

Objective C

@property(copy) NSArray *veryShortWeekdaySymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Массив автономных будних символов для получателя.

Объявление

Swift

var standaloneWeekdaySymbols: [AnyObject]!

Objective C

@property(copy) NSArray *standaloneWeekdaySymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Массив коротких автономных будних символов для получателя.

Объявление

Swift

var shortStandaloneWeekdaySymbols: [AnyObject]!

Objective C

@property(copy) NSArray *shortStandaloneWeekdaySymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Массив очень коротких автономных будних символов для получателя.

Объявление

Swift

var veryShortStandaloneWeekdaySymbols: [AnyObject]!

Objective C

@property(copy) NSArray *veryShortStandaloneWeekdaySymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Управление символами месяца

monthSymbols monthSymbols Свойство

Символы месяца для получателя.

Объявление

Swift

var monthSymbols: [AnyObject]!

Objective C

@property(copy) NSArray *monthSymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Массив коротких символов месяца для получателя.

Объявление

Swift

var shortMonthSymbols: [AnyObject]!

Objective C

@property(copy) NSArray *shortMonthSymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Очень короткие символы месяца для получателя.

Объявление

Swift

var veryShortMonthSymbols: [AnyObject]!

Objective C

@property(copy) NSArray *veryShortMonthSymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Автономные символы месяца для получателя.

Объявление

Swift

var standaloneMonthSymbols: [AnyObject]!

Objective C

@property(copy) NSArray *standaloneMonthSymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Короткие автономные символы месяца для получателя.

Объявление

Swift

var shortStandaloneMonthSymbols: [AnyObject]!

Objective C

@property(copy) NSArray *shortStandaloneMonthSymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Очень короткие символы месяца для получателя.

Объявление

Swift

var veryShortStandaloneMonthSymbols: [AnyObject]!

Objective C

@property(copy) NSArray *veryShortStandaloneMonthSymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Управление символами четверти

quarterSymbols quarterSymbols Свойство

Символы четверти для получателя.

Объявление

Swift

var quarterSymbols: [AnyObject]!

Objective C

@property(copy) NSArray *quarterSymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Короткие символы четверти для получателя.

Объявление

Swift

var shortQuarterSymbols: [AnyObject]!

Objective C

@property(copy) NSArray *shortQuarterSymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Автономные символы четверти для получателя.

Объявление

Swift

var standaloneQuarterSymbols: [AnyObject]!

Objective C

@property(copy) NSArray *standaloneQuarterSymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

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

Объявление

Swift

var shortStandaloneQuarterSymbols: [AnyObject]!

Objective C

@property(copy) NSArray *shortStandaloneQuarterSymbols

Обсуждение

Символы NSString объекты.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Управление символами эры

eraSymbols eraSymbols Свойство

Символы эры для получателя.

Объявление

Swift

var eraSymbols: [AnyObject]!

Objective C

@property(copy) NSArray *eraSymbols

Обсуждение

Массив, содержащий NSString объекты, представляющие символы эры для получателя (например, {«B.C.E». «C.E».}).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Длинные символы эры для получателя

Объявление

Swift

var longEraSymbols: [AnyObject]!

Objective C

@property(copy) NSArray *longEraSymbols

Обсуждение

Массив, содержащий NSString объекты, представляющие символы эры для получателя (например, {“Перед Нашей эрой”, «Нашей эрой»}).

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Типы данных

NSDateFormatterStyle NSDateFormatterStyle
Следующие константы указывают стили предопределенного формата для дат и времени.

Объявление

Swift

enum NSDateFormatterStyle : UInt { case NoStyle case ShortStyle case MediumStyle case LongStyle case FullStyle }

Objective C

typedef enum { NSDateFormatterNoStyle = kCFDateFormatterNoStyle, NSDateFormatterShortStyle = kCFDateFormatterShortStyle, NSDateFormatterMediumStyle = kCFDateFormatterMediumStyle, NSDateFormatterLongStyle = kCFDateFormatterLongStyle, NSDateFormatterFullStyle = kCFDateFormatterFullStyle } NSDateFormatterStyle;

Константы
- NoStyle
  
  NSDateFormatterNoStyle
  
  Не указывает стиля.
  
  Равный kCFDateFormatterNoStyle.
  
  Доступный в OS X v10.4 и позже.
- ShortStyle
  
  NSDateFormatterShortStyle
  
  Указывает короткий стиль, обычно числовой только, такой как «11/23/37» или «15:30».
  
  Равный kCFDateFormatterShortStyle.
  
  Доступный в OS X v10.4 и позже.
- MediumStyle
  
  NSDateFormatterMediumStyle
  
  Указывает средний стиль, обычно с сокращенным текстом, такой как «23 ноября 1937» или «15:30:32».
  
  Равный kCFDateFormatterMediumStyle.
  
  Доступный в OS X v10.4 и позже.
- LongStyle
  
  NSDateFormatterLongStyle
  
  Указывает длинный стиль, обычно с полным текстом, такой как «23 ноября 1937» или «15:30:32 PST».
  
  Равный kCFDateFormatterLongStyle.
  
  Доступный в OS X v10.4 и позже.
- FullStyle
  
  NSDateFormatterFullStyle
  
  Указывает полный стиль с полными подробными данными, такой как “вторник, 12 апреля 1952 AD” или “Тихоокеанское время 15:30:42”.
  
  Равный kCFDateFormatterFullStyle.
  
  Доступный в OS X v10.4 и позже.
Обсуждение

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

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.4 и позже.
NSDateFormatterBehavior NSDateFormatterBehavior
Константы, указывающие поведение NSDateFormatter должен показать.

Объявление

Swift

enum NSDateFormatterBehavior : UInt { case BehaviorDefault case Behavior10_0 case Behavior10_4 }

Objective C

typedef enum { NSDateFormatterBehaviorDefault = 0, NSDateFormatterBehavior10_0 = 1000, NSDateFormatterBehavior10_4 = 1040, } NSDateFormatterBehavior;

Константы
- BehaviorDefault
  
  NSDateFormatterBehaviorDefault
  
  Указывает поведение форматирования значения по умолчанию.
  
  Доступный в OS X v10.4 и позже.
- Behavior10_0
  
  NSDateFormatterBehavior10_0
  
  Указывает поведение форматирования, эквивалентное этому в OS X v10.0.
  
  Доступный в OS X v10.4 и позже.
- Behavior10_4
  
  NSDateFormatterBehavior10_4
  
  Указывает поведение форматирования, эквивалентное для OS X v10.4.
  
  Доступный в OS X v10.4 и позже.
Оператор импорта

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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